Описание файла конфигурации

В данном разделе приведено описание настройки файла конфигурации для редактирования его в ручном режиме.

Путь по умолчанию для Битрикс24: /etc/bx24asterisk/config.json

Для пользоватлей AmoCRM: /etc/itgrix_amo/config.json

После ручного редактирования, убедитесь в валидности json файла (например через сервис https://jsonlint.com/).

Для применения настроек перезапустите модуль:

# systemctl restart bx24asterisk # systemctl restart itgrix_amo

либо

# service bx24asterisk stop # service itgrix_amo stop # service bx24asterisk start # service itgrix_amo start

Для изменения настроек через веб-интерфейс (админку), перегружаться не нужно. Сохраняться нужно на каждой странице админки https://<ipasterisk>:8078/config

App - раздел настроек работы приложения

Создавать сущности (лиды, контакты) для входящих /исходящих разговоров (Начиная с версии 2.15.0)

"create_entity_for_incoming": true, "create_entity_for_outgoing": true,

true - лиды/контакты создаваться будут, false - лиды/контакты создаваться не будут Параметры создания сущности могут быть кастомизированы.

Создавать новые дела для каждого переведенного вызова

"create_new_activity_at_transfer": true

true - после каждого перевода вызова будет создаваться новое дело с ответственным сотрудником, на которого переведен вызов. false - будет создано одно дело для всего разговора со всеми переводами, ответственным за это дело будет последний говоривший сотрудник.

Создание задачи по пропущенному

"create_task_for_unanswered": false,

true - при пропущенном звонке будет создаваться задача. Параметры могут быть кастомизированы (см. раздел task creation params). false - задача создаваться не будет.

Таймаут ожидания ответа от скриптов кастомизации, мс (рекомендуемое значение 10000)

"customization_time_msec": 10000

Путь до скрипта кастомизации этом файле возможно переопределять настройки приложения)

"customizer_program_path": "/opt/bx24asterisk/customizer.php"

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

chmod +x /opt/bx24asterisk/customizer.php

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

Включение дополнительных возможностей кастомизации (методы, начиная с версии 2.15.0)

"customize_activity" - дела после завершения звонка, "customize_entity" - сущности (лида, контакта), после завершения звонка, "customize_final_params" - параметров завершения звонка, "customize_registration_params" - параметров регистрации разговора, "customize_task" - задачи после пропущенного звонка,

Подробнее про кастомизации можно узнать из раздела Полезные кастомизации.

Суффикс для папки с временными файлами token и state (используется для запуска нескольких экземпляров приложения на одном сервере)

"generated_postfix": ""

Дата и время, начиная с которых загружаются события о разговорах (рекомендуемое значение - дата и время установки модуля)

"history_start_date": "2018-01-15 10:30:00"

Уровень логирования:

"log_level": "debug"

debug - фиксируем все события в логе; info - фиксирует всё, кроме отладочной информации; warning - фиксируем только исключительные ситуации, критические ошибки; critical - фиксируем только критические ошибки; fatal - фатальные ошибки. При нормальной работе ничего не выводится.

Отправлять информацию о новых лидах в бизнес-чат

"post_lead_info_to_chat": false

true - информация будет отправляться в бизнес-чат Битрикса. В нем можно также дополнительно настроить будет это отдельные чаты по каждому клиенту, либо один общий чат для всех совершенных звонков. false - информация отправлена не будет.

Префиксы

"prefixes": [ "7", "8", "+7" ]

Загружать файлы записей разговора в CRM или они будут прослушиваться с локального сервера (по ссылке)

"store_recordings_in_crm": true

true - записи будут выгружаться в Битрикс. false - в Битриксе будут только ссылки на записи.

У нас реализовано 2 способа прослушивания разговоров на портале:

1) Выгрузка записей при создании дела. При этом варианте запись отдаем в битрикс, указывая к какому делу она принадлежит. Минусы этого способа - все пользователи портали смогут прослушивать все записи, тратится место портала.

Важно: перед отправкой файла его нужно сконвертировать в mp3. Как это сделать, можно прочитать в Статье базы данных.

2) К делу прикрепляем плеер, который получает запись на стороне астериск. Есть нюанс, для случаев, когда сервер с записями находится за NAT, ссылка на получение аудиозаписи будет указана либо на внешний адрес, либо на внутренний. Соответственно запись будет доступна либо тем, кто запрашивает ее извне, либо только тем, кто находится в одной сети с сервером. Если необходимо прослушивание записей извне, то необходимо открыть порт 8077 на маршрутизаторе, и в переменной Адрес для локальных сервисов “address_int” указать внешний ip.

Сопоставление внешних номеров телефона с источниками вызова в CRM

"trunk_to_source": { "2723033": "WEB", "4993508890": "CALL" }

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

