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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 56: Строка 56:




*Добавляем вебхук в код формы обратной связи:
*Добавляем в код формы обратной связи:


<pre><form method="post" action="<nowiki>https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75</nowiki>">
<pre><form method="post" action="<nowiki>https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75</nowiki>">
Строка 64: Строка 64:
</form></pre>
</form></pre>


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


== Перейти ==
== Перейти ==
*[[Описание возможностей]]
*[[Описание возможностей]]

Версия от 15:04, 11 февраля 2021

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

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

Iwbx21.png


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

c7SjWC.png


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

Формируется вебхук за 6 шагов. С некоторыми шагами вы могли сталкиваться при настройке автоматических сценариев:

  • Шаг 1: выбираем тип запроса — GET или POST.
  • Шаг 2: извлекаем данные — называем инфоблоки, входящие параметры и какие значения сохранить.

ADS9pX.png


  • Шаг 3: Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука.

hRGKxF.png


  • Шаг 4: Выбираем тип операции — создать или изменить задачу, создать контакт.

5sXNus.png


  • Шаг 5: Добавляем дополнительные операции при необходимости.

iFRW2k.png


  • Шаг 6: Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта.

s6CIfK.png


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

Например, на сайте есть форма обратной связи. Она содержит поля: Имя и Телефон. Вы хотите, чтобы каждый раз, когда клиент заполнял форму на сайте, в ПланФиксе создавался новый контакт. Для этого:

  • Формируем ссылку вебхука, как показано ранее:
https://planfix.ru/webhook/GET/fd12-4545-fzdf-df75


  • Добавляем в код формы обратной связи:
<form method="post" action="https://planfix.ru/webhook/GET/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>


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

Перейти