|
|
| (не показано 26 промежуточных версий этого же участника) |
| Строка 2: |
Строка 2: |
| |title=Входящие вебхуки в ПланФиксе | | |title=Входящие вебхуки в ПланФиксе |
| |titlemode=append | | |titlemode=append |
| |keywords=планфикс, автоматизация, интеграция, входящие вебхуки, webhook | | |keywords=планфикс, автоматизация, интеграция, входящие вебхуки, webhook, вебхук |
| |description=Входящие вебхуки в ПланФиксе | | |description=Входящие вебхуки в ПланФиксе |
| }} | | }} |
| Строка 25: |
Строка 25: |
|
| |
|
|
| |
|
| == Формирование вебхука с GET-запросом == | | == Примеры использования == |
| Для того, чтобы понять как работают вебхуки, сформируем ссылку, которая будет создавать новые задачи в ПланФиксе:
| | *[[Вебхук с GET-запросом]] |
| | *[[Вебхук с POST-запросом]] |
| | *[[Вебхук принимает данные из Jenkins]] |
|
| |
|
| *На первом шаге выберите тип запроса, который будет использоваться в ссылке — GET или POST. Для примера GET-запрос:
| |
|
| |
|
| https://p.pfx.so/pf/IE/BETP4r.png | | == Дополнительно == |
| | *[https://planfix.ru/docs/JSONPath Приходящие в ПланФикс вебхуки можно разбирать, используя JSON. Для этого используется библиотека JsonPath] |
| | <geoip eq="RU,BY">*[https://planfix.com/ru/blog/vhodyashchie-vebhuki-poluchaem-dannye-v-planfiks-bez-promedleniya/ Входящие вебхуки: получаем данные в ПланФикс без промедления] |
| | *[https://planfix.com/ru/blog/kak-otpravlyat-zakazy-iz-tildy-v-planfiks/ Как отправлять заказы из Тильды в ПланФикс]</geoip> |
|
| |
|
| | == Важно == |
| | *Входящие вебхуки возвращают JSON с номером созданной задачи (2) только из основной операции (1): |
|
| |
|
| *Вебхук можно уникализировать, добавив свои значения в специальное поле:
| | https://p.pfx.so/pf/pZ/Zqzn7c.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/ij/ZkZUWp.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>
| |
| | |
| | |
| Когда клиенты заполнят в форме обратной связи <span style="color:red;">Имя</span> и <span style="color:red;">Телефон</span>, а затем кликнут на кнопку '''Отправить''', значения из полей формы добавятся в вебхук и отправятся в ПланФикс, где автоматически создастся новый контакт.
| |
|
| |
|
|
| |
|
| == Перейти == | | == Перейти == |
| | *[[HTTP-запросы]] |
| *[[Описание возможностей]] | | *[[Описание возможностей]] |
