Itgrix База знаний
Asterisk-коннекторСтоимостьЛицензионное соглашениеКонтакты
  • Что такое Itgrix?
  • Наша история
  • Наши контакты
  • Блог
    • БД Itgrix
    • AsterPhone в Битрикс24
    • AsterPhone в AmoCRM
    • Настройка WebRTC в Asterisk (FreePBX)
    • Привязка звонка к сделке в Call Card в Bitrix24
  • Установка модуля
    • Требования к системе
    • Установка модуля интеграции Битрикс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
  • Краткое описание кастомизаций
  • Входные и выходные параметры кастомизаций
  • 1) customize_activity
  • 2) customize_entity
  • 3) need_registration
  • 4) process_client_phone
  • 5) process_final_params
  • 6) process_originate_params
  • 7) process_record_file_path
  • 8) process_registration_params
  • 9) process_task_creation_params
  • 10) process_user_phone
  • 11) customize_autodistribution
  • 12) post_registration
  • 13) customize_show_call_card
  • 14) customize_attach_record_url

Was this helpful?

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

PreviousПараметры звонка (call) и разговора (conversation) в кастомизацияхNextПолезные кастомизации itgrix_bx (Битрикс24) [С историей]

Last updated 5 months ago

Was this helpful?

Данная статья актуальна для версий коннектора 3.10.*

Для предыдущих версий можно воспользоваться "исторической" версией статьи:

Дополнительные кастомизации описаны в разделе .

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

"Сущность" в логике коннектора – это контакт или лид. Запрос разговора – это начало звонка на внутреннем номере. В одном звонке может быть несколько разговоров (в случае перевода звонка).

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

№

Файл кастомизации (по алфавиту)

Описание

1

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

2

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

3

Нужна ли регистрация звонка? Можно сделать черные/белые списки по внутреннему номеру/транку.

4

Изменение номера телефона перед регистрацией в CRM: Можно сменить формат телефонного номера (+7, 8...).

5

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

6

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

7

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

8

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

9

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

10

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

11

Изменение внутреннего номера при автораспределении входящего звонка.

12

Действие после регистрации звонка.

13

Изменение параметров отображения карточки звонка.

14

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

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

1) customize_activity

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

Вход:

{
  <Набор данных о разговоре (conversation, сохранен для обратной совместимости)>,
  "activity": {
    "id": "<ID дела>",
    "is_new": <Всегда false>,
    "name": "<Название дела (из поля SUBJECT)>",
    "phones": [<Всегда пустой массив>],
    "raw": {Поля дела как в Битрикс24},
    "responsible": {<Данные ответственного пользователя>},
    "responsible_id": "<ID ответственного пользователя>",
    "type": "activity"
  },
  "call_full": {<Полный набор данных о звонке>}
}

В объекте raw присутствуют только поля с непустым/ненулевым значением.

Вернуть:

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

2) customize_entity

Вход:

{
  "call_full": {<Полный набор данных о звонке>},
  <Остальные поля сохранены для обратной совместимости>
}

Вернуть:

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

3) need_registration

Используется для реализации функционала чёрных/белых списков по номерам, транкам и прочим более сложным условиям.

Вход:

{
  "call_full": {<Полный набор данных о звонке>},
  "call_stage": "<Стадия звонка. Для данной кастомизации один из вариантов:
     conversation_requested - запрос разговора;
     conversation_accepted  - ответ;
     conversation_ended     - завершение разговора;
     call_ended             - завершение звонка>"
  <Остальные поля сохранены для обратной совместимости>
}

Вернуть:

{
  "data": {
    "result": <true - регистрируем; false - игнорируем>
  },
  "state": "success"
}

4) process_client_phone

Преобразование телефонных номеров клиентов перед отправкой запросов в Битрикс24.

Вход:

{
  "phone": "<номер>",
  
  "call_full": {<Полный набор данных о звонке>},
  "call_stage": "<Стадия звонка. Для данной кастомизации один из вариантов:
     conversation_requested - запрос разговора;
     conversation_accepted  - ответ;
     conversation_ended     - завершение разговора;
     call_ended             - завершение звонка>"
}

