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

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

Info

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

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

  • IP-АТС серии S серии (S20, S50, S100, S300).
  • Статический IP адрес (необходимо приобрести у вашего интернет-провайдера).

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

Info

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

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

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

Интеграция имеет возможность получить запись разговора с IP-АТС по FTP (для IP-АТС Yeastar S20) или API (для IP-АТС Yeastar S50/S100/S300) в зависимости от настроек интеграции и самой IP-АТС.

Интеграция взаимодействует с amoCRM по API: отправляет запросы на проверку номера телефона, создание сущностей в amoCRM и проброс ссылки на запись разговора.

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

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

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

settings-yeastar

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

для Yeastar S20

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

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. Настройка интеграции в личном кабинете сервиса Callbee

В личном кабинете сервиса Callbee для интеграции с amoCRM необходимо:

  • Во вкладке Integration нажить на кнопку Install integration и выбрать вкладку AMOCRM WITH YEASTAR либо нажать кнопку Install на блоке с типом интеграции AMOCRM WITH YEASTAR
  • Заполнить все необходимые пункты для интеграции

install integration install integration

  • В поле amoCRM Domain обязательно необходимо внести ваш домен amoCRM (например, callbee.amocrm.ru без https://)
  • amoCRM TOKEN - Токен для соединения с AmoCRM, этот токен необходимо будет вставить в интеграцию на стороне AmoCRM (токен должен быть из 12 символов, правее есть кнопка генерации токена). Настройка интеграции на стороне AmoCRM описана далее
  • Google Chrome TOKEN - Токен для соединения с расширением в браузере Google Chrome, этот токен необходимо будет вставить в параметрах расширения (токен должен быть из 12 символов, правее есть кнопка генерации токена). Настройка расширения описана далее
  • Asterisk AMI Host/Port/Username/Secret - Настройка подключения по AMI к ATC (IP-адрес сервера или доменное имя, порт, имя пользователя, пароль)
  • FTP или API

    FTP для Yeastar S20

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

    install integration

    API для Yeastar S50/S100/S300

    • API host - ваш статический IP адрес для подключения к API Yeastar
    • API port - ваш порт для подключения к API Yeastar
    • API username - имя пользователя к API Yeastar
    • API secret - пароль к API Yeastar
  • Google Drive - Подключение Google Drive к интеграции

    Нажимаем на Google Drive Connect install integration

    Заходим под своим аккаунтом Google, далее нажимаем Разрешить install integration

    Далее нажимаем Разрешить install integration

    Копируем код и вставляем в поле google drive code install integration

  • Convert to mp3 - конвертировать аудиозаписи в mp3

  • Ignore DID numbers - DID номер(а) через запятую на входящим маршруте (интеграция будет игнорировать эти входящие маршруты)
  • amoCRM user ID for missed calls - ID пользователя в amoCRM для пропущенных вызовов (ответственный пользователь за пропущенные вызовы для новых клиентов, которых нет в amoCRM, например)
  • Smart call - Включение умной маршрутизации (перевод звонка на ответственного сотрудника)
  • Unsorted during a phone call - Создание неразобранного в amoCRM в момент ответа на входящий звонок
  • Incoming call - При входящем звонке создавать Неразобранное, Контакт, Контакт + Сделка
  • Outgoing calls - При исходящем звонке создавать Неразобранное, Контакт, Контакт + Сделка
  • Save - Сохранение настроек

4. Подключение интеграции на стороне amoCRM

Внимание

  • Просим обратить особое внимание - название, логотипы могут отличаться от скриншотов данного руководства
  • Интеграция будет работать только для внутренних номеров, которые вы указали у сотрудников

settings-amocrm

  • В настройках amoCRM, выбрать пункт Интеграции, сверху в строке поиска ищем по названию Callbee, либо в разделе Телефония найти интеграцию Callbee (Asterisk и Yeastar), согласившись с условиями нажать на кнопку Установить
  • Далее необходимо прописать внутренние номера сотрудников. settings-amocrm
  • В поле Token Уникальный токен, необходимо скопировать из пункта AMOCRM TOKEN из настроек вашей интеграции в личном кабинете
  • Сохранить настройки.
  • В личном кабинете сервиса Callbee после всех настроек на стороне amoCRM необходимо перезагрузить интеграцию.

5. Подключение и настройка расширения в браузере Google Chrome

Расширение Callbee в google chrome используется для оповещения сотрудника о поступающих вызовах.

Установка:

  • В магазине google chrome находим расширение Callbee и устанавливаем его.
  • Либо перейти по ссылке и установить.

Настройка: settings-google-chrome

  • New version - Отметить пункт (обязательно).
  • Click on the card to open a new tab in the browser - Переход в карточку контакта по клику всплывающей карточки в новой вкладке браузера, по необходимости.
  • Extension number - Внутренний номер телефона сотрудника.
  • Server or token - Уникальный токен, необходимо скопировать из пункта GOOGLE CHROME EXTENSION TOKEN из настроек вашей интеграции в личном кабинете.
  • Сохраняем настройки.

Статус расширения:

google-chrome-extension-on

ON - работает умная маршрутизация, отображаются оповещения

google-chrome-extension-on

OFF - отключены все оповещения, не работает умная маршрутизация

На данном этапе настройка считается выполненной.