Входящие вебхуки

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

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

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

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

Формируется вебхук за 6 шагов. С некоторыми шагами вы могли сталкиваться при настройке автоматических сценариев:

Шаг 1: выбираем тип запроса — GET или POST.
Шаг 2: извлекаем данные — называем инфоблоки, входящие параметры и какие значения сохранить.

Шаг 3: Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука.

Шаг 4: Выбираем тип операции — создать или изменить задачу, создать контакт.

Шаг 5: Добавляем дополнительные операции при необходимости.

Шаг 6: Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта.

Пример использования

Например, на сайте есть форма обратной связи. Она содержит поля: Имя и Телефон. Вы хотите, чтобы каждый раз, когда клиент заполнял форму на сайте, в ПланФиксе создавался новый контакт. Для этого:

Формируем ссылку вебхука, как показано ранее:

https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75

Добавляем вебхук в код формы обратной связи:

<form <span style="red">method="post" action="https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75"</span>>
   <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>

Перейти

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