Входящие вебхуки
Входящие вебхуки — это специальная ссылка, которая позволяет создавать и изменять задачи или добавлять контакты в ПланФикс. Она формируется из определенного типа и параметров.
Пример вебхука:
https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=проект&name=название задачи
Когда по такой ссылке переходит клиент или другой внешний пользователь, в ПланФиксе автоматически запускаются заранее настроенные операции. Это простой способ связать ПланФикс с другим веб-сервисом или собственной программой.
Вебхуки добавляются в ПланФикс в разделе Управление аккаунтом — Входящие вебхуки:
По кнопке Новый вебхук можно выбрать один из предустановленных вариантов настройки или добавить самостоятельно настроенный вебхук:
Формирование вебхука с GET-запросом
Для того, чтобы понять как работают вебхуки, сформируем ссылку, которая будет создавать новые задачи в ПланФиксе:
- На первом шаге выберите тип запроса, который будет использоваться в ссылке — GET или POST. Для примера GET-запрос:
- Вебхук можно уникализировать, добавив свои значения в специальное поле:
- На следующем шаге добавляем к вебхуку параметры. В них будут хранится значения, которые пользователь передает в ПланФикс. В примере мы передаём название проекта и название задачи:
- Указываем от чьего имени будет выполнятся действие в ПланФиксе после того, как сработает вебхук:
- Выбираем тип операции и настраиваем его. В итоге ПланФикс должен создать задачу по выбранному шаблону, добавить название проекта из параметра ссылки project и название задачи из параметра ссылки name, затем к задаче добавить указанного исполнителя:
- Далее добавляем дополнительные операции при необходимости:
- И на последнем шаге указываем, какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или личного сайта:
Теперь, используя этот вебхук, можно быстро создавать новые задачи в нужном проекте прямо в адресной строке браузера:
- Копируем ссылку созданного вебхука и добавляем в адресную строку браузера:
https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=укажите&name=укажите
- Затем указываем нужные значения и переходим по ссылке:
https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=SEO&name=Анализ конкурентов
- В итоге в ПланФиксе появилась новая задача:
Важно
Добавление значений в параметры ссылки вебхука можно и нужно автоматизировать, применяя различные переменные.
Использование вебхука с POST-запросом
Автоматизацию заполнения значений параметров ссылки вебхука рассмотрим на примере формы обратной связи на сайте. Для этого в ПланФиксе настроим вебхук, который будет создавать контакты:
- Для отправки формы нужен вебхук с POST-запросом:
https://ваш_аккаунт.planfix.ru/webhook/POST/create_contact?name=укажите&phone=укажите
- Добавляем вебхук в код формы обратной связи на сайте:
<input type="text" name="name" placeholder="Имя">
<input type="text" name="phone" placeholder="Телефон">
<input type="submit" name="submit" value="Отправить">
</form>
Теперь каждый раз, когда клиенты будут заполнять форму обратной связи и нажимать на кнопку, в ПланФиксе будет автоматически создаваться новый контакт.