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

Настройка интеграции Asterisk + FreePBX c amoCRM при помощи сервиса Callbee

Info

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

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

Asterisk + FreePBX далее АТС

  • Asterisk не старше версии 13.*.*
  • FreePBX не старше версии 13.*.*
  • Статический IP адрес (необходимо приобрести у вашего интернет-провайдера) для прямого доступа к АТС из сети Интернет

Интеграция осуществляется при помощи подключения облачного сервиса Callbee к АТС при помощи Asterisk Managment Interface (AMI) посредством TCP протокола. AMI принимает подключения, устанавливаемые на сетевой порт (по умолчанию - TCP порт 5038)

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

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

  • внешний порт (например 35038) на порт 5038 TCP - для доступа к АТС по AMI (Замечание по безопасности! Рекомендуем открывать порт разрешив подключение с IP адресов указанных в списке)
  • внешний порт (например 38080) на порт 80 TCP (стандартный порт веб - сервера АТС) - для выгрузки записей разговоров

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

Настройка Asterisk + FreePBX

Info

  • Внутренние номера (Extensions) могут быть трехзначными или четырехзначными (222 или 2222).
  • На всех входящих маршрутах(Inbound Routes) ожидаемый входящий номер DID должен быть не менее 5 цифр, это может быть номер линии в международном формате (например: +375291111111).
  • На всех входящих (Inbound Routes) и исходящих маршрутах (Outbound Routes) обязательно должны быть включены записи разговоров.
  • Сервис Callbee не изменят входящий номер телефона. Входящий номер телефона будет проброшен в amoCRM том виде в каком он поступил на АТС.(Рекомендуется средствами АТС приводить все входящие номера телефонов к единому международному формату).
  • При звонке по клику из amoCRM на АТС поступает номер телефона записанный из карточки сущности amoCRM. Необходимо чтобы АТС умела набирать этот номер (в этом формате) в линию.
  • Для корректной работы интеграции мы рекомендуем настройки на АТС, которые не указаны в данной инструкции, оставить по умолчанию.
  • Интеграция не гарантирует корректную работу функций при использовании модуля FreePBX Ring Groups для настройки распределения входящих вызовов в АТС. Для корректной работы всех функций интеграции рекомендуем вместо Ring Groups использовать Queues

Настройка AMI Asterisk

Для подключения к AMI Asterisk нужно создать AMI пользователя на стороне Asterisk. Это можно сделать двумя способами:

  • Способ 1 через CLI:

    В файле /etc/asterisk/manager_custom.conf добавить, например:

    [callbee] 
    secret=password
    deny=0.0.0.0/0.0.0.0 
    permit=127.0.0.1/255.255.255.0
    permit=89.108.65.246/255.255.255.255
    permit=31.24.92.54/255.255.255.255
    read=system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate,message
    write=system,call,log,verbose,command,agent,user,config,command,dtmf,reporting,cdr,dialplan,originate,message
    writetimeout = 500
    

    После чего выполнить команду

    asterisk -rx "manager reload"
    
    Конец действия

  • Способ 2 через интерфейс FreePBX:

    1. Должен быть установлен модуль Asterisk API
    2. В пункте меню Settings -> Asterisk Manager Users(1) -> Add Manager(2) settings-asterisk-1
    3. Во вкладке General заполнить поля как на примере settings-asterisk-2
    4. Во вкладке Permissions установить все переключатели в положение Yes settings-asterisk-3

Настройка транков (Trunks) в FreePBX

Важное замечание

  • На данный момент интреграция работает только с chan_SIP транками
  • Поле Outbound CallerID

Пример стандартной настройки settings-asterisk-4

Настройка Входящей маршрутизации (Inbound Routes) в FreePBX

Пример стандартной настройки settings-asterisk-4

Для работы умной маршрутизации необходимо успеть получить ответ от CRM на запрос наличия существующего контакта с определившимся номером телефона. Для этого необходимо выставить задержку на маршрутах Advanced -> Pause Before Answer (например 1 сек),

С ростом базы контактов в amoCRM возможно задержку необходимо увеличить на 1-2 секунды. settings-asterisk-5

Для получения записей разговоров в CRM включаем записи разговоров на маршрутах Other -> Call Recording -> Yes settings-asterisk-6

Настройка Исходящей маршрутизации (Outbound Routes) в FreePBX

Важное замечание

Поле Route CID должно быть пустым

Пример стандартной настройки settings-asterisk-4

Для записи разговоров при исходящих вызовах на вкладке Additional Settings включаем записи разговоров settings-asterisk-4

Настройка Внутренних номеров (Extensions) в FreePBX

Пример настройки внутреннего номера 222:

  • Есть поддержка драйвера PJSIP и CHAN_SIP для внутренних номеров
  • Outbound CID оставить по умолчанию settings-asterisk-7
  • настройку записей разговоров оставить по умолчанию (записи записываются на маршрутах) settings-asterisk-8

