Входящие вебхуки
Входящие вебхуки позволяют создавать и изменять задачи в ПланФиксе по ссылке или команде из внешнего источника. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
Добавить вебхуки в ПланФикс можно в разделе Управление аккаунтом — Входящие вебхуки:
В разделе отображаются название, метод запроса и url вебхуков. По кнопке Новый вебхук можно выбрать предустановленные настройки или добавить самостоятельно настроенный вебхук:
Формирование вебхука
Формируется вебхук за 6 шагов. С некоторыми шагами вы могли сталкиваться при настройке автоматических сценариев:
- Шаг 1: выбираем тип запроса — GET или POST.
- Шаг 2: извлекаем данные — называем инфоблоки, входящие параметры и какие значения сохранить.
- Шаг 3: Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука.
- Шаг 4: Выбираем тип операции — создать или изменить задачу, создать контакт.
- Шаг 5: Добавляем дополнительные операции при необходимости.
- Шаг 6: Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта.
Пример использования
Например, на сайте есть форма обратной связи. Она содержит поля: Имя и Телефон. Вы хотите, чтобы каждый раз, когда клиент заполнял форму на сайте, в ПланФиксе создавался новый контакт. Для этого:
- Формируем ссылку вебхука, как показано ранее:
https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75
- Добавляем вебхук в код формы обратной связи:
<form method="post" action="https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75"> <p><input type="text" name="name" placeholder="Имя"></p> <p><input type="text" name="phone" placeholder="Телефон"></p> <p><input type="submit" name="submit" value="Отправить"></p> </form>