17.06.2021

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

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

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

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

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

 

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

 

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

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

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

настройка вебхука Б24

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

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

профиль юзера Оки Токи

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

дайлер айди в интерфейсе Оки Токи

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

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

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

 

Кейс №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), а в “Значение параметра” укажите переменную с данными из Оки-Токи (что передаем). Список переменных Оки Токи можно найти тут
[smartslider3 slider=35]

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

 

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

 

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

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

  • В настройках Роботов в Б24 в разделе “Триггеры”, сгенерируйте ссылку (пример ссылки). 
  • Обязательно сохраните настройки!
[smartslider3 slider=36]
  • В Оки-Токи, в разделе Интеграции — Внешние ресурсы создайте новую внешнюю интеграцию с 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}} в конце ссылки вместо номера анкеты.
    • Ссылку вставляете в основных настройках автодозвона вот тут:

автодозвон Оки-Токи внешная ссылка

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

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

Оцените новость:
1 Звезда2 Звезды3 Звезды4 Звезды5 Звезд (Пока оценок нет)
Загрузка...

Читайте так же

photo
Суббота августа 8th, 2020 Дайджест новостей Оки-Токи за июнь-июль 2020

Новости Оки-Токи за июнь-июль 2020: оптимизация работы сервиса, переработанный внешний вид отчетов, новые цены. Читайте дайджест!

Подробнее
photo
Среда октября 9th, 2019 Отчеты колл-центра

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

Подробнее

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

    Соглашение на обработку персональных данных