Вернуть:

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

5) process_final_params

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

Вход:

{
  "ADD_TO_CHAT": <[0/1] Добавить ли сообщение о звонке в бизнес чат.
                  По умолчанию 1>,
  "CALL_ID": "<ID звонка в Битрикс24. Не рекомендуется изменять!>",
  "DURATION": <Длительность звонка в секундах>,
  "STATUS_CODE": "<Статус звонка в Битрикс24>",
  "USER_ID": <ID пользователя Битрикс24, ответственного за разговор>,
    
  "call_full": {<Полный набор данных о звонке>},
  <Остальные поля сохранены для обратной совместимости>
}

Вернуть:

{
  "data": {
    "ADD_TO_CHAT": <[0/1] Добавить ли сообщение о звонке в бизнес чат>,
    "CALL_ID": "<ID звонка в Битрикс24. Не рекомендуется изменять!>",
    "DURATION": <Длительность звонка в секундах>,
    "STATUS_CODE": "<Статус звонка>",
    "USER_ID": <ID пользователя Битрикс24, ответственного за разговор>
  },
  "state": "success"
}

6) process_originate_params

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

7) process_record_file_path

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

  1. Сэкономить место на диске Битрикс24 (mp3 занимает меньше, чем wav);

  2. Прослушивать записи при помощи встроенного в CRM плеера.

Поскольку конвертация записей может занимать значительное время, у этой кастомизации особый, фиксированный таймаут 10 секунд, который не зависит от настроек кастомизаций. Если запись не успеет сконвертироваться до истечения таймаута, будет использован исходный файл.

8) process_registration_params

Используется для кастомизации параметров регистрации начала звонка.

Примеры:

Вход:

{
  "CALL_START_DATE": "<Дата-время начала звонка>",
  "CRM_CREATE": <[0/1] Создавать или нет новый лид (если номер не найден в CRM)>,
  "CRM_SOURCE": "<STATUS_ID источника из справочника источников>",
  "LINE_NUMBER": "<Номер внешней линии в Битрикс24, через который совершался звонок>",
  "PHONE_NUMBER": "<Номер для поиска сущности в битрикс>",
  "SHOW": <[0/1] Показывать ли карточку звонка при регистрации>,
  "TYPE": <Направление звонка: 1 - исходящий, 2 - входящий>,
  "USER_ID": <ID пользователя>,
    
  "call_full": {<Полный набор данных о звонке>},
  "call_stage": "<Стадия звонка. Для данной кастомизации один из вариантов:
    conversation_requested - запрос разговора;
    call_ended             - завершение звонка>",
  <Остальные поля сохранены для обратной совместимости>
}

Номера внешних линий в Битрикс24 (LINE_NUMBER) соответствуют транкам в настройках коннектора Itgrix.

Коннектор регистрирует номера транков как внешние линии в Битрикс24 при запуске, при этом каждой линии можно задать название в настройках.

Это связано с тем, что можно настроить, показывать карточку звонка в момент дозвона или при ответе.

Вернуть:

{
  "data": { 
    "CALL_START_DATE": "<Дата-время начала звонка>",
    "CRM_CREATE": <[0/1] Создавать или нет новый лид (если номер не найден в CRM)>,
    "CRM_SOURCE": "<STATUS_ID источника из справочника источников>",
    "LINE_NUMBER": "<Номер внешней линии в Битрикс24, через который совершался звонок>",
    "PHONE_NUMBER": "<Номер для поиска сущности в битрикс>",
    "SHOW": <[0/1] Показывать ли карточку звонка при регистрации>,
    "TYPE": <Направление звонка: 1 - исходящий, 2 - входящий>,
    "USER_ID": <ID пользователя>
  },
  "state": "success"
}

9) process_task_creation_params

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

При этом сначала применяются настройки, описанные в статье, а затем выполняется данная кастомизация.

Вход:

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

  "call_full": {<Полный набор данных о звонке>},
  <Остальные поля сохранены для обратной совместимости>
}

Вернуть:

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

10) process_user_phone

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

Вход:

