При создании диалога OnImConnectorDialogStart

Scope: imconnector

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

Событие срабатывает при создании диалога.

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

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

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

[
            'event' => 'ONIMCONNECTORDIALOGSTART',
            'eventId' => 1,
            'data' => [
                'CONNECTOR' => 'newcustomconnector',
                'LINE' => '105'
                'DATA' => [
                    [
                        'connector' => [
                            'connector_id' => 'newcustomconnector',
                            'line_id' => 105,
                            'chat_id' => 8,
                            'user_id' => 0,
                        ],
                        'session' => [
                            'id' => 3282,
                            'closed' => N,
                            'parent_id' => 0,
                            'close_term' => 10,
                        ],
                        'chat' => [
                            'id' => 8
                        ],
                        'user' => [
                            'id' => 0
                        ],
                    ],
                ],
            ],
            'ts' => 1714649632,
            'auth' => [
                'access_token' => 's6p6eclrvim6da22ft9ch94ekreb52lv',
                'expires_in' => 3600,
                'scope' => 'imconnector',
                'domain' => 'some-domain.bitrix24.com',
                'server_endpoint' => 'https://oauth.bitrix24.tech/rest/'',
                'status' => 'F',
                'client_endpoint' => 'https://some-domain.bitrix24.com/rest/'',
                'member_id' => 'a223c6b3710f85df22e9377d6c4f7553',
                'refresh_token' => '4s386p3q0tr8dy89xvmt96234v3dljg8',
                'application_token' => '51856fefc120afa4b628cc82d3935cce',
            ],
        ]

Параметры

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

Название
тип

Описание

event*
string

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

eventId*
integer

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

data*
object

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

ts*
integer

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

auth*
object

Объект с параметрами авторизации и данными о портале, на котором произошло событие

Параметр data

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

Название
тип

Описание

CONNECTOR*
string

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

LINE*
integer

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

DATA*
object

Объект с данными диалога

Параметр DATA

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

Название
тип

Описание

connector*
object

Объект с информацией о дополнительных настройках:

  • connector_id — идентификатор коннектора
  • line_id — идентификатор открытой линии
  • chat_id — идентификатор чата
  • user_id — идентификатор пользователя во внешней системе

session*
object

Объект с информацией о сессии:

  • id — идентификатор сессии
  • closed — отметка о закрытии диалога. N — диалог открыт
  • parent_id — идентификатор предыдущей сессии
  • close_term — количество минут до закрытия сессии

chat*
object

Объект с информацией о чате:

  • id — идентификатор чата

user*
object

Объект с информацией о пользователе:

  • id — идентификатор пользователя во внешней системе

Параметр 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 в коде.

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

Предыдущая
При отправке сообщений
Следующая
При изменении сообщений