Itgrix База знаний
Asterisk-коннекторСтоимостьЛицензионное соглашениеКонтакты
  • Что такое Itgrix?
  • Наша история
  • Наши контакты
  • Блог
    • БД Itgrix
    • AsterPhone в Битрикс24
    • AsterPhone в AmoCRM
    • Настройка WebRTC в Asterisk (FreePBX)
    • Привязка звонка к сделке в Call Card в Bitrix24
    • Конвертация записи звонка в mp3
  • Установка модуля
    • Требования к системе
    • Установка модуля интеграции Битрикс24 и Asterisk
      • Особенности настройки ограниченного режима
      • Настройка модуля для работы в закрытой сети
        • Особенности настройки click-to-call в коробочной версии 1С-Битрикс24 в закрытой сети
        • Как выполнить авторизацию оффлайн
        • Как получить лицензию оффлайн
    • Установка модуля интеграции AmoCRM и Asterisk
      • Особенности настройки ограниченного режима
      • Карточка звонка в amoCRM
  • Настройка функций модуля
    • Автораспределение звонка на ответственного менеджера
      • Передача номера транка и названия сущности при входящем звонке в CallerID
      • Как найти нужный дефолтный контекст
      • Автораспределение с учетом рабочего времени
      • Автораспределение в версии до 3.0.0
    • Настройка функций click-to-call
      • Особенности настройки после обновления Битрикс24 23.300.0
    • Тест-кейсы для проверки работы интеграции
      • Битрикс24
      • amoCRM
    • Доп функции
      • Сквозная аналитика Битрикс24 через Itgrix
      • Автоматическое поднятие трубки при звонках кликом из CRM
      • Распознавание FMC номеров
      • Выбор ответственного за пропущенный и за транк
      • Настройка задачи по пропущенному через админку
      • Автоматическое управление задачами по пропущенному звонку
  • Полезные кастомизации (любая CRM)
    • Обновление настроек кастомизатора в Itgrix_bx-3.9.0 и Itgrix_amo-2.12.0
    • Обновление кастомизатора в Itgrix_bx-3.4.0 и Itgrix_amo-2.6.0
    • Включение кастомизатора
    • Черные и белые списки. Как настроить?
    • Изменение номера клиента перед отправкой в CRM
    • Изменение параметров при click-to-call
    • PJSIP вместо chan_sip у избранных пользователей
    • Кастомизация имени файла аудиозаписи
    • Конвертация записей в формат MP3
    • Склеивание названия транка и имени контакта для показа в карточке звонка
    • Данные о звонке (call_full) в кастомизациях
    • Параметры звонка (call) и разговора (conversation) в кастомизациях
  • Полезные кастомизации itgrix_bx (Битрикс24)
    • Полезные кастомизации itgrix_bx (Битрикс24) [С историей]
    • Время ожидания ответа на звонок
    • Несколько внутренних номеров у сотрудника
    • Первый ответственный за новый лид/контакт
    • Добавление кода города в зависимости от города оператора
    • Убираем номера телефонов из названий сущностей
    • Разные ответственные по умолчанию за разные транки
    • Распределение ответственных по пропущенным звонкам
    • Кастомизация задач по пропущенным звонкам
    • Обновление полей сущности
    • Обновление полей дела
    • Длительность ожидания клиента на линии
    • Запросы в Битрикс из кастомизации
    • Кастомизации (для версий до 3.0)
    • Кастомизации (для версий до 2.15.0)
      • Более недоступный функционал
      • Кастомизация поиска
      • Обновление полей лида
      • Черно/белые списки для версии до 2.15.0
      • Изменения черных/белых списков в версии до 2.15.0
      • Новые возможности
    • Создавать лид для каждого входящего звонка
  • Полезные кастомизации itgrix_amo (amoCRM)
    • Обновление кастомизатора в версии Itgrix_amo 3.0.0
    • Добавление названия транка в тэг сделки
    • Добавление данных о звонке в тег новой сделки
    • Добавление тега при создании контакта/сделки
    • Запись номера транка через который пришел звонок в информацию о разговоре
    • Запросы в amoCRM из кастомизации
    • Добавление звонка в несколько сущностей
  • Как починить...
    • Прослушивание записи звонка в коробочной версии Битрикс24
    • Изменение статуса звонка, назначение ответственного за звонок, работа ч/б списков
    • Как починить click-to-call
    • Чиним прослушивание звонков
    • Amo. Ошибки о которых сообщает CRM
    • Свои SSL сертификаты для https запросов
    • Failed to fetch. ошибка на странице веб интерфейса модуля
    • Модуль опережает таблицу CEL на X записей
    • Авторизация модуля в Б24
    • Проблема с сертификатами Sectigo
    • Как включить загрузку смешанного контента в Firefox и Google Chrome 80
    • Если не регистрируется звонок переведенный на сотовый сотрудника (follow me)
    • Бесплатная лицензия или ограниченный режим.
    • Не всплывают уведомления о звонках в AMO
    • Не регистрируются звонки у определенного пользователя Битрикс24
    • Перестали регистрироваться события в CEL, перезагрузка модулей в Asterisk
    • Не работает CallTransfer
    • Не появляется карточка звонка в Б24 во время разговора
  • Для админов
    • Примеры структуры зарегистрированных звонков из CEL
    • Разворачивание бэкапа модуля
    • Полезные команды
    • Скрипт для проверки работы службы модуля
    • Изменение логина и пароля для входа в админку
    • Файлы модуля
    • Описание файла конфигурации (версия 3)
      • Описание файла конфигурации (до версии 3.0)
      • Изменения в конфиге до версии 2.15.0
    • Автозамена номеров телефонов
    • Мониторинг состояния
      • Пример мониторинга через Zabbix
    • В таблице CEL в столбце cid_num нет внутреннего номера сотрудника
    • Неверное время в созданных делах в Битрикс24
    • Настройка записи разговоров на стороне Asterisk
    • Установка и настройка CEL
    • Запуск дополнительной копии модуля
    • Решение для нескольких Астерисков
    • Примеры настройки WSS соединений
    • Задержка при показе окна
    • Реализация обратного звонка в Битрикс24
    • Использование стороннего хранилища записей
    • Размещение модуля на стороннем сервере
    • Обработка звонков за период
    • Ускорение работы модуля за счет параллельной обработки звонков
    • Настройка прав на просмотр детализации звонков
  • FAQ
    • Как оплатить решение
    • Предоставление доступа к серверам
    • Битрикс24.Маркет Плюс и Itgrix
    • Обновление приложения
    • Офлайн установка (только для Битрикс24)
    • Офлайн обновление
    • Сравнения версий Itgrix для Битрикс24
    • Возможности Itgrix в сравнение с SIP-коннектором для Битрикс24
    • Надежные софтфоны для Asterisk
    • Как посмотреть статистику по звонкам сотрудников
    • Как отключить отображение звонков в календаре
    • Политика оператора в отношении обработки персональных данных
    • Политика интеграции Asterisk
    • Детальные статусы звонка
    • Как оставить отзыв о приложении Itgrix в Битрикс24?
    • Как оставить отзыв о приложении Itgrix в amoCRM?
  • Change log (новые версии) itgrix_bx
  • Change log (новые версии) itgrix_amo
  • Бонусы