Транки можно узнать следующими :

  • в БД asterisk в таблице trunks (номера в столбце outcid).

  • в файле /etc/asterisk/extensions_additional.conf (в FreePBX extensions_additional.conf). Выполнив команду: grep ^OUTCID /etc/asterisk/extensions{,_additional}.conf

  • Самое надежное выполнить команду в базе данных CEL: select distinct exten from cel where uniqueid=linkedid and eventtype='CHAN_START' and length(cid_num)>4 and length(exten)>4;

Asterisk - Раздел настроек подключения к Asterisk

Настройки подключения к AMI

"host": "127.0.0.1" "port": 5038 "user": "bx24" "password": "bx24secret"

Настройки инициации вызова в Asterisk

"originate": { "caller_id": "Звонок на #TO# <#TO#>", "channel": "SIP/#FROM#", (Вместо SIP можно указывать любой другой протокол IAX2, PJSIP) "context": "from-internal", "extension": "#TO#", "priority": "1" }

Про параметры originate в Asterisk можно прочитать здесь http://asterisk.ru/knowledgebase/Asterisk+Manager+API+Action+Originate

Codecs и variable добавляется в кастомизаторе

//$params['codecs'] = 'someCodecName'; //$params['variable'] = 'SIPADDHEADER="Call-Info:\;answer-after=0"';

Путь до файлов с записями разговоров

"recordings_dir": "/var/spool/asterisk/monitor"

Файлы с записями хранятся в поддиректориях согласно дате разговора

"recordings_dir_subdirs_by_date": true

Комбинация для совершения перехвата вызова (указывается настроенная на Астериск комбинация для распознавания перехвата)

"pickup_code": *8

Bitrix - раздел настроек подключения к Битрикс24

Путь до портала Битрикс24. "host": "https://portal.bitrix24.ru",

Будьте внимательны. Если у вас коробочный 1С-Битрикс24 с протоколом http, здесь должен быть указан http://, обычно используется https://, в том числе для облачных порталов.

ID пользователя портала Битрикс24, назначенного ответственным за пропущенные звонки с неизвестных номеров и за новые лиды

"user_id": 1

Этот пользователь является первым ответственным за созданную сущность. Когда ответит другой пользователь, то ответственный сменится на ответившего пользователя. Если никто не ответит, то за сущность останется ответственным этот пользователь по-умолчанию. Он может отличаться от пользователя, под которым работает модуль.

Логин и пароль администратора в Битрикс24 .

"user_login": "login", "user_password": "password"

Использование внешних линий при регистрации звонков в Битрикс24

"use_external_lines": "true"

Database - раздел подключения к MySQL

Параметры подключения к MySQL (настраивали в разделе 2.2.1). Название БД должно быть в соответствие с настройкой системы.

"database": "asteriskcdrdb", "host": "127.0.0.1", "user": "freepbxuser" "password": "mysqlsecret", "port": 3306,

Названия таблиц и полей в MySQL (для типовых случаев оставляем значения по-умолчанию)

"column_name_aliases": { "cdr_calldate": "calldate", "cdr_cnum": "cnum", "cdr_recordingfile": "recordingfile", "cdr_src": "src", "cdr_uniqueid": "uniqueid", "cel_channame": "channame", "cel_cid_num": "cid_num", "cel_eventtime": "eventtime", "cel_eventtype": "eventtype", "cel_exten": "exten", "cel_id": "id", "cel_linkedid": "linkedid", "cel_uniqueid": "uniqueid" } "table_name_aliases": { "cdr": "cdr", "cel": "cel" }

В большинстве конфигураций поля в MySQL выглядят именно так. При необходимости, проверить можно SQL-запросом describe *имя_таблицы*.

WebServer - Настройки встроенного в модуль ВЕБ-сервера

Адрес и порт, на которых запускается WEB-сервер (по-умолчанию адрес - 0.0.0.0 порт 8077, 8078)

“listen_host”: “0.0.0.0” “listen_port”: http“8077” “listen_port_secure”: “8078”

Для доступа в админку наберите ip адрес сервера с Астериск (куда установлен модуль) и порт. Для админки используется только https (по умолчанию порт 8078). При входе по 8077 стоит редирект.

Адрес, по которому приложение будет доступно для внешних сервисов “address_ext” : “1.1.1.1”

Адрес необходим для исполнения функции click-to-call из облачного Битрикс24, внешнего по отношению к сети компании. Нужен внешний ip компании.

Адрес для локальных сервисов “address_int” : “192.168.0.1 Адрес, необходимый для формирования ссылки на получение записи разговора в деле. Рекомендуем указать: внутренний адрес сервера с модулем. Протокол и порт указывать не нужно. Они добавляются автоматически.

Логин и пароль для доступа в админку

"user": "user_name" "password": "secret_password"

Данные для браузерного расширения (пока не используются)

"sockets_port": 8089

Флаг для отключения http

"use_http": true (по умолчанию)

Значение true - позволяет использовать http протокол для следующих запросов:

  • запрос записи,

  • автораспределение,

  • click_to_call

  • callback обработчики.

false - используется только https для всех запросов.

Для доступа в админку используется только https (по умолчанию порт 8078).