...
| Code Block |
|---|
| language | xml |
|---|
| title | Событие об окончании исходящего звонка в чате по ЛП |
|---|
| collapse | true |
|---|
|
<Event ID="d5d05738-1944-11e3-56b5-7054d21ab6ff" Time="2019-01-31T12:47:28" Mode="ServicesClients" Object="Call" Initiator="Incoming">
<ClientID>6dd05738-1464-11e3-93b5-7054d21ab6ff</ClientID>
<CounterpartID>6dd05738-1464-11e3-93b5-7054d21ab6ff</CounterpartID>
<UserID>227e9d68-01d8-4006-ad42-d034dcb67818</UserID>
<ServiceID>114c7433-4c28-11e7-80e5-0025904f970f</ServiceID>
<CallID>cc7cafb6-2e3c-f5d2-502c-f19ee322e58c</CallID>
<CallFrom>7215fb1e-89b9-4252-befa-45e20cf9bc5b</CallFrom>
<CallTo>227e9d68-01d8-4006-ad42-d034dcb67818</CallTo>
<State>Finished</State>
<StartTime>2019-01-31T17:46:53</StartTime>
<AcceptTime>2019-01-31T17:46:53</AcceptTime>
<EndTime>2019-01-31T17:47:30</EndTime>
<Duration>37</Duration>
<BillSec>37</BillSec>
<CallResult>Success</CallResult>
</Event> |
Фильтрация событий
Если у текущего аккаунта списки контактов/групповых чатов большие, то возрастает поток событий от них, поступающих в ДП. Т.к. о производительности и функционале внешнего приложения заранее неизвестно (это знает только разработчик того приложения), то в API приложений предусмотрено, что массовые виды событий должны транслироваться внешнему приложению только в случае потребности со стороны последнего.
...
в ответ на команду придёт ответ, аналогичный вышеуказанному
Возможные объекты события
| Div |
|---|
| title | Перечисление видов объектов и присущих им специфических тегов |
|---|
|
| Object | Описание | Условие | Свойства (теги) | Примечание |
|---|
PersonalInfo
| Персональные данные
|
| <Name> | Имя | <SecondaryName> | Отчество | <Surname> | Фамилия | <Birthday> | Дата рождения | <Phone> | Номер телефона | <EMail> | Адрес электронной почты | | AgentOnlineStatus | Онлайн-статус аккаунта |
| <Status> |
| Expand |
|---|
| title | Возможные значения тега Status |
|---|
| - “Offline”
- “Connecting”=Не в сети
- “Online”=В сети
- “Away”=Нет на месте
- “Talking”=Разговариваю
- “DoNotDisturb”=Не беспокоить
- “RedirectToExternalPhone”=Переадресация на внешний телефон
- “BusyForNewRequests”=Занят для новых обращений
|
| Message
| Сообщение в ленту чата
|
| <MessageID> | UUID сообщения (не передаётся командой SendMessage) | | <AuthorID> | UUID автора сообщения | | <MessageBody> | Тело сообщения | | <Sended> | Время отправки сообщения | | (Mode=”ServicesClients”) | <SpecialistID> | | | Call | Сеанс голосовой связи (звонок) |
| <CallID> | UUID факта звонка |
| <CallFrom> | UUID инициатора | | <CallTo> | UUID встречного абонента | | (State>=”Started”) | <StartTime> | Момент начала дозвона | | (State>=”CallAccepted”) | <AcceptTime> | Момент взятия трубки собеседником - начало отсчета длительности разговора | (State>=”Finished”)
| <EndTime> | Момент завершения голосового сеанса | | <CallResult> |
| Expand |
|---|
| title | Возможные значения тега CallResult |
|---|
| - “Success” = успешное завершение разговора
- “NobodyToAnswer” = Не было свободных специалистов
- ‘’RingingTimeout” = Превышено время дозвона
- “RejectedByCallee” = вызываемый(принимающий) отбил вызов
- “RejectedByCaller” = звонящий отбил вызов
- “PBXunreachableForMe” = мне не удалось соединиться с АТС
- “PBXunreachableForTarget” = собеседнику не удалось соединиться с АТС
- “TargetHaveNoSoundDevices” = у собеседника отсутствуют звуковые устройства
- “IHaveNoSoundDevices” = у меня отсутствуют звуковые устройства
|
| <Duration> | Общая длительность голосового сеанса ~ (EndTime - StartTime) | <BillSec> | Длительность голосового общения ~ (EndTime - AcceptTime) | | (State=”MP3RecordReady”) | <CallRecordLink> | URL-ссылка на файл записи голосового сеанса (формат .mp3) | | (State=”SoundQualityAssessment”) | <Assessment> | = 1..5 | | <Comments> | комментарии к оценке (?XML) | RemoteAccessSession
| Сеанс удаленного доступа
|
| <SessionID> | UUID сеанса УД | | <AuthorID> | UUID того, кто подключается | | (State>=”Started”) | <StartTime> | Момент начала процесса подключения | | <HostCompName> | Название ПК в ОС, к которому подключаются | | <AdminCompName> | Название ПК в ОС, с которого подключаются | | <HostIP> | IP-адрес к кому подключаются | | <AdminIP> | IP-адрес того, кто админит | | (State>=”Finished”) | <EndTime> | Момент завершения сеанса УД | | <Duration> | Длительность сеанса в секундах | | <UploadedFiles> |
| Code Block |
|---|
| language | xml |
|---|
| title | Cписок файлов, скопированных с удаленного ПК |
|---|
| collapse | true |
|---|
| <File Name=”” SourceDir=”” DestinDir=”” Size=”” StartTime=”” Duration=””/> |
| FileTransfer (пока не реализовано) | Файл, выложенный в ленту чата |
| <FileTransferID> | UUID транслируемого файла (чтобы не запутаться) | | <FileName> | Имя файла с расширением | | <FileSize> | в байтах | | (State>=”Finished”) | <TransferDuration> | в секундах с сервера/на сервер | Treatment (Mode=”ServicesClients”) | Обращение по линии (поддержки) |
| <TreatmentID> | UUID обращения |
|
| (State>=”Appointed”) | <AppointedSpecialistID> | UUID специалиста, который был назначен на обращение |
|
| <WaitTime> | время ожидания назначения спеца в сек |
|
| (State>=”Finished”) | <TreatmentDuration> | длительность обращения в секундах |
|
| (State>=”ServiceQualityAssessment”) | <Assessment> | = 1..5 - оценка по 5-балльной шкале |
|
| (State>=”Comments”) | <Comments> | Комментарии (XML?) | | ServiceRequest | Тикет по ЛП (заявка/задача) |
|
|
|
|
Возможные места возникновения события
| Div |
|---|
| title | Перечисление мест возникновения и присущих им специфических свойств |
|---|
|
| Mode | Описание | Свойства (теги) | Примечание |
|---|
ServicesClients
| Чат с пользователем линии поддержки
(соответствует вкладке "Клиенты") | <ClientID> | UUID организации, в которой работает потребитель ЛП | | <UserID> | UUID пользователя ЛП | | <ServiceID> | UUID ЛП | | Colleagues | Чат с коллегой (соответствует вкладке "Коллеги") | <ColleagueID> | UUID коллеги | | PersonalContacts | Чат с персональным ("Деловым") контактом (соответствует вкладке "Коллеги") | <PersonalContactID> |
| | <MeetingState> | Состояние приглашения | | Softphone | Софтфон | <CallTo> | Номер встречного абонента | | GroupChats | Групповой чат (конференц-чат) | <GroupChatRoomID> |
|
|
| <MemberID> | От какого участника группового чата пришло событие |
|
...