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

Материал из Planfix

Входящие вебхуки — это специальная ссылка, которая позволяет создавать и изменять задачи или добавлять контакты в ПланФикс. Она формируется из определенного типа и параметров.

Пример вебхука:

https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=проект&name=название задачи


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

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

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

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

Важно

  • Входящие вебхуки возвращают JSON с номером созданной задачи (2) только из основной операции (1):

Zqzn7c.png

Составные вебхуки

Если на один адрес приходят разные запросы, вебхук можно настроить на несколько сценариев обработки.

Переключите режим "Один общий сценарий" на "Несколько сценариев обработки", укажите, по каким данным выбирается сценарий, и задайте для каждого свои условия и операции.

Выполняется первый подходящий сценарий сверху вниз. Например, на сайте на один вебхук приходят заявки из разных форм:

{"form": "demo", "name": "Иван Петров", "email": "ivan@example.com"}
{"form": "support", "name": "Иван Петров", "problem": "не приходят уведомления"}

В итоге сценарий выбирается по значению "form":

  • при demo можно создавать задачу менеджеру по продажам
  • при support — задачу в проекте техподдержки

Дополнительно


Перейти