Перейти к содержанию

Настройка интеграции IP-АТС Yeastar S серии с Битрикс24 при помощи сервиса Callbee

Info

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

Необходимые требования

  • IP-АТС серии S серии (S20, S50, S100, S300).
  • Статический IP адрес (необходимо приобрести у вашего интернет-провайдера).
  • Облачный или коробочный Битрикс24 любой редакции.
  • Для коробочного Битрикс24 необходим валидный SSL сертификат.

Важные замечания

  • Интеграция поддерживает внутренние номера до 4-х знаков включительно.
  • Интеграция не преобразует формат телефонных номеров, необходимо работать в международном формате как в Битрикс24, так и на АТС.

Работа интеграции

Интеграция реализует связь по AMI протоколу с вашей IP-АТС Yeastar S серии и REST API вашего Битрикс24, а также осуществляет на стороне нашего сервера конвертацию файлов аудиозаписей разговоров из формата wav (записи разговоров создаются на IP-АТС Yeastar только в формате wav) в формат mp3.

Важно понимать, что голосовой SIP трафик за рамки вашей АТС никуда не выходит.

Интеграция взаимодействует с Битрикс24 по REST API: отправляет запросы на поднятие карточки звонка, проверку номера телефона и проброс записи разговора с АТС.

1. Настройка IP-АТС Yeastar

1.1 Настройка сетевых служб

Открываем админ панель АТС и переходим в раздел Настройки - Система – Безопасность далее переходим во вкладку Сетевые службы и настраиваем следующее:

для Yeastar S20

  • Активируем пункт Включить FTP
  • Активируем пункт Включить TFTP

для Yeastar S50/S100/S300

  • Меняем протокол с HTTPS на HTTP

Смену протокола следует производить если не установлен валидный сертификат

  • Активируем пункт Включить AMI
  • Изменяем стандартные Имя пользователя и Пароль (эти имя пользователя и пароль нужно будет прописать в личном кабинете Callbee)
  • В появившемся поле Разрешённые IP/Маска прописываем IP адрес 89.108.65.246 и маску 255.255.255.255

settings-yeastar

1.2 Настройка хранилища данных

для Yeastar S20

Переходим в раздел Настройки - Система - Хранилища данных и переходим во вкладку File Share:

  • Активируем Активировать FTP доступ
  • Активируем Активировать файловое хранилище

FTP

1.3 Настройка API

для Yeastar S50/S100/S300

Переходим в раздел Настройки АТС - Настройки АТС - API:

  • Активируем API
  • Активируем пункт Монитор АТС всех номеров и линий

API

2. Сетевые настройки

Для того, чтобы интеграция могла подключится к вашей АТС, у вас обязательно должен быть статический IP адрес и проброшены через NAT к АТС следующие порты:

  • 5038 TCP – для доступа к AMI Yeastar
  • 21 TCP – для доступа к FTP Yeastar (для Yeastar S20)
  • 8088 (порт к WEB интерфейсу по умолчанию) HTTP/HTTPS – для доступа к API Yeastar

Info

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

3. Первичная настройка Битрикс24

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

Войдите в свой корпоративный портал Битрикс24 пользователем с правами администратора.

  • В меню Битрикс24 перейдите на страницу Приложения выберите категорию IP-телефони и найдите приложение Callbee
  • Перейдите на страницу приложения Callbee и нажмите кнопку Установить
  • Далее необходимо ознакомиться и согласиться с лицензионным соглашением и политикой конфиденциальности, отметив эти пункты, и нажать кнопку УСТАНОВИТЬ

Сallbee в каталоге приложений Битрикс24

3.2 Настройка внутренних номеров пользователей

  • Перейти на страницу Сотрудники
  • Открыть профиль Сотрудника
  • Внести внутренний телефон сотрудника

bitrix24-extension

4. Настройка интеграции в личном кабинете сервиса Callbee

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

install integration install integration

Описание пунктов настроек

  • (1) Нажать на кнопку Install integrations
  • (2) Выбрать вкладку BITRIX24 WITH YEASTAR
  • (3) Доменное имя вашего Битрикс24 (без https://, например: callbee.bitrix24.ru)
  • (4) AMI host - ваш статический IP адрес для подключения к AMI Yeastar
  • (5) AMI port - ваш порт для подключения к AMI Yeastar (стандартный порт AMI 5038)
  • (6) AMI username - имя пользователя AMI Yeastar
  • (7) AMI secret - пароль AMI Yeastar
  • (8) FTP (для Yeastar S20) / API (для Yeastar S50/S100/S300)
  • (9) Конвертация записи в mp3

для Yeastar S20

  • (10) FTP host - ваш статический IP адрес для подключения к FTP Yeastar
  • (11) FTP port - ваш порт для подключения к FTP Yeastar (стандартный порт FTP 21)
  • (12) FTP username - имя пользователя к FTP Yeastar
  • (13) FTP secret - пароль к FTP Yeastar
  • (14) Path records directory - если оставить поле пустым, будет использоваться стандартный путь для хранении файлов записей разговоров /ftp_media mmc/autorecords/

для Yeastar S50/S100/S300

  • (10) API host - ваш статический IP адрес для подключения к API Yeastar
  • (11) API port - ваш порт для подключения к API Yeastar
  • (12) API username - имя пользователя к API Yeastar
  • (13) API secret - пароль к API Yeastar
  • (15) Ignore trunks - DID номер(а) через запятую на входящим маршруте (интеграция будет игнорировать эти входящие маршруты)
  • (16) ID пользователя в Битрикс24 для пропущенных вызовов (ответственный пользователь за пропущенные вызовы для новых клиентов, которых нет в Битрикс24)
  • (17) Smart call - Включение умной маршрутизации (распределение вызова на ответственного пользователя)
  • (18) Auto lead - Автоматически создает в Битрикс24 лид или сделку, в зависимости от настроек и режима работы CRM.
  • (19) Add to chat - Сообщение о совершенном звонке сотруднику Битрикс24 в чат.
  • (20) Save* - Сохранение настроек

Note

  • Перед сохранением всех настроек при первом подключении интеграции необходимо в соседней вкладке вашего браузера войти в Битрикс24 с правами администратора.

5. Дальнейшая настройка Битрикс24

5.1 Настройка телефонии в Битрикс24

  • Перейти на страницу Телефония в Битрикс24
  • Выбрать Общие настройки в выпадающем меню Настройка телефонии settings bitrix24
  • В настройке номера по умолчанию в пункте Номер для исходящего звонка по умолчанию выбрать Приложение: Callbee settings bitrix24
  • Обязательно, далее нажимаем Сохранить