Подключение интеграции на стороне сервиса Callbee

Info

После проведения всех настроек описанных выше необходимо произвести подключение сервиса к Asterisk через AMI пользователя, которого мы создали ранее (см. Выше)

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

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

settings-asterisk-8

  • В поле amoCRM Domain обязательно необходимо внести ваш домен amoCRM (например, callbee.amocrm.ru без https://)
  • amoCRM TOKEN - Токен для соединения с AmoCRM, этот токен необходимо будет вставить в соответствующее поле в виджете на стороне AmoCRM (токен должен быть из 12 символов, правее есть кнопка генерации токена – нажмите ее для создания токена). Настройка интеграции на стороне AmoCRM описана далее
  • Google Chrome TOKEN - Токен для соединения с расширением в браузере Google Chrome, этот токен необходимо будет вставить в параметрах расширения (токен должен быть из 12 символов, правее есть кнопка генерации токена – нажмите ее для создания токена). Настройка расширения описана [далее]#google-chrome
  • Asterisk AMI Host/Port/Username/Secret - Настройка подключения по AMI к ATC (IP-адрес сервера или доменное имя, порт, имя пользователя, пароль)
  • Record URL - Ссылка для записей разговоров. По данной ссылке amoCRM будет пытаться получить доступ к записи разговора, в момент попытки прослушивания записи из amoCRM. Ссылка должна быть всегда доступна.
  • Ignore lines(DID) numbers - DID номер(а) через запятую на входящим маршруте. Эта функция позволяет не реагировать на номера, не относящиеся к работе в CRM. например прямые номера бухгалтерии или администрации. Интеграция будет игнорировать эти входящие маршруты.
  • Outgoing calls (all lines) - Данная настройка позволяет выбрать какую сущность создавать при исходящем вызове НОВОМУ клиенту. Неразобранное, Контакт, Контакт + Сделка

Info

Далее указываются настройки для линии (DID). В стандартной версии настройки применяются ко всем линиям по умолчанию. В Pro версии есть возможность устанавливать настройки для каждой линии индивидуально.

  • Line (DID) - Номер подразделения отдела; номер для входящих звонков, который относится к подразделению/отделу (номер берется из настроек FreePBX поля DID Number и доступно для редактирования только в Pro версии) settings-asterisk-4
  • Description - Описание линии (DID) будет заполнять поле Линия в карточке Контакта и Сделки в amoCRM, если оставить поле Description пустым, будет проброшен номер линии (DID) (доступно для редактирования только в Pro версии)
  • amoCRM pepline - Воронка в amoCRM. На момент создания интеграции по умолчанию выбирается основная воронка (Main), т.к. еще нет связи интеграции и amoCRM. Далее при корректном подключении интеграции при редактировании можно будет указать необходимую воронку из имеющихся #pepline
  • amoCRM user ID for missed calls - ID пользователя в amoCRM для пропущенных вызовов (ответственный пользователь за пропущенные вызовы для новых клиентов, которых нет в amoCRM). Можно устанавливать для каждой линии свое значение.
  • Smart call (by time) - Включение умной маршрутизации (перевод звонка на ответственного сотрудника) с указанием времени работы. Вне графика работы умной маршрутизации звонок будет идти по маршруту по умолчанию. Чаще всего применяется для того, чтобы проиграть клиенту сообщение о том, что он дозвонился в нерабочее время.
  • Incoming call - Настройка позволяет выбрать какую сущность создавать при входящем звонке от НОВОГО клиента Неразобранное, Контакт, Контакт + Сделка
  • Unsorted during a phone call - Создание неразобранного в amoCRM в момент ответа на входящий звонок. Данная настройка сделана для удобства работы с Неразобранным при входящих звонках. Данная настройка позволяет создать неразобранное в начале звонка без записи разговора, для возможности начала работы с данной сделкой (принятие, заполнение полей). При завершении разговора в эту карточку Неразобранного или Сделки пробросится разговор.
  • Repeat sales mode - Настройка автоматической регистрации повторных сделок. Данная настройка позволяет создавать повторные сделки с существующими клиентами, если в момент входящего звонка от существующего клиента с ним нет ни одной активной сделки. При повторном обращении клиента в Сделке__в поле __Повторное обращение будет указано значение Повторное. Если данная настройка отключена, поле Повторное обращение можно скрыть. Поле заполняется для аналитики и для возможности отображение в карточке в воронке для визуального различия в новыми сделками.
  • Нажать кнопку Save и дождаться завершения подключения

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

Внимание

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

settings-amocrm

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

Подключение и настройка расширения в браузере Google Chrome #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 из настроек вашей интеграции в личном кабинете Callbee (#google-chrome)
  • Сохраняем настройки.

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

google-chrome-extension-on

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

google-chrome-extension-on

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

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

При возникновении вопросов обращайтесь за помощью в службу поддержки Callbee. Контакты указаны в Личном кабинете сервиса Callbee.io