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

Текущая версия от 12:39, 16 июля 2024

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

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

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

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

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

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

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

Дополнительная информация

Важно

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

@@ Строка 2: / Строка 2: @@
 |title=Входящие вебхуки в ПланФиксе
 |titlemode=append
-|keywords=планфикс, автоматизация, интеграция, входящие вебхуки, webhook
+|keywords=планфикс, автоматизация, интеграция, входящие вебхуки, webhook, вебхук
 |description=Входящие вебхуки в ПланФиксе
 }}
-'''Входящие вебхуки''' позволяют создавать и изменять задачи в ПланФиксе по ссылке или команде из внешнего источника. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
+'''Входящие вебхуки''' — это специальная ссылка, которая позволяет создавать и изменять задачи или добавлять контакты в ПланФикс. Она формируется из определенного типа и параметров.
-Добавить вебхуки в ПланФикс можно в разделе '''Управление аккаунтом''' — '''Входящие вебхуки''':
+Пример вебхука:
-https://p.pfx.so/pf/ht/Iwbx21.png
+ <nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/<span style="color:red;">webhook/get/create_task</span>?<span style="color:green;">project</span>=проект&<span style="color:green;">name</span>=название задачи
-В разделе отображаются название, метод запроса и url вебхуков. По кнопке '''Новый вебхук''' можно выбрать предустановленные настройки или добавить самостоятельно настроенный вебхук:
+Когда по такой ссылке переходит клиент или другой внешний пользователь, в ПланФиксе автоматически запускаются заранее настроенные операции. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
-https://p.pfx.so/pf/aW/c7SjWC.png
+Вебхуки добавляются в ПланФикс в разделе '''Управление аккаунтом''' — '''Входящие вебхуки''':
+https://p.pfx.so/pf/Jj/h4w1Vq.png
-== Формирование вебхука ==
-Формируется вебхук за 6 шагов. С некоторыми шагами вы могли сталкиваться при настройке [[Автоматические сценарии |автоматических сценариев]]:
-*'''Шаг 1:''' выбираем тип запроса — GET или POST.
+По кнопке '''Новый вебхук''' можно выбрать один из предустановленных вариантов настройки или добавить самостоятельно настроенный вебхук:
-*'''Шаг 2:''' извлекаем данные — называем инфоблоки, входящие параметры и какие значения сохранить.
-https://p.pfx.so/pf/vl/ADS9pX.png
+https://p.pfx.so/pf/aW/c7SjWC.png
-*'''Шаг 3:''' Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука.
-https://p.pfx.so/pf/MC/hRGKxF.png
-*'''Шаг 4:''' Выбираем тип операции — создать или изменить задачу, создать контакт.
-https://p.pfx.so/pf/BP/5sXNus.png
-*'''Шаг 5:''' Добавляем дополнительные операции при необходимости.
-https://p.pfx.so/pf/Y5/iFRW2k.png
-*'''Шаг 6:''' Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта.
-https://p.pfx.so/pf/w6/s6CIfK.png
-== Пример использования ==
-Например, на сайте есть форма обратной связи. Она содержит поля: '''Имя''' и '''Телефон'''. Вы хотите, чтобы каждый раз, когда клиент заполнял форму на сайте, в ПланФиксе создавался новый контакт. Для этого:
-*Формируем ссылку вебхука, как показано ранее:
+== Примеры использования ==
+*[[Вебхук с GET-запросом]]
+*[[Вебхук с POST-запросом]]
+*[[Вебхук принимает данные из Jenkins]]
- <nowiki>https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75</nowiki>
+== Дополнительная информация ==
+*[https://planfix.com/ru/blog/vhodyashchie-vebhuki-poluchaem-dannye-v-planfiks-bez-promedleniya/ Входящие вебхуки: получаем данные в ПланФикс без промедления]
+*[https://planfix.ru/docs/JSONPath Приходящие в ПланФикс вебхуки можно разбирать, используя JSON. Для этого используется библиотека JsonPath]
+*[https://planfix.com/ru/blog/kak-otpravlyat-zakazy-iz-tildy-v-planfiks/ Как отправлять заказы из Тильды в ПланФикс]
-*Добавляем вебхук в код формы обратной связи:
+==  Важно ==
+*Входящие вебхуки возвращают JSON с номером созданной задачи (2) только из основной операции (1):
-<pre><form method="post" action="<nowiki>https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75</nowiki>">
+https://p.pfx.so/pf/pZ/Zqzn7c.png
-   <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></pre>
 == Перейти ==
+*[[HTTP-запросы]]
 *[[Описание возможностей]]

Навигация

Перейти