Вхідні вебхуки

Матеріал з Planfix

Вхідні вебхуки — це спеціальне посилання, яке дозволяє створювати та змінювати задачі або додавати контакти в Planfix. Воно формується з певного типу та параметрів.

Приклад вебхука:

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


Коли за таким посиланням переходить клієнт або інший зовнішній користувач, у Planfix автоматично запускаються заздалегідь налаштовані операції. Це простий спосіб зв'язати Planfix з іншим веб‑сервісом або власною програмою.

Вебхуки додаються в Planfix у розділі Керування акаунтом — Вхідні вебхуки.

За кнопкою "Новий вебхук" можна вибрати один із передналаштованих варіантів налаштування або додати власний вебхук.

Приклади використання

Важливо

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

Zqzn7c.png

Складні вебхуки

Якщо на одну адресу надходять різні запити, вебхук можна налаштувати на кілька сценаріїв обробки.

Перемкніть режим "Один загальний сценарій" на "Кілька сценаріїв обробки", вкажіть, за якими даними обирається сценарій, і задайте для кожного свої умови та операції.

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

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

У підсумку сценарій обирається за значенням "form":

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

Додатково


Перейти