Инструкция: Как подружить Оки-Токи и Битрикс24

Рассмотрим 3 основных кейса: создание задачи в автообзвон при событии в Б24, создание лида в Б24 при событии в Оки-Токи, изменение статуса лида по событию в Оки-Токи. 

Важно! Настройки используют вебхуки в Оки-Токи, а также Роботы и Триггеры в Б24, что доступно не во всех тарифах.

Кейс №1. Как создать задачу в автообзвоне при событиях в Б24

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

1. Откройте настройки Роботы в Б24 и выберите нужный статус,
2. Перейдите к настройке Робота — нажав “Добавить” 
3. В выпадающем списке выберите “Свои роботы”. Выберите вариант Webhook. 
4. Всё. (*Увы, официальной документации на это нет.)

В настройке вебхука, укажите условия при срабатывании которых он будет отправлять данные в Оки-Токи. По умолчанию отправка происходит в момент перехода или создания лида/сделки в этот статус. С помощью дополнительных условий можно передавать только определенные лиды из Б24 (например только те, где есть конкретный ответственный). 

Затем составьте API-запрос на добавление задачи в автообзвон. Примеры запросов есть в документации по API Оки-Токи. Самый простой API-запрос должен содержать API-ключ пользователя Оки Токи и номер телефона. Конечно, можно, при необходимости, передавать и другие дополнительные данные с номером. Например: номер заказа, имя клиента, сумма задолженности и т.д.

api_token — создается в настройках профиля пользователя Оки-Токи.

dialer_id — номер автообзвона в который нужно добавить задачу. Берем значение тут:

Номер телефона передается из Б24. Он может быть получен из разных полей лида, а поэтому нужно указать имя переменной Б24 с номером телефона. Сделать это проще чем вы думаете. Об этом ниже и по шагам: 

1. Возьмите подготовленный ранее запрос (как из примера выше, только с указанными api-токеном и номером автообзвона)
2. Откройте настройки вебхука Б24 и копируете его в поле “Хендлер”. Там где нужно подставить переменную ставите курсор (в нашем случае после знака “=” возле переменной phones) кликните на три точки (…).
3. В меню (…) выберите поле с телефоном и Б24 подставит переменную этого поля. 
4. Сохраните настройки!
5. Все, ваш API-запрос составлен и готов к отправке.

Как проверить что все работает? Создайте или переместите лид/сделку, и если запрос составлен правильно — будет создана задача в автообзвоне.

Кейс №2. Как создание лид в Б24 при событиях в Оки -Токи

Какие есть типы событий в Оки-Токи и за что они отвечают?

• Функция(и) звонка — события, которые происходят во время звонков (сказать сообщение, очередь, оператор, переадресация, конференция и т.д.), 
• Статус пользователя — события, которые происходят при смене статуса пользователя (занят, готов, отсутствую)
• Входящее смс — событие входящего смс, когда используются GSM-шлюзы в Оки Токи (доступно только для UA компаний))
• Статус задачи (автообзвона) — результат обработки задачи в автообзвоне (успех, неудача, отмена) 
• Изменение списка — события вызванные действиями со списками (например: добавление, удаление)
• Дисциплинарный отчет — события возникающие при дисциплинарных нарушениях оператора/супервизора (оператор не ответил на звонок, оператор завершил звонок)
• АмоСРМ — используется для обработки событий из АмоСРМ.

Как создать вебхук на событие в Оки-Токи

Сначала создайте внешнюю интеграцию:

1. Зайдите в раздел Интеграции — внешние ресурсы — выберите Webhook. 

2. Укажите название интеграции, а в строке URL вставьте ссылку, на ваш Б24 и метод “Создание лида”. 

Пример: https://subdomain/crm/configs/import/lead.php, (где subdomain — это адрес вашего кабинета в Б24). Найти примеры с методами можно в API — документации Б24. Настроенный вебхук внешней интеграции выглядит вот так:

Дальше в разделе “Интеграции — События и интеграции” создайте webhook для события: 

