Перейти до основного контенту

API Ringostat. Робота з кастомними статусами Ringostat Smart Phone.

Робота з кастомними статусами Ringostat Smart Phone

Автор: Olga Kalchenko

1. Отримати усі кастомні статуси у проєкті.

Цей метод дозволяє отримати списком усі існуючі кастомні статуси Ringostat Smart Phone у проєкті.

Основні параметри запиту:

Для того, щоб отримати кастомні статуси, їх треба створити.

Для цього треба перейти в розділ “Налаштування Ringostat Smart Phone” > “Налаштування кастомних статусів”

Далі створити нові статуси.

Приклад запиту:

{
"id": 777,
"method": "getCustomStatuses",
"params": {
"projectId": 39071
}
}

Приклад відповіді:

{
"id": "777",
"result": [
{ "id": 1763, "title": "На обіді" },
{ "id": 1768, "title": "Перерва" },
{ "id": 1773, "title": "В дзвінку" },
{ "id": 1778, "title": "На міті" }
],
"jsonrpc": "2.0"
}

2. Отримати інформацію про статуси співробітників.

Цей метод дозволяє отримати інформацію , коли/хто в який статус переходив у додатку Ringostat Smart Phone та скільки часу там був.

Основні параметри запиту:

Ключ авторизації auth-key ви можете знайти перейшовши на сторінку “Налаштування” > “Інтеграція” > “Ringostat API”. На цій сторінці необхідно скопіювати Auth-key, щоб передати його в Headers в Auth-key.

Приклад запиту:

{
"id": 1,
"jsonrpc": "2.0",
"method": "getSipStatusDailyReport",
"params": {
"projectId": 68861,
"filter": {
"from": "2026-03-19",
"to": "2026-03-25"
}
}
}

Приклад відповіді:

{
"jsonrpc": "2.0",
"result": [
{"employee": "TEST CY", "online": "01:31:55", "offline": "10:13:15"},
{"employee": "AI IVR Test", "online": "11:44:49", "offline": "00:00:21"},
{"employee": "Сергій Тест", "online": "11:44:49", "offline": "00:00:21"}
"id": 1
],
}

Важливо: якщо у співробітника два сіп-акаунти і один online а інший dnd, то за цей період співробітник вважається online, і dnd-статус не враховується .

Так само якщо один із сіпів буде в статусі speaking, то dnd, online і offline не рахуються, рахується лише speaking по пріоритетності.

Ви отримали відповідь на своє запитання?