Versions Compared

Key

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

...

1.1. Завантаження абонентів в дайлер

Приклади POST запитів:

...

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

...

Code Block
languagejs
titleCreate call
{
  "destination": "${agent_id}",			// номер призначення, обов'язкове
  "from": {
    "extension": "${extension}"			// внутрішній номер оператора, обов'язкове. Див. "Отримання списку операторів"
  },
  "params": {
    "disable_auto_answer": true,		// вимикає автопідняття трубки. Якщо передати параметр, тоді додатково оператору потрібно буде прийняти дзвінок у Workspace
    "variables": { 						// додаткові змінні по клієнту, які можуть використуватисявикористовуватися для статистики
      "additionalProp1": "${additionalProp1}",
      "additionalProp2": "${additionalProp2}",
      "additionalProp3": "${additionalProp3}"
    }
  }
}

...

Code Block
languagejs
titleCreate Agent Skills
{
  "agent_id": "${agent_id}",	// ідентифікатор оператора. Див. "Отримання списку операторів"
  "capacity": 0,				// потенціал (рівень володіння навичкою). Можливі значення: 0-100
  "enabled": true,				// стан навички (вона може бути увимкненаувімкнена/вимкенавимкнена)
  "skill": {
    "id": "${id}" 				// ідентифікатор навички з довідника Webitel. Див. "Отримання списку навичок Webitel"
  }
}

...

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

Можливі значення параметру параметра status:

  • success - успішний додзвін. Повторної спроби дозвона не буде.
  • cancel - відмненийвідмінений. Повторної спроби дозвона не буде.
  • будь-яке інше передане значення (якщо таке потрібно для статистики) буде вважатися системою як статус abandoned.Буде повторна спроба дозвону згідно налаштувань з налаштуваннями дайлера. 


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

6. Історія дзвінків

...

Підключення до бази даних Webitel 

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

Посилання на опис структури БД: Database SDK

...

5.2. Отримання історії дзвінків

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

...

За допомогою HTTP REST API є можливість по UUID звонка  дзвінка отримати список всіх зв'язаних файлів (це не тільки записи розмов (масив files)). 

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

...

5.3. Отримання записів по ід файлів 

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