1. Создайте новую привязку события к интеграции (webhook) и дайте ему название;
2. Выберите тип события (от этого будут зависеть доступные условия события);
3. Укажите интеграцию с Webhook которую сделали ранее; 
4. Действие по событию — оставьте значение по умолчанию, либо укажите что нужно сделать.

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

Механика добавления условия: выбираете из списка условие и укажите его параметры (выберите из доступного списка или заполните вручную).

Можно указывать ветвления условий И\ИЛИ:

Для создания лида нужно отправить в Б24 POST-запрос с методом “Создание лида” в Б24. Часть запроса (с поддоменом и методом) уже содержится в внешней интеграции которую указали в настройках, а остальное нужно прописать в параметры запроса (куда и что передавать). Тут уже используется API — документация Б24, в ней указано как надо правильно формулировать запрос к CRM, ID полей и описание методов и т.д. 

Пример тестового запроса

Тестовый запрос будет содержать только необходимое: авторизацию в CRM и номер телефона, который будет передан в соответствующее поле “Рабочий телефон” в Б24. 

1. Сначала в параметрах запроса укажите поля для авторизации LOGIN и PASSWORD — это учетные данные пользователя Б24 с правами на создание лидов.
2. Дальше укажите ID полей Б24 и данные из Оки-Токи (пример). 
3. Параметры запроса добавляются кнопкой “Добавить”, в Названии параметра пишете ID поля из Б24 (найти список ID полей можно в API — документации Б24), а в “Значение параметра” укажите переменную с данными из Оки-Токи (что передаем). Список переменных Оки Токи можно найти тут. 

Пример: в параметр PHONE_WORK (рабочий телефон из Б24) передается переменная Оки Токи {{dnis}} (сторона Б, вызываемый абонент). В запросе можно передать данные из Оки-Токи в соответствующие поля Б24, достаточно знать ID этих полей в Б24 и переменных Оки-Токи.

Кейс №3. Как сменить статус сделки при событии в Оки-Токи

Это самый простой кейс — нужно сгенерировать триггер в Б24, скопировать его во внешнюю интеграцию и потом подключить эту внешнюю интеграцию к обработчику событий (а как это сделать — см. выше)

Настройка пошагово для нужного вам статуса: 

• В настройках Роботов в Б24 в разделе “Триггеры”, сгенерируйте ссылку (пример ссылки). 
• Обязательно сохраните настройки!

• В Оки-Токи, в разделе Интеграции — Внешние ресурсы создайте новую внешнюю интеграцию с webhook, придумайте ей подходящее название и в поле “URL” вставьте сгенерированную ссылку триггера из Б24. 

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

• В параметрах этого события ничего указывать не нужно (в отличии от вебхука на создание лида). 

ВАЖНО! Для ИСХ/ВХ звонков это не сработает, так как с номером система не получает идентификатор лида из внешней CRМ. Вебхук на смену статуса в Б24 работает ТОЛЬКО в случае если задачи передавались из Б24 в автообзвон с указанием ID лида. 

Дополнительно: Как открывать анкеты из CRM Б24?

При автоматический звонках из автообзвона есть полезная возможность — открыть анкету/карточку лида во внешней CRM (при автозвонке можно открывать карточку лида из Б24). 

Необходимые условия 

• Оператор использует оперместо Оки-Токи (с включенным автооткрытием анкеты)
• Задача должна быть добавлена в автообзвон из Б24 с обязательным ID лида\сделки. Передача дополнительных данных к лиду передается при запросе в параметре details (пример: details={«ID»:»{{ID}}»})
• В автообзвоне, где требуется открывать внешнюю анкету, укажите ссылку на внешнюю CRM.
  • Пример ссылки: https://subdomain.bitrix24.ua/crm/lead/details/{{ID}}/ саму ссылку на карточку берете тут, указываете только переменную {{ID}} в конце ссылки вместо номера анкеты.
  • Ссылку вставляете в основных настройках автообзвона вот тут:

• • Не забывайте сохранить настройки автообзвона после указания внешней ссылки.

Возникли вопросы?  Создайте тикет в личном кабинете, и Техподдержка поможет с ответами.