Входящие вебхуки — различия между версиями

Версия 13:58, 12 февраля 2021

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

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

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

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

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

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

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

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

Перейти

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

@@ Строка 6: / Строка 6: @@
 }}
-'''Входящие вебхуки''' позволяют создавать и изменять задачи в ПланФиксе по ссылке или команде из внешнего источника. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
+'''Входящие вебхуки''' позволяют создавать и изменять задачи или добавлять контакты в ПланФикс по специальной ссылке.
-Добавить вебхуки в ПланФикс можно в разделе '''Управление аккаунтом''' — '''Входящие вебхуки''':
+ <nowiki>https://ваш_аккаунт.planfix.ru/webhook/get/htnh-4w03-vojf-pjpu?name=название задачи&project=проект</nowiki>
+Она формируется из определенных параметров, и когда по ссылке переходит клиент или другой внешний пользователь, в ПланФиксе автоматически запускаются заранее настроенные операции. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
+Вебхуки добавляются в ПланФикс в разделе '''Управление аккаунтом''' — '''Входящие вебхуки''':
 https://p.pfx.so/pf/Jj/h4w1Vq.png
-В разделе отображаются название, метод запроса и ссылка на вебхук. По кнопке '''Новый вебхук''' можно выбрать предустановленные настройки или добавить самостоятельно настроенный вебхук:
+По кнопке '''Новый вебхук''' можно выбрать предустановленные настройки или добавить самостоятельно настроенный вебхук:
 https://p.pfx.so/pf/aW/c7SjWC.png