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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показано 11 промежуточных версий этого же участника)
Строка 5: Строка 5:
|description=Вебхук с POST-запросом
|description=Вебхук с POST-запросом
}}
}}
Для того, чтобы понять как работают вебхуки с POST-запросом, рассмотрим пример создания контакта в ПланФиксе через заполнение формы обратной связи на сайте. Для этого в ПланФиксе настроим вебхук, который будет создавать контакты.
Для того, чтобы понять как работают [[Входящие вебхуки |вебхуки]] с POST-запросом, рассмотрим простой пример создания контакта в ПланФиксе после заполнения формы обратной связи на сайте.


Пример вебхука с POST-запросом:
Пример вебхука с POST-запросом:
Строка 12: Строка 12:




Настраиваем вебхук, который будет создавать новый контакт:
Настроим вебхук, который будет создавать контакты:
 
*В типе указываем POST-запрос:


https://p.pfx.so/pf/ne/03Pu0B.png
https://p.pfx.so/pf/ne/03Pu0B.png




*Вебхук можно уникализировать, добавив свои значения в специальное поле:
*Ссылка вебхука содержит уникальный код, но при желании его можно заменить на более информативный для человека:


https://p.pfx.so/pf/kA/Euc8s9.png
https://p.pfx.so/pf/kA/Euc8s9.png




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


https://p.pfx.so/pf/Tp/EaeJVs.png
https://p.pfx.so/pf/Tp/EaeJVs.png




*Добавляем вебхук в код формы обратной связи на сайте:
*Указываем от чьего имени будет выполняться действие в ПланФиксе после того, как сработает вебхук:
 
https://p.pfx.so/pf/MC/hRGKxF.png
 
 
*Выбираем тип операции и настраиваем его. В итоге ПланФикс создаст новый контакт по выбранному шаблону, добавит Имя  из параметра ссылки '''name''' и Телефон из параметра ссылки '''phone''', затем оповестит нужного сотрудника о новом контакте:
 
https://p.pfx.so/pf/r2/uqTYV0.png
 
 
*Далее добавляем дополнительные операции при необходимости и на последнем шаге указываем, какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или личного сайта:
 
https://p.pfx.so/pf/zw/MdygxF.png
 
 
*Добавляем ссылку вебхука в код формы обратной связи на сайте:


<div style="width:100%; margin: 0 0 10px; font-size: 13px; line-height: 1.65; word-break: break-all; color: black; background-color: #f9f9f9; border: 1px solid #ddd; padding: 1em 1em 0px 1em; font-family:monospace,Courier; border-radius: 4px;">
<div style="width:100%; margin: 0 0 10px; font-size: 13px; line-height: 1.65; word-break: break-all; color: black; background-color: #f9f9f9; border: 1px solid #ddd; padding: 1em 1em 0px 1em; font-family:monospace,Courier; border-radius: 4px;">

Текущая версия от 15:03, 15 февраля 2021

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

Пример вебхука с POST-запросом:

https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact


Настроим вебхук, который будет создавать контакты:

  • В типе указываем POST-запрос:

03Pu0B.png


  • Ссылка вебхука содержит уникальный код, но при желании его можно заменить на более информативный для человека:

Euc8s9.png


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

EaeJVs.png


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

hRGKxF.png


  • Выбираем тип операции и настраиваем его. В итоге ПланФикс создаст новый контакт по выбранному шаблону, добавит Имя из параметра ссылки name и Телефон из параметра ссылки phone, затем оповестит нужного сотрудника о новом контакте:

uqTYV0.png


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

MdygxF.png


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

<form method="post" action="https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact">
  <input type="text" name="name" placeholder="Имя">
  <input type="text" name="phone" placeholder="Телефон">
  <input type="submit" name="submit" value="Отправить">
</form>


  • Когда клиент заполнит в форме обратной связи имя и телефон, а затем кликнет на кнопку Отправить:

xorhzH.png


  • Значения из полей формы добавятся в вебхук и отправятся в ПланФикс, где автоматически создастся новый контакт:

KPIrAJ.png


Перейти