Входящие вебхуки — различия между версиями

Версия 13:19, 12 февраля 2021

Входящие вебхуки позволяют создавать и изменять задачи в ПланФиксе по ссылке или команде из внешнего источника. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.

Добавить вебхуки в ПланФикс можно в разделе Управление аккаунтом — Входящие вебхуки:

В разделе отображаются название, метод запроса и ссылка на вебхук. По кнопке Новый вебхук можно выбрать предустановленные настройки или добавить самостоятельно настроенный вебхук:

Формирование вебхука

Формируется вебхук за 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>

Теперь каждый раз, когда клиенты будут заполнять форму обратной связи на сайте, в ПланФиксе будет автоматически создаваться контакт.

Перейти

• Описание возможностей