{
  "phone": "<номер>",
  
  "call_full": {<Полный набор данных о звонке>},
  "call_stage": "<Стадия звонка. Для данной кастомизации один из вариантов:
    conversation_requested - запрос разговора;
    conversation_accepted  - ответ;
    conversation_ended     - завершение разговора;
    call_ended             - завершение звонка>"
}

Вернуть:

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

11) customize_autodistribution

Вход:

{
  "number": "<номер пользователя на которого распределять звонок>",
  "name":   "<имя пользователя на которого распределять звонок>",

  "from": "<номер с которого пришёл звонок>",
  "user": {
    "id":       <ID пользователя числом>,
    "phones":   ["<список номеров пользователя>"],
    "name":     "<Полное имя пользователя>",
    "email":    "<email пользователя>",
    "position": "<должность пользователя>"
  },
  "entity": {
    "type":           "<Тип сущности текстом, например lead, contact>",
    "id":             <ID сущности числом>,
    "name":           "<Имя сущности>",
    "responsible_id": <ID ответственного пользователя числом>
  },
  "error": "<текст ошибки>"
}

Вернуть:

{
  "data": {
    "number": "<Номер пользователя, на которого распределять звонок>",
    "name":   "<Имя пользователя, на которого распределять звонок>"
  },
  "state": "success"
}

name - текст который появится в CallerID и будет отображен в телефоне (или софтфоне) оператора.

Должен быть не более 20 символов (ограничение Asterisk)!

Поля from, user, entity и error - только для чтения и присутствуют только когда не пустые.

Они будут автоматически удалены, даже если вернуть их в объекте data.

12) post_registration

Данная кастомизация дает возможность выполнить какие-либо действия после регистрации звонка.

Может быть вызвана в разные моменты в зависимости от типа звонка:

  • Для звонков кликом (click-to-call, c2c) кастомизация будет вызвана в начале обработки стадии Запрос разговора (Conversation requested).

При звонках кликом Битрикс24 сам регистрирует звонок в момент клика и передает данные о регистрации коннектору, т.е. ещё до инициализации звонка в Asterisk.

Поэтому звонки кликом коннектор сам НЕ регистрирует, а только заканчивает как и все остальные звонки.

  • Пропущенные звонки на IVR регистрируются и завершаются на стадии Завершение звонка (Call ended).

  • Для всех остальных звонков кастомизация будет вызвана после выполнения запроса регистрации звонка в Битрикс24 на стадии Запрос разговора (Conversation requested).

Вход:

{
  "call_full": {<Полный набор данных о звонке>},
  "call_stage": "<Стадия звонка. Для данной кастомизации один из вариантов:
    conversation_requested - запрос разговора;
    call_ended             - завершение звонка>",
}

Вернуть:

Нужно вернуть только state, остальное игнорируется:

{
  "state": "success"
}

13) customize_show_call_card

Используется для кастомизации параметров отображения карточки звонка.

Вход:

{
  "CALL_ID": <ID зарегистрированного звонка в Битрикс24>,
  "USER_ID": <ID пользователя>,
  
  "call_full": {<Полный набор данных о звонке>},
  "call_stage": "<Стадия звонка. Для данной кастомизации один из вариантов:
    conversation_requested - запрос разговора;
    conversation_accepted  - ответ;
    conversation_ended     - завершение разговора;
    call_ended             - завершение звонка>"
 }

Вернуть:

{
  "data": { 
    "CALL_ID": <ID зарегистрированного звонка в Битрикс24>,
    "USER_ID": <ID пользователя>
  },
  "state": "success"
}

14) customize_attach_record_url

Кастомизация прикрепления ссылки на запись звонка. Запускается только если настроено прикрепление ссылки на запись вместо файла записи звонка.

По умолчанию в описание дела записывается HTML-код аудиоплеера (тег audio) со ссылкой на запись звонка.

Вход:

