Введение

Назначение

Данное руководство описывает процесс интеграции шлюзов SMG с CRM-системой Битрикс24 с использованием сервиса ecss-crm-server.

Интеграция обеспечивает:

• обработку входящих и исходящих вызовов
• отображение карточки звонка в интерфейсе Битрикс24
• выполнение Click-to-Call
• синхронизацию пользователей и номеров.

Предварительная настройка

Перед началом интеграции необходимо выполнить следующие шаги.

1. Настроить API сервер шлюза

• Убедиться, что API сервер включён и настроен интерфейс событий вызова

API → Сервер

2. Создать ключ

• Ключ создаётся через веб-интерфейс шлюза

API → Ключи

• ID клиента - идентификатор клиента для подключения к ecss-crm-server
• Ключ - ключ API для подключения к ecss-crm-server

3. Создать абонента

Абонент должен иметь:

• включённый доступ к API
• быть привязан к созданному API-ключу

4. Установить ecss-crm-server

Вся подробная информация находится по ссылке Установка ecss-crm-server на SSW

Установка приложения в Битрикс24

Создание локального приложения в Битрикс24

Для установки приложения необходимо создать локальное приложение Битрикс24:

1. Для перехода в меню откройте вкладку Приложение в меню Битрикс24, располагающимся в левой части экрана, и выберите пункт Разработчикам в выпадающем списке.

2. В открывшемся меню «Маркет» нажмите кнопку Другое.

3. В меню «Готовые сценарии» нажмите на вкладку Локальное приложение.

4. В настройках локального приложения необходимо указать следующие параметры:

1. Название интеграции (по умолчанию «Локальное приложение»);
2. Тип приложения «Серверное»;
3. Ссылку на ecss-crm-server (<IP:port>:8802/bitrix);
4. Галочку «Приложение использует только API»;
5. В графе «Настройка прав» выбрать:
   1. Встраивание приложений (placement);
   2. Пользователи (user);
   3. Телефония (совершение звонков) (call);
   4. Телефония (telephony).
6. Сохранить локальное приложение.

6. После сохранения обратите внимание на значения «Код приложения (client id)» и «Ключ приложения (client secret)», а также на домен компании. Они понадобятся при регистрации компании в ecss-crm-server.

При повторной необходимости посмотреть информацию о локальном приложении можно в разделе Интеграции

Регистрация приложения в ecss-crm-server

1. Для первого входа в приложение необходимо нажать на кнопку дополнительные параметры и указать параметры «Код приложения (client id)», «Ключ приложения (client secret)» и домен компании. Домен компании можно увидеть в URL Битрикс24 (https://b24-9n8jka.bitrix24.ru/crm/deal/kanban/)

2. В полях ввода укажите «Идентификатор клиента», что соответствует параметру «Код приложения» в интерфейсе Битрикс24, и «Секретный ключ», что соответствует параметру «Ключ приложения» в интерфейсе Битрикс24 (см. раздел Ручная установка приложения в облачной версии Битрикс24). Указание этих дополнительных параметров обязательно только на этапе регистрации. В дальнейшем при входе нужно указывать только домен компании Битрикс24.

3. Нажмите кнопку Вход, браузер будет переадресован на страницу авторизации Битрикс24.

После успешного прохождения авторизации, вы попадёте в интерфейс настройки компании ecss-crm-server.

Настройка компании в интерфейсе ecss-crm-server

1. В настройках компании присутствует возможность опционально задать имя компании.

2. Укажите настройки подключения к ECSS-10, полученные у вашего провайдера телефонии.

3. Если вы являетесь администратором SMG, то вам необходимо скопировать данные из созданного ключа в пункте 1.2.2:

4. Введите необходимые значения «API Key» и «Client id». Каждому значению соответствует указанное значение в приложении Битрикс24:

• «Идентификатор клиента» --> «ID клиента»
• «Ключ API» --> «Ключ»
• «Адрес Call API» --> настроенный в пункте 1.2.1 интерфейс для событий вызова «https://<IP:port>»
• «Домен» --> «api/v1»

5. Перейдите на вкладку «Настройки подключения к Битрикс24».

6. На данной вкладке отображается индикатор жизни OAuth2.0 токена (токен продлевается автоматически).

7. Для настройки номеров телефонов пользователей нажмите на кнопку пользователи.

8. В появившемся диалоговом окне можно настроить номера телефонов пользователей. Измененный список номеров сохраняется автоматически при закрытии диалогового окна. При поступлении вызова коннектор на основании данного списка определяет, какому пользователю необходимо показать карточку звонка в интерфейсе Битрикс24.

При регистрации компании в ecss-crm-server список пользователей выгружается из аккаунта Битрикс24. Сервер ecss-crm-server использует номера, указанные в профиле пользователя как «внутренний номер».

При добавлении нового пользователя в аккаунте компании Битрикс24 он будет учтен ecss-crm-server при открытии списка пользователей либо при перезапуске сервера ecss-crm-server.

Активация click 2 call

Для включения click 2 call необходимо:

1. В интерфейсе компании в Битрикс24 в поиске наберите «Телефония» и нажмите на пункт меню Телефония.

2. В открывшемся меню нажмите на вкладку Настройка телефонии и выберите пункт Пользователи телефонии.

3. Перейдите в настройке пользователя телефонии.

4. Выберите в поле «номер для исходящего звонка» созданное приложение.

Управление вызовами в интерфейсе Битрикс24

После корректной настройки:

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

Интерфейс карточки:

• Левая часть — стандартный интерфейс Битрикс24
• Правая часть — управление вызовом (ECSS)

Доступные действия:

• Принять вызов
• Отклонить вызов