Powered by GitBook
On this page
  • Как перенести кастомизации на новую версию
  • Для версий с одним кастомизатором
  • Схема обработки звонка модулем интеграции Itgrix (bx24asterisk)
  • Входные и выходные параметры кастомизаций
  • 1) process_phone_number
  • 2) process_record_file_path
  • 3) process_originate_params
  • 4) process_search_params
  • 5) process_final_params
  • 6) process_entity_creation_params
  • 7) process_task_creation_params
  • 8) get_updated_lead_fields
  • 9) get_updated_activity_fields

Was this helpful?

  1. Полезные кастомизации itgrix_bx (Битрикс24)

Кастомизации (для версий до 2.15.0)

PreviousКастомизации (для версий до 3.0)NextБолее недоступный функционал

Last updated 3 years ago

Was this helpful?

Как перенести кастомизации на новую версию

  1. Переименовать get_updated_lead_fields.php в get_updated_entity_fields.php;

  2. Перенести код для черных/белых списков (если есть) из кастомизаций process_search_params.php и/или process_final_params.php в need_registration.php.

Для версий с одним кастомизатором

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

Схема обработки звонка модулем интеграции Itgrix (bx24asterisk)

(Схема для версий до 2.15.0)

Описание схемы

“Сущность” — это контакт или лид.

Краткое описание кастомизаций

Файл кастомизации
Описание

get_search_filter.php

Фильтруем полученные из Б24 сущности. (Для посвященных в Битрикс. Только для избранных.) Можно выбрать по параметрам, с какими сущностями работать.

get_updated_activity_fields.php

Обновление полей дела (в конце звонка)

get_updated_entity_fields.php

Обновить поля сущности (в конце звонка)

need_registration.php

Нужна ли регистрация?

Можно сделать черно-белые списки по внутреннему номеру/транку.

process_entity_creation_params.php

Изменение параметров создания сущности в Б24.

process_final_params.php

Изменение данных завершения звонка.

process_originate_params.php

Изменение параметров при инициализации звонка из Битрикс.

Можно позвонить через другой транк, через другой контекст, сменить формат номера и прочее.

process_phone_number.php

Изменение номера получаемого телефона:

Можно сменить формат телефонного номера (+7, 8...).

process_record_file_path.php

Кастомизация пути до файла записи разговора.

process_registration_params.php

Изменение параметров регистрации звонка.

process_task_creation_params.php

Кастомизация создания задач по пропущенным звонкам.

Входные и выходные параметры кастомизаций

1) process_phone_number

Преобразование номеров – как внутренних, так и внешних.

Примеры использования

Вход:

{"params": {"phone": <номер>} }

Вернуть:

{"data": {"phone": <кастомизированный_номер>}, "state": "success" }\

2) process_record_file_path

Преобразование пути до файла записи разговора.

Вход:

{"params": {"call_id": <id_звонка>}, {"from": <номер>}, {"to": <номер>}, {"path": <путь_до_записи>} }

Вернуть:

{"data": {"path": <кастомизированный_путь_до_записи>}, "state": "success" }\

3) process_originate_params

Изменение параметров при инициализации звонка из Битрикс24.

Вход:

{"params": { "caller_id": "<caller_id>", "channel": "<channel>", "context": "<context>", "extension": "<extension>", "priority": "<priority>" }}

Вернуть:

{"data": { "caller_id": "<caller_id>", "channel": "<channel>", "context": "<context>", "extension": "<extension>", "priority": "<priority>" }}

Опционально:

"codecs": "<codecs>", "variable": "variable"\

4) process_search_params

Изменение параметров поиска сущности, а также данных на входе.\

Примеры использования:

Вход:

  {"params": {
(см. https://dev.1c-bitrix.ru/rest_help/scope_telephony/telephony/telephony_externalcall_register.php)
      "CALL_START_DATE": "<Дата, время начала звонка>"
      "CRM_CREATE": "<Создавать или нет новый лид (если номер не найден в CRM)>"
      "CRM_SOURCE": "<STATUS_ID источника из справочника источников>"
      "LINE_NUMBER": "<Транк, на который пришел звонок>"
      "PHONE_NUMBER": "<Номер для поиска сущности в битрикс>"
      "SHOW": "<[0/1] Показывать ли карточку звонка при регистрации>"
      "TYPE": "<Направление звонка: 2 - входящий; 1 - исходящий>"
      "USER_ID": "<Идентификатор пользователя>",
      "conversation": {Данные о звонке},
      "call": {Если есть разговор, придет этот набор вместо conversation},
      "user": {}
}}

Вернуть:

{"data": { - измененные входные параметры "<Название поля задачи в битрикс>": "<Значение этого поля>", }}

Опционально:

"action": "<ignore/register При значении ignore, звонок НЕ будет зарегистрирован в CRM>", "filter": { - параметры для поиска в битрикс. Логика описана в статье https://bx24asterisk.ru/support/30-customize_search_params "lead": {}, "contact": {}, "company": {} }

5) process_final_params

Преобразование данных завершения звонка.

Примеры использования:

Вход:

{"params": {
      "ADD_TO_CHAT": "<Добавить сообщение о звонке в бизнес чат>",
      "CALL_ID": "<Идентификатор звонка в битрикс>",
      "DURATION": "<Длительность>",   
      "STATUS_CODE": 200,
      "USER_ID": "<Идентификатор пользователя Битрикс, ответственного за разговор>",
      "conversation": {
          "answered_at": "<Время поднятие трубки>",
          "channel_id": "<Идентификатор канала>",
          "ended_at": "<Время окончания разговора>",
          "from": "<Номер позвонившего>",
          "from_local": <Локальный номер позвонившего. Принимает значение true или false>,
          "id": "<Идентификатор звонка>",
          "parent_channel_id": "<Идентификатор родительского канала>",
          "started_at": "<Время начала звонка>",
          "state": <Статус состояния звонка>,
          "state_code": "<Состояния звонка>",
          "to": "<Номер, кому пришел звонок>",
          "to_local": <Локальный номер принимающего. Принимает значение true или false>,
          "trunk": "<Внешний номер, на который поступил звонок>",
          "type": <Направление звонка. Принимает значения: 1 - внутренний; 2 - входящий; 3 - исходящий>,
          "type_code": "<Направление звонка. Принимает значения: incoming - входящий, outgoing - исходящий>",
          "was_answered": <Отвеченный звонок. Принимает значение true или false>
      },
      "entity_data": {
          "entity_id": <Идентификатор сущности в битрикс>,
          "entity_type": "<Тип сущности. Принимает значения: lead, company, contact>",
          "was_created": <Был ли лид создан модулем (для новых лидов). Принимает значение true или false>
      }
  }}

Вернуть:

 {
      "data": {
          "ADD_TO_CHAT": "<Добавить сообщение о звонке в бизнес чат>",
          "CALL_ID": "<Идентификатор звонка в битрикс. Не рекомендуется изменять!>",
          "DURATION": "<Длительность>",
          "STATUS_CODE": "<SIP-код статуса звонка>",
          "USER_ID": "<Идентификатор пользователя Битрикс, ответственного за разговор>",
      },
      "action": "<delete/register При значении delete, звонок будет удален из CRM>",
      "state": "success"
  }

6) process_entity_creation_params

