|
|
Строка 28: |
Строка 28: |
| *[[Вебхук с GET-запросом]] | | *[[Вебхук с GET-запросом]] |
| *[[Вебхук с POST-запросом]] | | *[[Вебхук с POST-запросом]] |
− |
| |
− |
| |
− | == Формирование вебхука с GET-запросом ==
| |
− | Для того, чтобы понять как работают вебхуки, сформируем ссылку, которая будет создавать новые задачи в ПланФиксе:
| |
− |
| |
− | *На первом шаге выберите тип запроса, который будет использоваться в ссылке — GET или POST. Для примера GET-запрос:
| |
− |
| |
− | https://p.pfx.so/pf/IE/BETP4r.png
| |
− |
| |
− |
| |
− | *Вебхук можно уникализировать, добавив свои значения в специальное поле:
| |
− |
| |
− | https://p.pfx.so/pf/G2/A2aDET.png
| |
− |
| |
− |
| |
− | *На следующем шаге добавляем к вебхуку параметры. В них будут хранится значения, которые пользователь передает в ПланФикс. В примере мы передаём название проекта и название задачи:
| |
− |
| |
− | https://p.pfx.so/pf/b1/X21MgH.png
| |
− |
| |
− |
| |
− | *Указываем от чьего имени будет выполнятся действие в ПланФиксе после того, как сработает вебхук:
| |
− |
| |
− | https://p.pfx.so/pf/MC/hRGKxF.png
| |
− |
| |
− |
| |
− | *Выбираем тип операции и настраиваем его. В итоге ПланФикс должен создать задачу по выбранному шаблону, добавить название проекта из параметра ссылки '''project''' и название задачи из параметра ссылки '''name''', затем к задаче добавить указанного исполнителя:
| |
− |
| |
− | https://p.pfx.so/pf/sI/GNcuHj.png
| |
− |
| |
− |
| |
− | *Далее добавляем дополнительные операции при необходимости:
| |
− |
| |
− | https://p.pfx.so/pf/ZL/mOEm3P.png
| |
− |
| |
− |
| |
− | *И на последнем шаге указываем, какой ответ от вебхука хотим получить — JSON, переход на страницу ПланФикса или личного сайта:
| |
− |
| |
− | https://p.pfx.so/pf/Ya/2B94qS.png
| |
− |
| |
− |
| |
− | Теперь, используя этот вебхук, можно быстро создавать новые задачи в нужном проекте прямо в адресной строке браузера:
| |
− |
| |
− | *Копируем ссылку созданного вебхука и добавляем в адресную строку браузера:
| |
− |
| |
− | <nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/get/create_task?<span style="color:green;">project</span>=<span style="color:red;">укажите</span>&<span style="color:green;">name</span>=<span style="color:red;">укажите</span>
| |
− |
| |
− |
| |
− | *Затем указываем нужные значения и переходим по ссылке:
| |
− |
| |
− | <nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/get/create_task?<span style="color:green;">project</span>=<span style="color:red;">SEO</span>&<span style="color:green;">name</span>=<span style="color:red;">Анализ конкурентов</span>
| |
− |
| |
− |
| |
− | *В итоге в ПланФиксе появилась новая задача:
| |
− |
| |
− | https://p.pfx.so/pf/Fz/eubqkO.png
| |
− |
| |
− |
| |
− | == Важно ==
| |
− | Добавление значений в параметры ссылки вебхука можно и нужно автоматизировать, применяя различные [[Переменные в шаблонах задач |переменные]].
| |
− |
| |
− |
| |
− | == Использование вебхука с POST-запросом ==
| |
− | Автоматизацию заполнения значений параметров ссылки вебхука рассмотрим на примере формы обратной связи на сайте. Для этого в ПланФиксе настроим вебхук, который будет создавать контакты:
| |
− |
| |
− | *Для отправки формы нужен вебхук с POST-запросом:
| |
− |
| |
− | <nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/<span style="color:green;">POST</span>/create_contact
| |
− |
| |
− | https://p.pfx.so/pf/Tp/EaeJVs.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;">
| |
− | <form method="post" action="<nowiki>https://</nowiki>ваш_аккаунт.planfix.ru/webhook/POST/create_contact"><br>
| |
− | <input type="text" name="<span style="color:green;">name</span>" placeholder="<span style="color:red;">Имя</span>"><br>
| |
− | <input type="text" name="<span style="color:green;">phone</span>" placeholder="<span style="color:red;">Телефон</span>"><br>
| |
− | <input type="submit" name="submit" value="Отправить"><br>
| |
− | </form>
| |
− | </div>
| |
− |
| |
− |
| |
− | *Когда клиент заполнит в форме обратной связи '''имя''' и '''телефон''', а затем кликнет на кнопку '''Отправить''':
| |
− |
| |
− | https://p.pfx.so/pf/Fk/xorhzH.png
| |
− |
| |
− |
| |
− | *Значения из полей формы добавятся в вебхук и отправятся в ПланФикс, где автоматически создастся новый контакт:
| |
− |
| |
− | https://p.pfx.so/pf/hS/KPIrAJ.png
| |
| | | |
| | | |
| == Перейти == | | == Перейти == |
| *[[Описание возможностей]] | | *[[Описание возможностей]] |