Событие инициализации звонка ONVOXIMPLANTCALLINIT

Если вы разрабатываете интеграции для Битрикс24 с помощью AI-инструментов (Codex, Claude Code, Cursor), подключите MCP-сервер, чтобы ассистент использовал официальную REST-документацию.

Scope: telephony

Кто может подписаться: любой пользователь

Событие ONVOXIMPLANTCALLINIT срабатывает при инициализации звонка: при поступлении входящего звонка или при начале исходящего звонка.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения

Что получает обработчик

Данные передаются в виде POST-запроса

{
            "event": "ONVOXIMPLANTCALLINIT",
            "event_handler_id": "1057",
            "data": {
                "CALL_ID": "5E316880469A6376.1773306964.8740011",
                "CALL_TYPE": "1",
                "ACCOUNT_SEARCH_ID": "reg150908",
                "PHONE_NUMBER": "+79999996666",
                "CALLER_ID": "reg150908"
            },
            "ts": "1773306964",
            "auth": {
                "access_token": "s7p6eclrvim9da98dt9ch94ekreb52sv",
                "expires_in": "3600",
                "scope": "telephony",
                "domain": "some-domain.bitrix24.ru",
                "server_endpoint": "https://oauth.bitrix.info/rest/",
                "status": "F",
                "client_endpoint": "https://example.bitrix24.ru/rest/",
                "member_id": "a223c6b9410f85df73e9377d6c4f7213",
                "refresh_token": "4s386p3q0tr8dy09xvmt96234v3dljg8",
                "application_token": "52610fefc120afg4b628cc82d6298cce"
            }
        }
        
{
            "event": "ONVOXIMPLANTCALLINIT",
            "event_handler_id": "1057",
            "data": {
                "CALL_ID": "externalCall.7b0c7de811455ef32b18dc5917e4306a.1773239327",
                "CALL_TYPE": "1",
                "CALLER_ID": "+79061234567",
                "REST_APP_ID": "3"
            },
            "ts": "1773239326",
            "auth": {
                "access_token": "s7p6eclrvim9da98dt9ch94ekreb52sv",
                "expires_in": "3600",
                "scope": "telephony",
                "domain": "some-domain.bitrix24.ru",
                "server_endpoint": "https://oauth.bitrix.info/rest/",
                "status": "F",
                "client_endpoint": "https://example.bitrix24.ru/rest/",
                "member_id": "a223c6b9410f85df73e9377d6c4f7213",
                "refresh_token": "4s386p3q0tr8dy09xvmt96234v3dljg8",
                "application_token": "52610fefc120afg4b628cc82d6298cce"
            }
        }
            ```

Параметр
тип

Описание

event
string

Символьный код события.

В данном случае — ONVOXIMPLANTCALLINIT

event_handler_id
string

Идентификатор обработчика события

data
object

Объект с данными события.

Структура описана ниже

ts
timestamp

Дата и время отправки события из очереди событий

auth
object

Объект с параметрами авторизации пользователя, от имени которого сработало событие.

Структура описана ниже

Параметр data

Параметр
тип

Описание

CALL_ID
string

Идентификатор звонка

CALL_TYPE
integer

Тип звонка.

Возможные значения:

  • 1 — исходящий
  • 2 — входящий
  • 3 — входящий с перенаправлением
  • 4 — обратный звонок
  • 5 — информационный звонок

ACCOUNT_SEARCH_ID
string

Идентификатор линии.

Возможные значения:

  • XXX — для арендованных номеров
  • regXXX — для облачных АТС
  • sipXXX — для офисных АТС

Поле возвращается при работе через арендованные номера или SIP

PHONE_NUMBER
string

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

Поле возвращается при работе через арендованные номера или SIP

CALLER_ID
string

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

REST_APP_ID
integer

Идентификатор приложения, связанного со звонком.

Поле возвращается при работе с приложением телефонии

Параметр auth

Обязательные параметры отмечены *

Название
тип

Описание

access_token
string

Токен авторизации OAuth 2.0

expires_in
integer

Время в секундах до истечения срока действия токена

scope*
string

Скоуп, в рамках которого произошло событие

domain*
string

Адрес Битрикс24, на котором произошло событие

server_endpoint*
string

Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0

status*
string

Статус приложения, подписавшегося на это событие:

client_endpoint*
string

Общий путь для вызовов методов REST API для Битрикс24, на котором произошло событие

member_id*
string

Идентификатор Битрикс24, на котором произошло событие

refresh_token
string

Токен продления авторизации OAuth 2.0

application_token*
string

Токен для безопасной обработки событий

Токены авторизации не всегда передаются в обработчик события. Если хит, инициировавший событие, не удалось привязать к конкретному пользователю Битрикс24, токены не передаются. Обязательно проверяйте содержимое ключа auth в коде.

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

Продолжите изучение

Предыдущая
Обзор событий
Следующая
При начале разговора