В ПланФиксе появились вебхуки. Это специальные ссылки, которые нужны для взаимодействия с другими программами и сайтами. Кто впервые слышит о них, не переживайте. Далее объясню, что это такое и для чего.

Что такое вебхуки?

Вебхук — это механизм оповещения одной системы о событиях в другой. Например, на складе товар отгрузили клиенту. Информация об этом из системы складского учета через специальную ссылку поступила в ПланФикс, и в задаче автоматически сменился статус с «Товар отгружается» на «Товар отгружен клиенту». Ссылка, через которую произошло такое взаимодействие двух программ, и называется вебхуком.

Вот пример того, как может выглядеть вебхук в ПланФиксе:

https://ваш_аккаунт.planfix.ru/webhook/get/create_task?project=SEO&name=Провести анализ сайта

Переход по такой ссылке автоматически запустит заранее настроенную операцию: создание задачи в указанном проекте. 

Вебхук содержит в себе информацию:

Вебхуки могут быть двух типов: с GET- или POST-запросом. В чем между ними разница, в каких случаях стоит применять один тип запроса, а в каких другой — подробно расписано в справке. Там же вы найдете примеры применения вебхуков.

В ПланФиксе с помощью входящих вебхуков можно:

• создавать и изменять задачи,
• добавлять комментарии,
• создавать новые контакты.

Как работают вебхуки?

Понять принцип работы вебхуков просто — посмотрите на правила для работы с почтой в ПланФиксе. Вебхуки очень похожи на них. 

Правило почты:

1. Срабатывает при поступлении письма.
2. Формирует инфоблоки.
3. Данными из инфоблоков заполняет поля задач и контактов.

Вебхук:

1. Срабатывает при переходе по ссылке.
2. Формирует инфоблоки.
3. Данными из инфоблоков заполняет поля задач и контактов.

Как видите, между правилами работы с почтой и вебхуками много общего, только источники срабатывания разные.

Как сформировать ссылку вебхука?

Вебхуки настраиваются в разделе «Управление аккаунтом» — «Входящие вебхуки»:

Разбираться в сложных темах лучше всего на примерах. Поэтому давайте покажу, как организовать в ПланФиксе оценку качества работы сотрудников.

Наш пример:

1. Клиент обратился в Службу поддержки по e-mail. 
2. В ПланФиксе появилась новая задача.
3. Сотрудник Службы поддержки ответил.
4. Клиент доволен.
5. Задача перешла в статус «Выполненная».
6. Клиент автоматически получил сообщение с просьбой оценить работу сотрудника.

Сразу отмечу, этот пример актуален для компаний, клиенты которых ведут переписку через электронную почту.

Этапы настройки:

1. Добавим в карточку задачи поле типа «Список» с оценками работы сотрудника.
2. Настроим два вебхука: с положительной и отрицательной оценкой.
3. Добавим автоматический сценарий, который после изменения статуса задачи будет опрашивать клиента о качестве предоставленных услуг.

Приступим.

Запасайтесь чайком, дальше много текста 🙂

Первый этап: поле «Оценка работы сотрудника»

Добавляем в карточку задачи поле «Оценка работы сотрудника». В нём две оценки – «молодец» и «соленый огурец»:

Второй этап: настраиваем вебхуки

Нажимаем кнопку «Новый вебхук». Появляется список предустановленных настроек. Для нашего примера я настрою вебхук самостоятельно, поэтому в списке выберу ссылку «Другое»:

На первом шаге указываем тип вебхука. Для нашего примера достаточно сформировать простую ссылку с GET-запросом:

На втором шаге добавим параметры, которые надо передавать в ПланФикс. Эта часть настройки вебхука очень похожа на настройку инфоблоков в правилах по разбору почты. Параметр я назвал «Task». А инфоблок, куда будет попадать значение параметра, «Задача»:

Обратите внимание, уникальность ссылки обеспечивается за счет идентификатора, который состоит из набора цифр и букв:

Его можно отредактировать и сделать понятным для человека:

На третьем шаге укажем от чьего имени выполнять операции в ПланФиксе:

Дальше самое интересное. Настраиваем операции, которые ПланФикс автоматически выполнит, когда клиент перейдет по ссылке:

Тут всё просто. Помните, на втором шаге добавили инфоблок? Сейчас мы говорим ПланФиксу, чтобы он искал задачу с такими же номером, как в инфоблоке. И затем в найденной задаче добавил оценку «Молодец» в поле «Оценка работы сотрудника».

На пятом шаге никаких дополнительных действий не добавляем. А вот на шестом можно указать, куда клиент будет перенаправлен, когда кликнет на ссылку вебхука. Обычно для таких целей используется страница сайта, на которой клиенту сообщается об успешной оценке сотрудника. Тут же укажите и другую страницу, если что-то пойдёт не так:

На этом формирование ссылки вебхука с положительной оценкой завершено. 

Перейдём к вебхуку с отрицательной оценкой сотрудника. Он отличается от предыдущего только тем, что на пятом шаге уведомляем начальника комментарием об отрицательной оценке:

Третий этап: автоматический сценарий опроса клиента

Это завершающий этап настройки. У нас есть поле для оценок и два вебхука. Добавим событие, при котором клиент получит сообщение с просьбой оценить сотрудника.

Я отправлю сообщение клиенту, когда задача-диалог переведена в статус «Выполненная», таким автоматическим сценарием:

Обратите внимание на комментарий, который отправляется клиенту. В нём две ссылки. Первая — запустит сценарий выставления положительной оценки, вторая — отрицательной. Тут есть важный момент. Изначально ссылка вебхука, после настройки выглядит так:

Слово «укажите» надо заменить на переменную, например номера задачи, в которой сотрудник работал с клиентом.

Где взять переменную? Нажимаем на ссылку «различные поля» и формируем переменную номера задачи:

Теперь вебхук с положительной оценкой будет выглядеть так:

Окончательно сформированную ссылку добавляем в сообщение. Выделяем нужное слово и нажимаем на иконку добавления ссылки:

Вот что в итоге увидит клиент:

Клиент кликнет на одну из ссылок, вебхук сработает. Откроется страница сайта с сообщением о благодарности за обратную связь, а в ПланФиксе в выполненной задаче автоматически добавится соответствующая оценка:

Теперь вы знаете способ, как организовать в ПланФиксе оценку качества работы сотрудников. Всем, кто дочитал до конца, по плюсику в карму 😉

А что дальше?

Если вы всё прочитали, а вам ничего непонятно до сих пор — не переживайте. Вебхуки — это не то, что срочно надо всем сделать. Просто знайте, если в будущем столкнетесь с задачей по настройке оценки работы сотрудников, в блоге ПланФикса вас ждёт готовый алгоритм действий на такой случай. А в справке есть пример того, как получить контактные данные из формы обратной связи на сайте.

В целом, вебхуки находятся на той грани, где заканчивается просто настройка ПланФикса и начинается программирование. Поэтому, если вам что-то кажется сложным и непонятным — это нормально. Зовите программистов и обрадуйте их, что есть возможность отправлять в ПланФикс POST-запросы. И может быть какие-то процессы в вашей работе станут ещё удобнее.

---

Если остались вопросы — задавайте их нашей Службе поддержки, подписывайтесь на социальные сети: Facebook, ВКонтакте, Telegram, Twitter, YouTube-канал и пользуйтесь вебхуками 😉