Входящие вебхуки: различия между версиями
Artem (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
| Строка 22: | Строка 22: | ||
*'''Шаг 1:''' выбираем тип запроса — GET или POST. | *'''Шаг 1:''' выбираем тип запроса — GET или POST. | ||
*'''Шаг 2:''' извлекаем данные из вебхука — называем инфоблоки, входящие параметры и какие значения сохранить | *'''Шаг 2:''' извлекаем данные из вебхука — называем инфоблоки, входящие параметры и какие значения сохранить: | ||
https://p.pfx.so/pf/vl/ADS9pX.png | https://p.pfx.so/pf/vl/ADS9pX.png | ||
*'''Шаг 3:''' Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука | *'''Шаг 3:''' Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука: | ||
https://p.pfx.so/pf/MC/hRGKxF.png | https://p.pfx.so/pf/MC/hRGKxF.png | ||
*'''Шаг 4:''' Выбираем тип операции — создать или изменить задачу, создать контакт | *'''Шаг 4:''' Выбираем тип операции — создать или изменить задачу, создать контакт: | ||
https://p.pfx.so/pf/BP/5sXNus.png | https://p.pfx.so/pf/BP/5sXNus.png | ||
*'''Шаг 5:''' Добавляем дополнительные операции при необходимости | *'''Шаг 5:''' Добавляем дополнительные операции при необходимости: | ||
https://p.pfx.so/pf/Y5/iFRW2k.png | https://p.pfx.so/pf/Y5/iFRW2k.png | ||
*'''Шаг 6:''' Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта | *'''Шаг 6:''' Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта: | ||
https://p.pfx.so/pf/w6/s6CIfK.png | https://p.pfx.so/pf/w6/s6CIfK.png | ||
| Строка 49: | Строка 49: | ||
== Пример использования == | == Пример использования == | ||
Настроим автоматическое создание контактов в ПланФиксе из формы обратной связи на сайте. Для этого: | |||
*Формируем ссылку вебхука. Для отправки формы нужен вебхук с POST-запросом: | *Формируем ссылку вебхука. Для отправки формы нужен вебхук с POST-запросом: | ||
Версия от 09:52, 12 февраля 2021
Входящие вебхуки позволяют создавать и изменять задачи в ПланФиксе по ссылке или команде из внешнего источника. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
Добавить вебхуки в ПланФикс можно в разделе Управление аккаунтом — Входящие вебхуки:
В разделе отображаются название, метод запроса и url вебхуков. По кнопке Новый вебхук можно выбрать предустановленные настройки или добавить самостоятельно настроенный вебхук:
Формирование вебхука
Формируется вебхук за 6 шагов. С некоторыми шагами вы могли сталкиваться при настройке автоматических сценариев:
- Шаг 1: выбираем тип запроса — GET или POST.
- Шаг 2: извлекаем данные из вебхука — называем инфоблоки, входящие параметры и какие значения сохранить:
- Шаг 3: Указываем от чьего имени будет выполнятся действие в ПланФиксе после срабатывания вебхука:
- Шаг 4: Выбираем тип операции — создать или изменить задачу, создать контакт:
- Шаг 5: Добавляем дополнительные операции при необходимости:
- Шаг 6: Указываем какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или своего сайта:
Пример использования
Настроим автоматическое создание контактов в ПланФиксе из формы обратной связи на сайте. Для этого:
- Формируем ссылку вебхука. Для отправки формы нужен вебхук с POST-запросом:
https://planfix.ru/webhook/POST/fd12-4545-fzdf-df75
- Добавляем в код формы обратной связи:
<form method="post" action="https://planfix.ru/webhook/POST/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>
Теперь каждый раз, когда клиенты будут заполнять форму обратной связи на сайте, в ПланФиксе будет автоматически создаваться контакт.