Входящие вебхуки
Входящие вебхуки позволяют создавать и изменять задачи или добавлять контакты в ПланФикс по специальной ссылке. Она формируется из определенного типа и параметров:
https://ваш_аккаунт.planfix.ru/webhook/get/htnh-4w03-vojf-pjpu?project=проект&name=название задачи
Когда по такой ссылке переходит клиент или другой внешний пользователь, в ПланФиксе автоматически запускаются заранее настроенные операции. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
Вебхуки добавляются в ПланФикс в разделе Управление аккаунтом — Входящие вебхуки:
По кнопке Новый вебхук можно выбрать предустановленные настройки или добавить самостоятельно настроенный вебхук:
Формирование вебхука
Формируется вебхук за 6 шагов. С некоторыми шагами вы могли сталкиваться при настройке автоматических сценариев:
- Шаг 1: выбираем тип запроса — GET или POST.
- Шаг 2: извлекаем данные из вебхука — называем инфоблоки, входящие параметры и какие значения сохранить:
- Шаг 3: Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука:
- Шаг 4: Выбираем тип операции — создать или изменить задачу, создать контакт:
- Шаг 5: Добавляем дополнительные операции при необходимости:
- Шаг 6: Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта:
Пример использования
Настроим автоматическое создание контактов в ПланФиксе из формы обратной связи на сайте. Для этого:
- Формируем ссылку вебхука. Для отправки формы нужен вебхук с POST-запросом:
https://planfix.ru/webhook/POST/fd12-4545-fzdf-df75
- Добавляем вебхук в код формы обратной связи:
<form method="post" action="https://planfix.ru/webhook/POST/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>
Теперь каждый раз, когда клиенты будут заполнять форму обратной связи на сайте, в ПланФиксе будет автоматически создаваться контакт.