Вебхук с POST-запросом
Чтобы понять, как работают вебхуки с POST-запросами, рассмотрим простой пример: создание контакта в Planfix для человека, который заполнил форму обратной связи на вашем сайте.
Пример вебхука с POST-запросом:
https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact
Настроим вебхук, который будет создавать контакты:
- Укажем POST-запрос в качестве типа:
- Ссылки вебхуков содержат уникальный код, который при необходимости можно заменить на более понятный:
- В параметры вебхука добавим названия полей из формы обратной связи:
- Укажем имя сотрудника, от которого в Planfix будет выполняться действие после срабатывания вебхука:
- Выберем тип операции и настроим её. В результате Planfix создаст новый контакт по указанному шаблону, добавит имя из параметра name в ссылке и номер телефона из параметра phone в ссылке, а затем уведомит нужного сотрудника о новом контакте:
- Затем добавим при необходимости дополнительные операции, а на последнем шаге укажем, какой ответ должен возвращать вебхук: JSON, переход в Planfix или переход на ваш сайт:
- Добавим ссылку на вебхук в код формы обратной связи на вашем сайте:
<form method="post" action="https://own_account.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>
- Когда клиент заполнит форму обратной связи, указав имя и номер телефона, и нажмёт кнопку «Отправить»:
- Значения из полей формы добавятся в вебхук и будут отправлены в Planfix, где автоматически создастся новый контакт: