Блог Горошко Андрея Bitrix24 При создании чата OnSessionStart

При создании чата OnSessionStart

При разработке и поддержке проектов на платформе 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',
    ],
]

Входящие параметры и конфигурация метода

Название
тип
Описание
event
string
Символьный код события
eventId
integer
Идентификатор события
data
object
Объект с данными события
ts
integer
timestamp отправки события из очереди событий
auth
object
Объект с параметрами авторизации и данными о портале, на котором произошло событие

Параметр data {#data}

Название
тип
Описание
DATA
object
Объект с данными чата

Параметр DATA {#chat-params}

Название
тип
Описание
connector
object
Объект с информацией о коннекторе:
— connector_id — идентификатор коннектора
— line_id — идентификатор открытой линии
— chat_id — идентификатор чата
— user_id — идентификатор пользователя во внешней системе
chat
object
Объект с информацией о чате:
— id — идентификатор чата
line*
object
Объект с информацией об открытой линии:
— id — идентификатор открытой линии
— name — название открытой линии

Параметр auth

💡 Экспертное мнение и рекомендации

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к создании чата, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «При создании чата OnSessionStart».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Как перенести дело между элементами одного типаКак перенести дело между элементами одного типа

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Как перенести дело между элементами одного типа», разберем

Типы данных и форматы параметров в REST APIТипы данных и форматы параметров в REST API

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Типы данных и форматы параметров в REST API»,

При удалении свойства заказа из базы OnPropertyValueDeletedПри удалении свойства заказа из базы OnPropertyValueDeleted

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «При удалении свойства заказа из базы OnPropertyValueDeleted». Мы подготовили подробный разбор принципов работы и развернутые