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

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

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

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

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

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

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

Перейти

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