Основные сущности

В этом параграфе рассказывается об основных сущностях МД и их взаимосвязях. Это те сущности МД, с которыми мы рекомендуем ознакомиться перед тем, как приступать к работе с API МД.

Сущность Описание
Виджет, группа каналов Компонент МД, объединяющий в себе настройки текстовых каналов коммуникаций. Он предоставляется в виде кода JS, который вы можете вставить в код вашего сайта и на вашем сайте появится кнопка обмена сообщениями (2). В настройках МД виджету может быть присвоен один из статусов: - включен: функции виджета доступны в полном объеме; - выключен: функции виджета полностью недоступны.
Сессия Информация о диалоге Клиента с оператором. Обращаем внимание, что в сессии нет сообщений, которыми обменивались Клиент и оператор. Они хранятся с сущности "Чат" (chat), ассоциированной с определенной сессией. То есть, информация о сессии включает в себя только id-номер чата, а все сообщения хранятся в чате. Время жизни сессии устанавливается в настройках МД. Сессии может быть присвоен один из следующих статусов: - pending: сессия создана и ожидает распределения на оператора или группу; - dialog: сессия передана в работу оператору или группе. В рамках сессии происходит диалог Клиента с оператором; - closed: сессия закрыта, ни Клиент, ни оператор больше не могут отправлять и получать сообщения в рамках этой сессии.
Чат Массив сообщений, которыми обменивались оператор и Клиент, ассоциированный в определенной сессией. Имеет уникальный idномер, выдаваемый МД.
Клиент Ваш Клиент, обратившийся к вам по текстовому каналу коммуникации.
Оператор Ваш сотрудник, зарегистрированный в вашей ВАТС и получивший внутренний номер телефон.
Внешняя система Бизнес-система, внешняя по отношению к МД, которая взаимодействует с МД через API.
Оператор внешней системы Пользователь внешней системы, ведущий диалог с Клиентом через МД.