Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

1.1. Загрузка абонентов в дайлер.

Примеры POST запросов:

Добавить только одного участника: https://swagger.webitel.com/#/MemberService/

...

CreateMember

Добавить массив участников: https://swagger.webitel.com/#/MemberService/CreateMemberBulk


Warning
titleВажно
  • CRM должен сохранять идентификатор загруженного абонента для дальнейшего использования, например, при отмене прозвона.
  • Для отображения названия корзины оператору при входящем звонке в массиве varialblesобязательно нужно передавать название корзины(bucket_name).
  • Для открытия карточки клиента в CRM по ссылке в массиве varialbles обязательно нужно передавать полную ссылку на карточку этого клиента. Название переменной - {link}.

...

1.5. Отмена прозвона абонента дайлером.

https://swagger.webitel.com/#/MemberService/MemberService_PatchMember

Обязательные параметры:

  • идентификатор очереди дайлера;
  • идентификатор абонента в очереди.

...

4.1. Управление постобработкой. 

https://swagger.webitel.com/#/MemberService/MemberService_AttemptCallback

После завершения звонка оператор должен отправить статус обработки звонка (постобработка) з CRM в Webitel.

...

Code Block
languagejs
titleAttempt Callback
{
  "agent_id": "${agent_id}",  					// идентификатор оператора
  "attempt_id": "${attempt_id}", 				// идентификатор попытки дозвона дайлера, по которой передается результат постобработки. Получается из RabbitMQ
  "description": "${description}",  			// комментарий, оставленный оператором при постобработке звонка
  "display": true, 								// отвечает за прикрепление номера отображения к этому абоненту
  "exclude_current_communication": true,  		// при значении true на текущий способ связи больше не будет звонков
  "expire_at": "${expire_at}", 					// указывает время, когда удалить абонента с прозвона (Unix time)
  "min_offering_at": "${min_offering_at}",		// timestamp значение конкретного времени перезвона дайлером в таймзоне UTC. Календарь дайлера имеет более высокий приоритет. Если указанное здесь время не входит в рабочее время дайлера, то повторная попытка будет сделана в рабочее время с наиболее высоким приоритетом.
  "status": "${status}", 						// статус попытки
  "variables": {
    "additionalProp1": "${additionalProp1}",
    "additionalProp2": "${additionalProp2}",
    "additionalProp3": "${additionalProp3}"
  }
}

5

...

.

...

5.1. Получение списка очередей.

https://swagger.webitel.com/#/QueueService/QueueService_SearchQueue

...

История звонков.

...

5.1. Подключение к базе данных Webitel. 

В случае разворачивания Webitel On-Site, получение данных по звонкам и операторам возможно через подключение к БД Webitel (PostgreSQL 14).

Ссылка на описание структуры БД: Database SDK

...

5.2. Получение истории звонков. 

https://swagger.webitel.com/#/CallService/CallService_SearchHistoryCall

...

Далее по идентификатору файла можно получить конкретный файл.

...

5.3. Получение записей по id файлов.

GET https://:WEBITEL_SERVER/api/storage/recordings/:FileID/stream?access_token=:TOKEN

...

  • :FileID - идентификатор файла, полученный с CallService_SearchHistoryCall;
  • :TOKEN - токен.

...

5.4. Поиск звонков по значению переменной.

GET https://:WEBITEL_SERVER/api/calls/history?page=1&size=10&number=110&variables[Company]=eb0b368c39305630464fa34c2af0e45f

:WEBITEL_SERVER - сервер Webitel.

...

  • number - номер телефона. Поиск осуществляется по from_number, to_number, destination;
  • Company - название переменной (метаданные);
  • page - страница, если много записей;
  • size - максимальное количество записей.

6. Другое.

6.1. Получение списка очередей.

https://swagger.webitel.com/#/QueueService/QueueService_SearchQueue