{
  "DESCRIPTION": "<Описание дела с аудиоплеером и ссылкой на запись звонка>",
  "DESCRIPTION_TYPE": <Тип содержания в виде целого числа, по умолчанию 3, т.е. HTML>,

  "activity": {
    "id": "<ID дела>",
    "is_new": <Всегда false>,
    "name": "<Название дела (из поля SUBJECT)>",
    "phones": [<Всегда пустой массив>],
    "raw": {Поля дела как в Битрикс24},
    "responsible": {<Данные ответственного пользователя>},
    "responsible_id": "<ID ответственного пользователя>",
    "type": "activity"
  },
  "call_full": {<Полный набор данных о звонке>}
 }

В объекте raw присутствуют только поля с непустым/ненулевым значением.

Вернуть:

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

Примеры: .

Полный набор данных о звонке описан в статье .

Подробное описание полей дела в .

Примеры: .

Полный набор данных о звонке описан в статье .

Подробное описание полей лида в . Подробное описание полей контакта в .

Базовая настройка черного/белого списка для внутренних номеров доступна .

Примеры: .

Полный набор данных о звонке описан в статье .

Доступна , она запускается ДО выполнения кастомизации.

Примеры в статье .

Полный набор данных о звонке описан в статье .

Примеры: .

Статусы звонка в Битрикс24 описаны в .

Полный набор данных о звонке описан в статье .

Подробное описание параметров завершения звонка в .

Подробное описание с примерами в статье .

Подробное описание с примерами в статье .

При установке Itgrix_bx по умолчанию уже включена перед отправкой в Битрикс24. Это позволяет вам:

Полный набор данных о звонке описан в статье .

Показ карточки звонка вынесен в отдельный запрос, и кастомизируется отдельной кастомизацией , поэтому параметр SHOW всегда равен 0.

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

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

Пример: (начиная с версии это можно ).

Полный набор данных о звонке описан в статье .

Подробное описание полей задачи в .

Доступна , она запускается ДО выполнения кастомизации.

Пример: .

Полный набор данных о звонке описан в статье .

Полный набор данных о звонке описан в статье .

Полный набор данных о звонке описан в статье .

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

Полный набор данных о звонке описан в статье .

Подробное описание полей дела в .

Обновление полей дела
Данные о звонке (call_full) в кастомизациях
документации REST API Битрикс24
Обновление полей сущности
Данные о звонке (call_full) в кастомизациях
документации REST API Битрикс24
документации REST API Битрикс24
Данные о звонке (call_full) в кастомизациях
автозамена номеров
Изменение номера телефона перед отправкой данных в CRM
Данные о звонке (call_full) в кастомизациях
Разные ответственные за пропущенные за разные транки
Данные о звонке (call_full) в кастомизациях
документации REST API Битрикс24
Изменение параметров при click-to-call
Кастомизация имени файла аудиозаписи
конвертация файлов записей разговоров в формат mp3
Добавление кода города в зависимости от города оператора
Изменение первого ответственного за лид/контакт
Создавать лид для каждого входящего звонка
Данные о звонке (call_full) в кастомизациях
документации REST API Битрикс24
Настройка задачи по пропущенному через админку
Данные о звонке (call_full) в кастомизациях
документации REST API Битрикс24
автозамена номеров
Несколько внутренних номеров у сотрудника
Данные о звонке (call_full) в кастомизациях
Данные о звонке (call_full) в кастомизациях
Данные о звонке (call_full) в кастомизациях
документации REST API Битрикс24
Данные о звонке (call_full) в кастомизациях
документации REST API Битрикс24
customize_show_call_card
customize_activity.php
customize_entity.php
need_registration.php
process_client_phone.php
process_final_params.php
process_originate_params.php
process_record_file_path.php
process_registration_params.php
process_task_creation_params.php
process_user_phone.php
customize_autodistribution.php
post_registration.php
customize_show_call_card.php
customize_attach_record_url.php
Полезные кастомизации itgrix_bx (Битрикс24) [С историей]
Полезные кастомизации (любая CRM)
Кастомизация задач по пропущенным звонкам
делать через веб-интерфейс настройки модуля
из админки (интерфейса настройки) коннектора
Черный/белый список для транков
статье Детальные статусы звонка
Кастомизации версий 3.10+
3.4.0