События звонков (ccsevents)

Описание

События телефонии для слоя колл-центра: CCS — Calls, Connections, Seances. Строятся из событий callevents и описывают звонок в терминах:

  • call — плечо: соединение сервера с одним абонентом;

  • connection — диалог, объединяющий плечи (на время множественного вызова — больше двух);

  • seance — сеанс: цепочка диалогов, связанных переводами. Отдельных событий по сеансу нет; принадлежность передаётся полем idseance и событиями *_attach_to_seance.

Идентификаторы используются в запросах Token-API ccs: idcall — data.id событий call_*, idconn — data.id событий connection_* (формат <callid>.<timestamp>), idseance — поле idseance.

Table 1. Системные характеристики

Класс

ccsevents

Тип домена

worker

Типы назначения

wssubscr, kafka (домен диалога)

Логические роли источники

b2b, callstore, mix, recmover, mware (события callevents)

Логическая роль обработчик

mware (плагин ccs домена), wssubscr

Подписка и доставка

  • Подписка: "events": ["ccsevents.*"] или список ccsevents.<type>; "objects": "any" (событие не связано с объектами).

  • Получают подписки Token-API (websocket) и веб-хуки (не рекомендуются: около 20 запросов на звонок); в Kafka — при настроенном в домене kafka_mustache.

  • Если у токена несколько подходящих подписок, событие приходит по каждой со своим sid.

  • События одного диалога (connection) формируются последовательно и в том же порядке отправляются подписчикам домена.

  • Формирование выключается в мастер-домене: значение "ccs" в списке events настройки disabled_plugins.

Формат уведомления:

["notify", {"sid": "...", "class": "ccsevents", "type": "connection_create", "eventts": 1791975832258, "data": {...}}]

eventts — время исходного события callevents; несколько событий ccsevents могут иметь одно значение.

Кросс-доменный звонок

События дублируются в рабочие домены, абоненты которых участвуют в звонке:

  • домен, в котором появляется первый вызываемый форк, сначала получает накопленные события звонка (с исходными eventts), затем текущие;

  • пока идёт множественный вызов, каждый домен получает события своих плеч и все события диалога;

  • после ответа события получает только домен ответившей стороны; остальные получают connection_delete;

  • connection_set_record_info и connection_set_asr каждый домен получает по своей записи разговора.

События

Тип Когда

call_create

Создано плечо: вызывающее, вызываемое или перехватывающее

call_update

Плечо соединено

call_set_state

Изменено состояние плеча

call_attach_to_seance

Плечо перенесено в другой сеанс

call_dtmf

Получен DTMF-символ

call_delete

Плечо удалено

connection_create

Создан диалог

connection_update

Изменён диалог

connection_link_call

Плечо привязано к диалогу

connection_attach_to_seance

Диалог перенесён в другой сеанс

connection_start_record

Начата запись разговора

connection_record_changed

Запись приостановлена или возобновлена

connection_set_record_info

Запись помещена в хранилище

connection_set_asr

Получен результат транскрибации

connection_failure

Вызов не состоялся (до создания диалога)

connection_delete

Диалог завершён

Типичный порядок для отвеченного звонка: call_create (A) → connection_create → connection_link_call → connection_update → call_create (B) → connection_link_call → call_set_state (ringing) → call_update (A, B) → connection_update (connected) → …​ → call_set_state (finished) → call_delete (A, B) → connection_delete.

Диагностика потока событий

Запрос Token-API ccs ccs_setup управляет буфером последних событий — для сверки отправленного плагином ccs и полученного соединением:

["ccs_setup", {"qid": 1, "cmd": "set_ccsevents_buffer", "size": 1000}]
  • set_ccsevents_buffer — размер буфера size (0..50000; 0 — выключить). Пока буфер включён, все события домена содержат поля orderkey (сквозной номер) и idc (идентификатор диалога).

  • dump_ccsevents_buffer — выгрузить буферы плагина и соединения в журнал сервера и очистить.

  • ping — проверка доступности плагина ccs домена.