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

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

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

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

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

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

• Убедиться, что API-сервер включен;
• Настроен интерфейс событий вызова;
• Включен режим TLS.

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. В графе "Настройка прав" выбрать:
   • Встраивание приложений (placement);
   • Пользователи (user);
   • Телефония (совершение звонков) (call);
   • Телефония (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". На вкладке отображается индикатор жизни 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).

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

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