Использование вебхука для подключения внешнего сервиса в Битрикс24

1. Нестандартные методы автоматизации: концепция билдера

Возьмем в пример рядовую ситуацию.

Компания заказчика работает в коробке Битрикс24 (или облаке — не принципиально) и ей понадобилась интеграция с сервисом для обмена данными. Интеграция доступна в платформе Пинкит.

Заказчик идет в Маркет Битрикс24 и ищет готовое решение:

Но возможно такое, что необходимого предложения не окажется в Маркете:

Заказчик обратился в нашу компанию, а мы помогли настроить автоматизацию с помощью вебхука.

В большинстве случаев интеграции нужны компаниям для регулярного обмена данными, но бывают и исключения.

В сервисе Пинкит есть все необходимые события (на первом шаге настройки) для реализации различных сценариев.

Для большей вариативности настроек мы реализовали в Пинкит концепцию билдера.

Проще говоря, триггеры на первом шаге добавляются не при помощи разработки, а нашими инженерами.

Таким образом список событий в Битрикс24, необходимый нашим заказчикам, пополняется за наш счет, и нет необходимости добавлять триггеры под отдельно взятую ситуацию клиента.

Вебхуки: что это такое и как они помогают при интеграции внешних сервисов с Битрикс24 - читайте здесь.

Поэтому если вам требуется автоматизация для Битрикс24 или другой CRM с каким-либо сервисом, просто авторизуйтесь на сайте Пинкит и настройте ее по нашей инструкции здесь.

Инструкция по настройке вебхука в Битрикс24 находится здесь.

Далее более подробно разберем события, доступные в личном кабинете Пинкит.

2. События, доступные для настройки интеграций на шаге 1 для Битрикс24 в Пинкит

Допустим, вашей компании понадобилась миграция данных из облака в коробку Битрикс24.

Для этого на первом шаге настройки интеграции нужно выбрать событие:

Группа - создание

Группы - это объединения сотрудников под определённые цели, как например, отделы в компании.

Группам можно выбрать либо закрытый, либо открытый тип приватности.

Если групп достаточно много, то перекидывать данные вручную сложно и долго.

Лучше всего миграцию выполнить через специальный триггер на первом шаге с авторизацией через вебхук.

Дело - создание

Обычно дела нужны для планирования встреч или звонков.

В одной сущности Битрикс24 дел может быть несколько, как и привязанных к этим делам клиентов.

Поэтому их автоматическая выгрузка позволяет начать работу на новом портале в самые короткие сроки.

Дело - обновлено (мгновенно)

Здесь функционал аналогичен предыдущему пункту. Разница лишь в том, что здесь можно внести корректировки в дела.

Задача - создана

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

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

Задача - обновлена

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

Задача - добавлена запись учета времени

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

На основе затраченного времени составляются отчеты и далее формируется зарплата менеджеров, поэтому этот параметр важно передать корректно.

Компания - создана

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

Компания - обновлена

Данное событие поможет быстро выгрузить актуальные данные и избежать ошибок, если вы корректируете данные компаний.

Контакт - создание

В контактах, равно как и в компаниях, зачастую также накапливается важная информация. Еще у них есть привязка к компаниям и сделкам.

Контакт - обновление

В рабочем процессе может возникнуть ситуация, когда у контактного лица компании вашего клиента может поменяться номер телефона.

Данный триггер поможет автоматически выгрузить такие изменения.

Лид - создание

В данных сущностях работа идет в основном с новыми заявками из разных источников.

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

Лид - обновление

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

Такие изменения могут повлиять на дальнейшую работу с лидом.

Новое сообщение (бот)

В Пинкит есть инструмент чат-бота. Он нужен для отправки уведомлений о событиях в чат сделки или групповой чат Битрикс24.

Пользователь - создание

Если у вас подключен тариф Энтерпрайз на 100 и более сотрудников, то данное событие поможет выгрузить всех пользователей.

Пользователь - обновление

Если в профиль сотрудника вносятся изменения, то информация обновиться и на другом портале.

Реквизиты - создание

Событие предназначено для передачи реквизитов, например, в компаниях или смарт-процессах.

Реквизиты - обновление

Тут ситуация аналогичная предыдущему пункту, только применятся для корректировки реквизитов.

Сделка - создание

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

Сделка - обновление

Смарт-процесс - создание

Эту сущность зачастую применяют как дополнение к сделкам. В смарт-процессе можно, например, вести воронку найма.

Смарт-процесс - обновление

Событие в календаре - создание

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

Счет (старая версия) - создание

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

Плюс счета привязаны к контакту или компании. Событие помогает выгрузить их быстро и безошибочно.

Счет (старая версия) - обновление

С помощью данного события можно вносить изменения в счета.

Счет (новая версия) - создание

Новые счета добавлены в Битрикс24 на базе смарт-процессов, под них мы добавили два отдельных события.

Счет (новая версия) - обновление

Товар - создание

Ряд заказчиков ведут в Битрикс24 товарный каталог, в котором товары привязаны к сделкам или смарт-процессам.

Автоматическая выгрузка товаров из одного Битрикс24 в другой Битрикс24 или внешний сервис уменьшит число ошибок, которые возникли бы при ручном переносе.

Товар - обновление

Элемент списка - обновление

Событие подходит для тех, кто хранит важные данные в универсальных списках.

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

Событие помогает сократить ручной труд при переносе данных.

3. Резюмируем

Впоследствии список будет расширяться, возможно и с вашей помощью.

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

Если у вас нет возможности авторизовать Пинкит в Битрикс24 стандартным способом (через приложение), зарегистрируйтесь по ссылке https://lk.pinkit.io/register, добавьте и протестируйте интеграцию через вебхук самостоятельно.

Алексей Окара,
основатель Пинол и продакт-менеджер Пинкит