Integration of the Alvis-GW-2E1 Gateways and the amoCRM CRM System

From GarantPlus Alvis Wiki
Jump to: navigation, search

Предисловие

Сегодня использование CRM (системы управления взаимоотношениями с клиентами) позволяет ускорить обработку входящих вызовов,

грамотно обслуживать ваших клиентов, и следить за качеством переговоров.

Существует несколько хорошо зарекомендовавших себя популярных CRM систем, рассмотрим самую быстро развивающуюся из них - amoCRM.


AmoCRM.png

Описание Задачи

Предположим, что в офисе находится УПАТС Panasonic TDA100, которая подключена к провайдеру по Е1.

Зарегистрирована учетная запись в системе amoCRM

Scheme with amoCRM.jpg

Необходимо: Передать имя имя контакта от amoCRM при входящем вызове со стороны провайдера

В данной статье мы будем использовать шлюз Alvis-GW-2E1-D(R1) для решения поставленной задачи.Предположим следующее:

  • Отсутствуют проблемы с взаимодействием по сети между amoCRM и Alvis
  • Alvis уже подключен по E1 (Li#1) к TDA
  • В TDA настроена внутренняя нумерация 1XX (101,102 и тп.)

Процесс подключения alvis к TDA 100 подробно рассмотрен в статье Подключение к УПАТС Panasonic TDA/TDE

Настройка со стороны amoCRM

1. Создание карточки контакта

Необходимо создать карточку с контактными данными, для этого нужно создать компанию и добавить в нее сотрудника

Contact amoCRM.png

2. Использование API-ключа

Пройдите в настройки, далее API и скопируйте Ваш ключ

API amoCRM.png

3. Проверка отдачи имени абонента в браузере

Предварительно перед запросом, нужно авторизоваться в amoCRM

Вид строки запроса: https://your.amocrm.ru/private/acceptors/asterisk_new/?number=номер_контакта\&USER_LOGIN=Ваш_email_для_авторизации\&USER_HASH=ваш_API_ключ

Образец данной строки: https://new5829967732c96.amocrm.ru/private/acceptors/asterisk_new/?number=593060\&[email protected]\&USER_HASH=509db07cf66e977222589a8fb2ab5570

При использовании карточки в пункте 1 должно появиться имя Гарант Плюс Виталий

Настройка со стороны Alvis

1. Проверка версии ПО

Обновите ПО на Alvis с использованием web интерфейса или через командную строку

Проверьте установленные пакеты - введите в командной строке rpm -qa | grep curl

Должен появится следующий список:

  • libcurl
  • asterisk16-curl
  • curl

Если по какой то причине данное ПО не было установлено на Ваш шлюз, то необходимо вручную установить эти пакеты

Для этого введите следующие команды: apt-get update && apt-get install libcurl asterisk16-curl curl && sync

2. Проверка отдачи имени абонента через консоль

Введите следующую команду:

curl -k https://your.amocrm.ru/private/acceptors/asterisk_new/?number=номер_контакта\&USER_LOGIN=Ваша_учетная_запись\&USER_HASH=ваш_API_ключ

При использовании карточки в нашем примере, появится имя Гарант Плюс Виталий

Если имя не отображается, нужно проверить настройки сети, в особенности прохождение запросов https

3. Изменение диалплана в web интерфейсе

Пройдите в Alvis Gateway, далее в раздел Routing

Добавьте строку как примере

Routing amoCRM.png

Для добавления нужного нам функционала, пропишем дополнительные строчки в поле Advanced и в разделе Pre commands:

Set(URL=https://your.amocrm.ru/private/acceptors/asterisk_new/?number=${CALLERID(num)}\&USER_LOGIN=Ваша_учетная_запись\&USER_HASH=ваш_API_ключ)

Set(CMD=curl -k ${URL})

Set(RESULT=${SHELL(${CMD}):0:-3})

Set(CALLERID(name)=${RESULT})

Сохраняем сделанные нами изменения

Проверяем и видим в консоли астериска следующее:

Set("SIP/593060-00000000", "RESULT=Гарант Плюс Виталий") in new stack

Set("SIP/593060-00000000", "CALLERID(name)=Гарант Плюс Виталий") in new stack

Настройка завершена

Удачи в интеграциях