Событие возникает при входящем звонке с неизвестного номера.

Вход:

  {"params": {
      “type”: lead,    // значения: contact, deal, lead
      "ASSIGNED_BY_ID":238,
      "COMMENTS":"",
      "OPENED":"Y",
      "PHONE": [
          {"VALUE":"83432872875"}
      ],
      "SOURCE_ID":"7",
      "TITLE":""
  }}

Вернуть:

{ "data": { "<Название поля сущности в битрикс>": "<Значение этого поля>", }, "state": "success" }

Примеры использования:

7) process_task_creation_params

Вход:

{"params": {
      "arNewTaskData": {
          "DEADLINE":"<Крайний срок исполнения>",
          "CREATED_BY": <Идентификатор постановщика>,
          "RESPONSIBLE_ID": <Идентификатор сотрудника, ответственного за задачу>,
          "TITLE":"<Заголовок задачи>",
          "UF_CRM_TASK": [ - связь задачи с сущностью.
              "L_11201" - состоит из типа сущности (L - лид, C - контакт, CO - компания, D - сделка) и ее идентификатора, которые указываются через символ "_".
          ]
      }
  }}

Вернуть:

{ "data": { "arNewTaskData": { - массив полей для создания задачи "<Название поля задачи в битрикс>": "<Значение этого поля>" } }, "state": "success" }

8) get_updated_lead_fields

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

Вход: Е

Параметры звонка описаны в 5 пункте process_final_params

 {"params": {
      "conversations": { - набор всех разговоров, которые были в звонке
          "1550838819.13014": {<Набор данных о разговоре>},
          "1550838850.13029":{<Набор данных о разговоре>}
      },
      "answered_at":"",
      "ended_at":"",
      "from":"",
      "from_local":false,
      "id":"1550838797.13013",
      "started_at":"",
      "state":3,
      "to":"",
      "to_local":true,
      "trunk":"",
      "type":2
  }}

Вернуть:

{ "data": { "<Название поля лида в битрикс>": "<Значение этого поля>", }, "state": "success" }

9) get_updated_activity_fields

Обновление полей дела в конце звонка.

Вход:

Обновление полей дела в конце разговора.

Параметры звонка описаны в 5 пункте process_final_params

{"params": {
      "answered_at":"",
      "channel_id":"",
      "ended_at":"",
      "from":"",
      "from_local":false,
      "id":"",
      "parent_channel_id":"",
      "started_at":"",
      "state":3,
      "state_code":"hung",
      "to":"",
      "to_local":true,
      "trunk":"",
      "type":2,
      "type_code":"incoming",
      "was_answered":true
  }}

Вернуть:

{ "data": { "<Название поля дела в битрикс>": "<Значение этого поля>", }, "state": "success" }

Примеры использования –

Примеры использования –

;

.

;

.

Описание полей лида в ;

Описание полей контакта в ;

Описание полей сделки в .

Событие возникает перед постановкой задачи (при пропущенном входящем звонке). Полное описание полей задачи в .

Примеры использования –

Описание полей лида в

Примеры использования –

Изменение номера телефона перед отправкой данных в CRM
Кастомизация имени файла аудиозаписи
Черные и белые списки
Кастомизация поиска
Организация черных и белых списков
Разные ответственные за пропущенные за разные транки
API Битрикса
API Битрикса
API Битрикса
Кастомизация создания задач по пропущенным звонкам
API Битрикса
Обновление полей лида
API Битрикса
Обновление полей дела
Изменения номера\контекста для вызова в Астериск