Входящие вебхуки
Входящие вебхуки — это специальные ссылки, с помощью которых можно создавать и изменять задачи или добавлять контакты в Planfix. Они создаются с использованием определенного типа и параметров.
Пример вебхука:
Когда клиент или другой внешний пользователь нажимает на эту ссылку, в Planfix запускаются заранее заданные действия. Это простой способ связать Planfix с другим веб-сервисом или программой.
Вебхуки можно добавить в Planfix в разделе Управление аккаунтом — Входящие вебхуки.
При нажатии кнопки Новый вебхук можно выбрать один из готовых вариантов настройки или настроить вебхук самостоятельно.
Примеры
Важно
В ответ на входящие вебхуки возвращается только JSON с номером созданной задачи (2), относящейся к основному действию (1):
Составные вебхуки
Если на один адрес приходят разные запросы, можно настроить вебхук для нескольких сценариев обработки. Переключите режим «Один общий сценарий» на «Несколько сценариев обработки», укажите, какие данные определяют сценарий, а также задайте условия и действия для каждого сценария.
Первый подходящий сценарий выполняется сверху вниз. Например, если формы из разных источников на сайте отправляют данные на один вебхук:
{"form": "demo", "name": "Alex Smith", "email": "alex@example.com"}
{"form": "support", "name": "Alex Smith", "problem": "notifications not received"}
Сценарий выбирается по значению поля "form":
- для demo можно создать задачу для менеджера по продажам
- для support — задачу в проекте технической поддержки
== Дополнительно == *Входящие вебхуки в Planfix можно анализировать с помощью JSON. Для этого используется библиотека JsonPath