События звонков (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.
Класс |
|
Тип домена |
|
Типы назначения |
|
Логические роли источники |
|
Логическая роль обработчик |
Подписка и доставка
-
Подписка:
"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каждый домен получает по своей записи разговора.
События
| Тип | Когда |
|---|---|
Создано плечо: вызывающее, вызываемое или перехватывающее |
|
Плечо соединено |
|
Изменено состояние плеча |
|
Плечо перенесено в другой сеанс |
|
Получен DTMF-символ |
|
Плечо удалено |
|
Создан диалог |
|
Изменён диалог |
|
Плечо привязано к диалогу |
|
Диалог перенесён в другой сеанс |
|
Начата запись разговора |
|
Запись приостановлена или возобновлена |
|
Запись помещена в хранилище |
|
Получен результат транскрибации |
|
Вызов не состоялся (до создания диалога) |
|
Диалог завершён |
Типичный порядок для отвеченного звонка: 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 домена.