При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «При создании чата OnSessionStart», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
При создании чата OnSessionStart
> Scope: imopenlines
>
> Кто может подписаться: любой пользователь
Событие OnSessionStart срабатывает при создании чата.
Подписаться на событие можно только через приложение. Получить в обработчик можно только те события, которые предназначены для коннектора, который добавило приложение.
События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения
Что получает обработчик
Данные передаются в виде POST-запроса
[
'event' => 'ONSESSIONSTART',
'eventId' => 1,
'data' => [
'DATA' => [
[
'connector' => [
'connector_id' => 'livechat',
'line_id' => 128,
'chat_id' => 10585,
'user_id' => 1984,
],
'chat' => [
'id' => 10585
],
'user' => [
'id' => 128,
'name' => 'linename'
],
],
],
],
'ts' => 1714649632,
'auth' => [
'access_token' => 's6p6eclrvim6da22ft9ch94ekreb52lv',
'expires_in' => 3600,
'scope' => 'imopenlines',
'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',
],
]Входящие параметры и конфигурация метода
Названиетип | Описание |
|---|---|
eventstring | Символьный код события |
eventIdinteger | Идентификатор события |
dataobject | Объект с данными события |
tsinteger | timestamp отправки события из очереди событий |
authobject | Объект с параметрами авторизации и данными о портале, на котором произошло событие |
Параметр data {#data}
Названиетип | Описание |
|---|---|
DATAobject | Объект с данными чата |
Параметр DATA {#chat-params}
Названиетип | Описание |
|---|---|
connectorobject | Объект с информацией о коннекторе: — connector_id — идентификатор коннектора— line_id — идентификатор открытой линии— chat_id — идентификатор чата— user_id — идентификатор пользователя во внешней системе |
chatobject | Объект с информацией о чате: — id — идентификатор чата |
line*object | Объект с информацией об открытой линии: — id — идентификатор открытой линии— name — название открытой линии |
Параметр auth
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к создании чата, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «При создании чата OnSessionStart».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru