Вебхук с POST-запросом: различия между версиями
Материал из Planfix
								
												
				Artem (обсуждение | вклад) Нет описания правки  | 
				Artem (обсуждение | вклад)  Нет описания правки  | 
				||
| (не показано 14 промежуточных версий этого же участника) | |||
| Строка 5: | Строка 5: | ||
|description=Вебхук с POST-запросом  | |description=Вебхук с POST-запросом  | ||
}}  | }}  | ||
Для того, чтобы понять как работают вебхуки с POST-запросом, рассмотрим пример создания контакта в ПланФиксе   | Для того, чтобы понять как работают [[Входящие вебхуки |вебхуки]] с POST-запросом, рассмотрим простой пример создания контакта в ПланФиксе после заполнения формы обратной связи на сайте.  | ||
Пример вебхука с POST-запросом:  | Пример вебхука с POST-запросом:  | ||
| Строка 11: | Строка 11: | ||
  <nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/<span style="color:green;">webhook/POST/create_contact</span>  |   <nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/<span style="color:green;">webhook/POST/create_contact</span>  | ||
Настроим вебхук, который будет создавать контакты:   | |||
*В типе указываем POST-запрос:  | |||
https://p.pfx.so/pf/ne/03Pu0B.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-запрос:
 
- Ссылка вебхука содержит уникальный код, но при желании его можно заменить на более информативный для человека:
 
- В параметры вебхука добавляем имена полей из формы обратной связи:
 
- Указываем от чьего имени будет выполняться действие в ПланФиксе после того, как сработает вебхук:
 
- Выбираем тип операции и настраиваем его. В итоге ПланФикс создаст новый контакт по выбранному шаблону, добавит Имя из параметра ссылки name и Телефон из параметра ссылки phone, затем оповестит нужного сотрудника о новом контакте:
 
- Далее добавляем дополнительные операции при необходимости и на последнем шаге указываем, какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или личного сайта:
 
- Добавляем ссылку вебхука в код формы обратной связи на сайте:
 
<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>
- Когда клиент заполнит в форме обратной связи имя и телефон, а затем кликнет на кнопку Отправить:
 
- Значения из полей формы добавятся в вебхук и отправятся в ПланФикс, где автоматически создастся новый контакт: