Входящие вебхуки: различия между версиями
Artem (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
| Строка 89: | Строка 89: | ||
*Для отправки формы нужен вебхук с POST-запросом: | *Для отправки формы нужен вебхук с POST-запросом: | ||
<nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/<span style="color:green;">POST</span>/create_contact | <nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/<span style="color:green;">POST</span>/create_contact | ||
https://p.pfx.so/pf/ij/ZkZUWp.png | https://p.pfx.so/pf/ij/ZkZUWp.png | ||
| Строка 97: | Строка 97: | ||
<div style="width:100%; margin: 0 0 10px; font-size: 13px; line-height: 1.65; word-break: break-all; color: black; background-color: #f9f9f9; border: 1px solid #ddd; padding: 1em 1em 0px 1em; font-family:monospace,Courier; border-radius: 4px;"> | <div style="width:100%; margin: 0 0 10px; font-size: 13px; line-height: 1.65; word-break: break-all; color: black; background-color: #f9f9f9; border: 1px solid #ddd; padding: 1em 1em 0px 1em; font-family:monospace,Courier; border-radius: 4px;"> | ||
<form method="post" action="<nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/POST/create_contact | <form method="post" action="<nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/POST/create_contact"><br> | ||
<input type="text" name="<span style="color:green;">name</span>" placeholder="<span style="color:red;">Имя</span>"><br> | <input type="text" name="<span style="color:green;">name</span>" placeholder="<span style="color:red;">Имя</span>"><br> | ||
<input type="text" name="<span style="color:green;">phone</span>" placeholder="<span style="color:red;">Телефон</span>"><br> | <input type="text" name="<span style="color:green;">phone</span>" placeholder="<span style="color:red;">Телефон</span>"><br> | ||
| Строка 105: | Строка 105: | ||
Когда клиенты заполнят в форме обратной связи <span style="color:red;">Имя</span> и <span style="color:red;">Телефон</span>, а затем кликнут на кнопку '''Отправить''' значения из полей формы | Когда клиенты заполнят в форме обратной связи <span style="color:red;">Имя</span> и <span style="color:red;">Телефон</span>, а затем кликнут на кнопку '''Отправить''', значения из полей формы добавятся в вебхук и отправятся в ПланФикс, где автоматически создастся новый контакт. | ||
== Перейти == | == Перейти == | ||
*[[Описание возможностей]] | *[[Описание возможностей]] | ||
Версия от 11:35, 15 февраля 2021
Входящие вебхуки — это специальная ссылка, которая позволяет создавать и изменять задачи или добавлять контакты в ПланФикс. Она формируется из определенного типа и параметров.
Пример вебхука:
https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=проект&name=название задачи
Когда по такой ссылке переходит клиент или другой внешний пользователь, в ПланФиксе автоматически запускаются заранее настроенные операции. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
Вебхуки добавляются в ПланФикс в разделе Управление аккаунтом — Входящие вебхуки:
По кнопке Новый вебхук можно выбрать один из предустановленных вариантов настройки или добавить самостоятельно настроенный вебхук:
Формирование вебхука с GET-запросом
Для того, чтобы понять как работают вебхуки, сформируем ссылку, которая будет создавать новые задачи в ПланФиксе:
- На первом шаге выберите тип запроса, который будет использоваться в ссылке — GET или POST. Для примера GET-запрос:
- Вебхук можно уникализировать, добавив свои значения в специальное поле:
- На следующем шаге добавляем к вебхуку параметры. В них будут хранится значения, которые пользователь передает в ПланФикс. В примере мы передаём название проекта и название задачи:
- Указываем от чьего имени будет выполнятся действие в ПланФиксе после того, как сработает вебхук:
- Выбираем тип операции и настраиваем его. В итоге ПланФикс должен создать задачу по выбранному шаблону, добавить название проекта из параметра ссылки project и название задачи из параметра ссылки name, затем к задаче добавить указанного исполнителя:
- Далее добавляем дополнительные операции при необходимости:
- И на последнем шаге указываем, какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или личного сайта:
Теперь, используя этот вебхук, можно быстро создавать новые задачи в нужном проекте прямо в адресной строке браузера:
- Копируем ссылку созданного вебхука и добавляем в адресную строку браузера:
https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=укажите&name=укажите
- Затем указываем нужные значения и переходим по ссылке:
https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=SEO&name=Анализ конкурентов
- В итоге в ПланФиксе появилась новая задача:
Важно
Добавление значений в параметры ссылки вебхука можно и нужно автоматизировать, применяя различные переменные.
Использование вебхука с POST-запросом
Автоматизацию заполнения значений параметров ссылки вебхука рассмотрим на примере формы обратной связи на сайте. Для этого в ПланФиксе настроим вебхук, который будет создавать контакты:
- Для отправки формы нужен вебхук с POST-запросом:
https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact
- Добавляем вебхук в код формы обратной связи на сайте:
<form method="post" action="https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact">
<input type="text" name="name" placeholder="Имя">
<input type="text" name="phone" placeholder="Телефон">
<input type="submit" name="submit" value="Отправить">
</form>
Когда клиенты заполнят в форме обратной связи Имя и Телефон, а затем кликнут на кнопку Отправить, значения из полей формы добавятся в вебхук и отправятся в ПланФикс, где автоматически создастся новый контакт.