{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"2083357e-1b22-4c86-ac4d-19e231a0c862"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d333227f-fa44-436d-ba8d-33e27d2b85bc"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"События регистрации оборудования","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"События логин, логаут в очередь","type":"text"}]},{"type":"paragraph","content":[{"text":"События (логин, логаут) агентов отслеживаются ресурсом ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://ringme-confluence.atlassian.net/wiki/spaces/RAL/pages/63213917"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Анализ событий для мониторинга","type":"text"}]},{"type":"paragraph","content":[{"text":"Основные события (ивенты) звонков - это DIAL-IN, DIAL-OUT, ANSWER и HANGUP.","type":"text"}]},{"type":"paragraph","content":[{"text":"По каждому событию типа DIAL-IN, DIAL-OUT, ANSWER удобно создавать/обновлять отдельную структуру данных типа:","type":"text"}]},{"type":"paragraph","content":[{"text":"<Идентификационный ключ звонка>: {<данные звонка>}","type":"text"}]},{"type":"paragraph","content":[{"text":"Пример:","type":"text"}]},{"type":"codeBlock","content":[{"text":"calls: {\n\t129509OUTnri4l2sngj9k3lsm5ndkfs0: {\n \"CallerExtension\": \"0004*999@sip.ringme.ru\",\n \"CallerExtensionID\": 129509,\n \"CalledExtension\": \"0004*315@sip.ringme.ru\",\n \"CalledExtensionID\": 438108,\n \"EventType\": \"answer\",\n \"CallID\": \"nri4l2sngj9k3lsm5ndkfs0\",\n \"CallerIDNum\": \"+79127695081\",\n \"CallerIDName\": \"+79127695081\",\n \"CalledDID\": \"74956637373\",\n \"CallStatus\": \"ANSWER\",\n \"CallFlow\": \"out\",\n \"CalledNumber\": \"0004*315\",\n \"SubCallID\": \"129409-nri4l2sngj9k3lsm5ndkfs0\",\n \"CallAPIID\": \"167903702-nri4l2sngj9k3lsm5ndkfs0\",\n \"EventTime\": 16884456543096\n\t},\n\t387295INni548n294mndfinu5skjn56e: {...etc},\n\t...etc\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":"А по событию HANGUP (а в некоторых случаях и по ANSWER) удалять эти структуры данных по идентификационным ключам","type":"text"}]},{"type":"paragraph","content":[{"text":"Идентификационный ключ соединяет в себе три сущности: ExtensionId, CallFlow и CallId. Рекомендации по формированию идентификационного ключа для каждого типа события указаны ниже в каждом типе событий.","type":"text"}]},{"type":"paragraph","content":[{"text":"Если в вашем интерфейсе не планируется отображение какого-либо состояния звонка, то вы можете просто игнорировать ненужные события. Например, в вашем интерфейсе отображаются только отвеченные звонки (в состоянии “answered”). Значит, вам нужно заводить новые структуры данных только по событиям answer, а dial-in и dial-out можно просто проигнорировать.","type":"text"}]},{"type":"paragraph","content":[{"text":"События можно анализировать следующим образом:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"EventType “dial-in”","type":"text"}]},{"type":"paragraph","content":[{"text":"Обозначает входящий на добавочный. В таком звонке нас интересует, КОМУ звонят (кто calledExtension)","type":"text"}]},{"type":"paragraph","content":[{"text":"Идентификационный ключ такого звонка: CalledExtensionId + \"IN\" + CallId","type":"text"}]},{"type":"paragraph","content":[{"text":"ЕСЛИ calledExtension - это ","type":"text"},{"text":"очередь","type":"text","marks":[{"type":"strong"}]},{"text":", значит звонящий попал в очередь и ждет, когда ему ответит кто-либо из агентов этой очереди.","type":"text"}]},{"type":"paragraph","content":[{"text":"Можно отобразить в интерфейсе:","type":"text","marks":[{"type":"em"}]},{"text":" входящий дозвон на очередь (\"висящий в очереди\" звонок)","type":"text"},{"text":" *","type":"text","marks":[{"type":"strong"}]}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"ЕСЛИ calledExtension - это ","type":"text"},{"text":"phone","type":"text","marks":[{"type":"strong"}]},{"text":", значит сейчас на этот phone кто-то пытается дозвониться","type":"text"}]},{"type":"paragraph","content":[{"text":"Можно отобразить в интерфейсе:","type":"text","marks":[{"type":"em"}]},{"text":" входящий дозвон на конкретного сотрудника","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"EventType “dial-out”","type":"text"}]},{"type":"paragraph","content":[{"text":"Обозначает исходящий вызов с добавочного. В этом звонке нас интересует, КТО звонит (кто callerExtension)","type":"text"}]},{"type":"paragraph","content":[{"text":"Идентификационный ключ такого звонка: CallerExtensionId + \"OUT\" + CallId","type":"text"}]},{"type":"paragraph","content":[{"text":"ЕСЛИ callerExtension - это ","type":"text"},{"text":"очередь","type":"text","marks":[{"type":"strong"}]},{"text":", значит очередь сейчас звонит кому-то из своих агентов","type":"text"}]},{"type":"paragraph","content":[{"text":"Можно отобразить:","type":"text","marks":[{"type":"em"}]},{"text":" исходящий дозвон от очереди на конкретного сотрудника","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"ЕСЛИ callerExtension - это ","type":"text"},{"text":"phone","type":"text","marks":[{"type":"strong"}]},{"text":", значит phone сейчас пытается кому-то дозвониться","type":"text"}]},{"type":"paragraph","content":[{"text":"Можно отобразить:","type":"text","marks":[{"type":"em"}]},{"text":" исходящий дозвон от конкретного сотрудника на какой-либо номер","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"EventType “answer”","type":"text"}]},{"type":"paragraph","content":[{"text":"Обозначает ответ на звонок. Здесь нам нужно анализировать направление звонка (callFlow)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CallFlow “in”","type":"text"}]},{"type":"paragraph","content":[{"text":"Это ответ на входящий звонок. Нас интересует КТО ответил (calledExtension)","type":"text"}]},{"type":"paragraph","content":[{"text":"Идентификационный ключ такого звонка: CalledExtensionId + \"IN\" + CallId","type":"text"}]},{"type":"paragraph","content":[{"text":"ЕСЛИ calledExtension - это ","type":"text"},{"text":"очередь","type":"text","marks":[{"type":"strong"}]},{"text":", то мы игнорируем такое событие, так как попадание звонка в очередь уже создается по событию dial-in на очередь","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"ЕСЛИ calledExtension - это ","type":"text"},{"text":"phone","type":"text","marks":[{"type":"strong"}]},{"text":", значит кто-то из сотрудников ответил на звонок.","type":"text"}]},{"type":"paragraph","content":[{"text":"Можно отобразить:","type":"text","marks":[{"type":"em"}]},{"text":" ответивший сотрудник разговаривает прямо сейчас (ответив на входящий звонок)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CallFlow “out”","type":"text"}]},{"type":"paragraph","content":[{"text":"Это ответ на исходящий звонок. Нас интересует КОМУ ответили (callerExtension)","type":"text"}]},{"type":"paragraph","content":[{"text":"Идентификационный ключ такого звонка: CallerExtensionId + \"OUT\" + CallId","type":"text"}]},{"type":"paragraph","content":[{"text":"ЕСЛИ ","type":"text"},{"text":"callerExtension","type":"text","marks":[{"type":"strong"}]},{"text":" - это очередь, значит агент очереди ответил на звонок.","type":"text"}]},{"type":"paragraph","content":[{"text":"Можно отобразить:","type":"text","marks":[{"type":"em"}]},{"text":" удаление звонка из списка \"висящих в очереди\" (если вы его создавали на этапе, который описан выше - EventType “dial-in” calledExtension ","type":"text"},{"text":"очередь","type":"text","marks":[{"type":"strong"}]},{"text":" - помечено звездочкой (","type":"text"},{"text":"*","type":"text","marks":[{"type":"strong"}]},{"text":") )","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"ЕСЛИ ","type":"text"},{"text":"callerExtension","type":"text","marks":[{"type":"strong"}]},{"text":" - это phone, значит позвонившему сотруднику кто-то ответил.","type":"text"}]},{"type":"paragraph","content":[{"text":"Можно отобразить:","type":"text","marks":[{"type":"em"}]},{"text":" позвонивший сотрудник разговаривает прямо сейчас (получил ответ, совершив исходящий вызов)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"EventType “hangup”","type":"text"}]},{"type":"paragraph","content":[{"text":"Обозначает окончание звонка. Нам как и ранее нужно анализировать направление звонка (CallFlow)","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CallFlow “in”","type":"text"}]},{"type":"paragraph","content":[{"text":"Это хэнгап на входящий звонок. Нас интересует КОМУ звонили в этом звонке (calledExtension). Здесь нам нужно завершить звонок по такому ключу: CalledExtensionId + \"IN\" + CallId","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CallFlow “out”","type":"text"}]},{"type":"paragraph","content":[{"text":"Это хэнгап на исходящий звонок. Нас интересует КТО звонил в этом звонке (callerExtension). Здесь нам нужно завершить звонок по такому ключу: CallerExtensionId + \"OUT\" + CallId","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Разберем возможный пример","type":"text"}]},{"type":"paragraph","content":[{"text":"У вас есть очередь 200 (extensionId ","type":"text"},{"text":"222222","type":"text","marks":[{"type":"em"}]},{"text":") с одним агентом 101 (extensionId ","type":"text"},{"text":"111111","type":"text","marks":[{"type":"em"}]},{"text":"). В очередь поступает звонок с номера +798198736545.","type":"text"}]},{"type":"paragraph","content":[{"text":"Вам поступает ивент DIAL-IN, в котором CalledExtension - это очередь. CallId этого звонка ","type":"text"},{"text":"qqqwwweeerrrtttyyy999.","type":"text","marks":[{"type":"em"}]},{"text":" Вы формируете идентификационный ключ: ","type":"text"},{"text":"222222INqqqwwweeerrrtttyyy999","type":"text","marks":[{"type":"em"}]},{"text":" и кладете информацию о событии по этому ключу в структуру данных:","type":"text"}]},{"type":"paragraph","content":[{"text":"calls: {","type":"text"}]},{"type":"paragraph","content":[{"text":"222222INqqqwwweeerrrtttyyy999: {<данные события>} // 1","type":"text"}]},{"type":"paragraph","content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"С помощью этой информации вы отображаете “висящий в очереди звонок”","type":"text"}]},{"type":"paragraph","content":[{"text":"Очередь начинает обзванивать своих агентов. Вам поступает событие DIAL-OUT, в котором CallerExtension - это очередь. Вы формируете новый ключ и добавляете данные этого события в структуру данных:","type":"text"}]},{"type":"paragraph","content":[{"text":"calls: {","type":"text"}]},{"type":"paragraph","content":[{"text":"222222INqqqwwweeerrrtttyyy999: {<данные события>}, // 1","type":"text"}]},{"type":"paragraph","content":[{"text":"222222OUTqqqwwweeerrrtttyyy999: {<данные события>} // 2","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"С помощью этой информации вы отображаете, кому сейчас звонит очередь","type":"text"}]},{"type":"paragraph","content":[{"text":"Так как в очереди только один агент 101, очередь сразу начнет дозвон на него и вам придет событие DIAL-IN, в котором агент 101 будет CalledExtension. Вы формируете новый ключ и добавляете данные этого события в структуру данных:","type":"text"}]},{"type":"paragraph","content":[{"text":"calls: {","type":"text"}]},{"type":"paragraph","content":[{"text":"222222INqqqwwweeerrrtttyyy999: {<данные события>}, // 1","type":"text"}]},{"type":"paragraph","content":[{"text":"222222OUTqqqwwweeerrrtttyyy999: {<данные события>}, // 2","type":"text"}]},{"type":"paragraph","content":[{"text":"111111INqqqwwweeerrrtttyyy999: {<данные события>} // 3","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"С помощью этих данных вы отображаете, что у агента 101 сейчас есть входящий звонок, но он еще не снял трубку","type":"text"}]},{"type":"paragraph","content":[{"text":"Когда 101 поднимет трубку, вам придет два события ANSWER.","type":"text"}]},{"type":"paragraph","content":[{"text":"Первый ANSWER c CallFlow === “in”, в котором CalledExtension будет агент 101. Это событие сигнализирует, что 101 ответил на входящий звонок.","type":"text"}]},{"type":"paragraph","content":[{"text":"Идентификационный ключ для этого события будет такой же, как и на событие DIAL-IN на 101 (","type":"text"},{"text":"111111INqqqwwweeerrrtttyyy999","type":"text","marks":[{"type":"em"}]},{"text":"**)**. Когда мы положим в структуру данных новое событие по этому ключу, оно заменит старое событие. И это правильно, так как теперь агент 101 находится в разговаривающем состоянии, а не в состоянии вызова. Вот так будет выглядеть обновленная структура данных:","type":"text"}]},{"type":"paragraph","content":[{"text":"calls: {","type":"text"}]},{"type":"paragraph","content":[{"text":"222222INqqqwwweeerrrtttyyy999: {<данные события>}, // 1","type":"text"}]},{"type":"paragraph","content":[{"text":"222222OUTqqqwwweeerrrtttyyy999: {<данные события>}, // 2","type":"text"}]},{"type":"paragraph","content":[{"text":"111111INqqqwwweeerrrtttyyy999: {<данные нового события>} // 3","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"Теперь мы по этим данным отображаем не дозвон очереди на 101, а то, что 101 уже разговаривает.","type":"text"}]},{"type":"paragraph","content":[{"text":"Помимо этого, так как мы уже получили ответ от добавочного, нам не нужно отображать “висящий в очереди” звонок. Так что удаляем входящий в очередь звонок (под номером 1) из структуры данных:","type":"text"}]},{"type":"paragraph","content":[{"text":"calls: {","type":"text"}]},{"type":"paragraph","content":[{"text":"222222OUTqqqwwweeerrrtttyyy999: {<данные события>}, // 2","type":"text"}]},{"type":"paragraph","content":[{"text":"111111INqqqwwweeerrrtttyyy999: {<данные нового события>} // 3","type":"text"}]},{"type":"paragraph","content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"Второй ANSWER мы получаем с CallFlow === “out”, и в нем CallerExtension - очередь. Это событие сигнализирует, что кто-то ответил на дозвон от очереди. При формировании идентификационного ключа мы так же обнаружим, что он совпадает с уже существующим ключом (","type":"text"},{"text":"222222OUTqqqwwweeerrrtttyyy999","type":"text","marks":[{"type":"em"}]},{"text":"). Нам не нужно ничего отображать по этому событию, так что просто удалим его по этому ключу.","type":"text"}]},{"type":"paragraph","content":[{"text":"Вот так будет выглядеть структура после этого:","type":"text"}]},{"type":"paragraph","content":[{"text":"calls: {","type":"text"}]},{"type":"paragraph","content":[{"text":"111111INqqqwwweeerrrtttyyy999: {<данные нового события>} // 3","type":"text"}]},{"type":"paragraph","content":[{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"На данный момент у нас отображается только текущий разговор добавочного 101.","type":"text"}]},{"type":"paragraph","content":[{"text":"Когда он закончит разговаривать, начнут прилетать события типа HANGUP. Два хэнгапа прилетят на те звонки, которые мы уже ранее завершили по событию ANSWER, поэтому с ними делать ничего не надо. И один из хэнгапов будет иметь CallFlow === “in” и в качестве CalledExtension будет иметь агента 101. Идентификационный ключ такого события будет совпадать с ключом последнего оставшегося в структуре данных события (под номером 3). По этому ключу мы его удаляем:","type":"text"}]},{"type":"paragraph","content":[{"text":"calls: {}","type":"text"}]},{"type":"paragraph","content":[{"text":"На этом у нас завершились все звонки и в интерфейсе больше ничего не отображается.","type":"text"}]},{"type":"paragraph","content":[{"text":"NB: Данный документ - это упрощенный пример построения системы анализа ивентов. Их можно анализировать и другими способами и создавать структуры данных по-другому. Подберите вариант, подходящий для конкретно вашей интеграции.","type":"text"}]}],"version":1}

Browser not supported