Similar presentations:
API Платформа
1. API Платформа МТС EXOLVE MESSAGING
APIMESSAGING
EXOLVE
2. КЛЮЧЕВЫЕ ПУНКТЫ
При переходе на новую платформу01
Обновится токен авторизации
02
Меняется точка доступа при отправке SMS
03
Меняется точка доступа для получения
истории сообщений
04
История сообщений становится более
информативной, фильтры – гибкими
05
Сохраняется получение онлайн-уведомлений,
есть некоторые отличия в формате
2
3. ОТПРАВКА SMS С DEF-НОМЕРА
SMSDEF-
AS IS
TO BE
https://wiki.exolve.ru/pages/viewpage.action?pageId=132548727
https://docs.exolve.ru/docs/ru/api-reference/sms-api/sending-sms/
:
https://api.mtt.ru/ms-customer-gateway/v1/SendSms
Bearer token
:
https://api.exolve.ru/messaging/v1/SendSMS
Bearer token
{
{
"number": "79991112233",
"destination": "79992223344",
"text": "Test message"
"number": "79991112233",
"destination": "79992223344",
"text": "Test message"
}
}
{
{
"success": true,
"messageId": "50843200293703680"
"message_id": "439166538239448536“
}
}
3
4. ПОЛУЧЕНИЕ ОНЛАЙН-УВЕДОМЛЕНИЙ
AS ISTO BE
https://wiki.exolve.ru/pages/viewpage.action?pageId=132548132
:
https://api.mtt.ru/ms-customer-gateway/v1/SetNumberSettings
Bearer token
event:
{
"customer_name": "110000011",
"account_sid": "",
"event_id": 449727660168364865,
"message_id": 449727659849588395,
"event_date": {
"seconds": 1770796582,
"nanos": 885655580
},
"event_date_human": "2023-02-28T12:42:54.298316597Z",
"text": "Test events",
"segments_count": 1,
"direction": "DIRECTION_INCOMING",
"sender": "79133333333",
"receiver": "79999999999",
"delivery_status": "DELIVERY_STATUS_DELIVERED",
"bill_status": "BILLING_STATUS_BILLED",
"message_channel": "MESSAGE_CHANNEL_SMS"
https://docs.exolve.ru/docs/ru/api-reference/sms-api/sms-events/
:
Отдельная настройка не требуется
event:
{
"event_id": "449727660168364865",
"message_id": "449727659849588395",
"application_id": "74caefbc-5615-49db-aca1-07ba829e728c",
"date": "2023-02-28T12:42:54.298316597Z",
"sender": "79133333333",
"receiver": "79999999999",
"text": "Test events",
"direction": "DIRECTION_INCOMING",
"segments_count": 1,
"delivery_status": "DELIVERY_STATUS_DELIVERED",
"message_channel": "MESSAGE_CHANNEL_SMS",
"status": "STATUS_DELIVERED"
}
}
4
5. ПОЛУЧЕНИЕ ИСТОРИИ СООБЩЕНИЙ
AS ISTO BE
https://wiki.exolve.ru/pages/viewpage.action?pageId=132548121
:
https://api.mtt.ru/ms-customer-gateway/v1/GetMessagesHistoryList
Bearer token
https://docs.exolve.ru/docs/ru/api-reference/sms-api/getting-messageslist/
:
https://api.exolve.ru/messaging/v1/GetList
Bearer token
{
"customer_name": "SMSTest1",
"message_id": 426247515017377112
}
{
"message_id": 535103102366598660
}
{
"message_id": "426247515017377112",
"number": "79587625012",
"sender": "79587625012",
"receiver": "79771807106",
"text": "(((((Тестовое сообщение № 1)))))",
"direction": "outgoing",
"segments_count": 1,
"billing_status": "billed",
"delivery_status": "delivered",
"event_date": "2022-09-19T13:08:39.117183726Z",
"channel": "sms"
{
"messages": [
{
"message_id": "535103152366598674",
"application_uuid": "6cb49297-8cd2-4f34-8e8b-856679a82437",
"date": "2024-10-09T12:12:18.303Z",
"date_sent_received": "2024-10-09T12:12:18.303Z",
"number": "79813330013",
"sender": "79813340013",
"receiver": "79873558880",
"text": "МТС Exolve — конструктор омниканальных диалогов для бизнеса",
"direction": 2,
"segments_count": 1,
"billing_status": 2,
"delivery_status": 3,
*** // полный набор параметров – в описанной документации
}
]
}
}
5
6. ПОЛУЧЕНИЕ КОЛИЧЕСТВА СООБЩЕНИЙ
AS ISTO BE
https://wiki.exolve.ru/pages/viewpage.action?pageId=132548123
https://docs.exolve.ru/docs/ru/api-reference/sms-api/getting-messagescount/
:
https://api.mtt.ru/ms-customer-gateway/v1/GetMessagesHistoryCount
Bearer token
:
https://api.exolve.ru/messaging/v1/GetCount
Bearer token
{
"customer_name": "SMSTest1",
"number": "79587625012"
{
"number": "79587625012"
}
}
{
{
"count": "17"
}
"count": "17"
}
6
7.
APIExolve
https://exolve.ru/faq/kak-nachat-rabotu-s-api-mtsexolve/
7
8.
89. API Платформа МТС EXOLVE VOIP SIP ID
APIVOIP SIP ID
EXOLVE
10. КЛЮЧЕВЫЕ ПУНКТЫ
При переходе на новую платформу01
При переходе потребуется обновить
регистрацию (если это не происходит
автоматически)
02
Авторизационные данные сохраняются
03
Появляется возможность получать
статистику вызовов по API
04
Появляется возможность получать онлайнуведомления по вызовам по API
05
Появляется возможность самостоятельной
настройки SIP ID и номеров по API
10
11. ПОЛУЧЕНИЕ ОНЛАЙН-УВЕДОМЛЕНИЙ по вызову
-event
AS IS
Не предусмотрено
TO BE
Документация:
https://docs.exolve.ru/docs/ru/api-reference/statistics-api/sip-events/
Документация:
https://docs.exolve.ru/docs/ru/api-reference/statistics-api/call-events/
{
"service": "sip",
"date_time": "2024-01-05T11:09:42.866477Z",
"from": "79991112233",
"to": "79994445566",
"call_sid": "call-test-12345",
"type": "e",
"sip_id": "883140123456789",
"record_call": true,
"call_id": 12345678910,
"application_uuid": "178ec145-6898-4b06-a92a75f63cb57046",
"customer_id": 1111,
"direction": "outbound",
"display_number": "79991112233"
}
11
12. ПОЛУЧЕНИЕ статистики вызовов
AS IS{
"calls": [
{
"call_id": "7285581555017551200",
"service": "sip",
"application_uuid": "45b2bf47-fa06-4352-a202-b347f372ff90",
"start_time": "2025-01-16T09:00:02.997Z",
"end_time": "2025-01-16T09:01:04.089Z",
"from": "883140005577000",
"to": "7999999999",
"status": "no_answer",
"direction": "outbound",
"duration": 61.03,
"legs": [
{
"start_time": "2025-01-16T09:00:04.188Z",
"end_time": "2025-01-16T09:01:04.089Z",
"from": "79334445566",
"to": "7999999999",
"status": "no_answer",
"setup_time": 61.03,
"wait_time": 61.03,
"talk_time": 0,
"duration": 61.03,
"cause_code": 16
}
],
"record_call": true,
"voice_record_exist": false,
"transcribe": false,
"transcribations_record_exist": false,
"speech_analytics": true,
"speech_analytics_exist": false
}
]
Не предусмотрено
TO BE
Документация (получение за период):
https://docs.exolve.ru/docs/ru/api-reference/statistics-api/call-history/
Документация (получение по ID вызова:
https://docs.exolve.ru/docs/ru/api-reference/statistics-api/getting-callinfo/
}
12
13. УПРАВЛЕНИЕ SIP ID ПО api
SIP IDAS IS
API
TO BE
https://docs.exolve.ru/docs/ru/api-reference/sip-api/
SIP
13
14.
APIExolve
https://exolve.ru/faq/kak-nachat-rabotu-s-api-mtsexolve/
14
15.
1516. API Платформа МТС EXOLVE VOIP STATIC IP
APIVOIP STATIC IP
EXOLVE
17. КЛЮЧЕВЫЕ ПУНКТЫ
При переходе на новую платформу01
Переход с изменением адресов
совершения / получения вызовов
02
Появляется возможность подключить
запись разговора
03
Появляется возможность управлять
номерами по API
Документация:
https://docs.exolve.ru/docs/ru/api-reference/numberingapi/call-forwarding/
https://docs.exolve.ru/docs/ru/api-reference/numberingapi/getting-number-attributes/
17
18. Адреса для совершения / получения вызовов
AS ISTO BE
80.75.130.86 – адрес для совершения исходящих /
приема входящих звонков
80.75.130.99
80.75.130.101
Адреса необходимо прописать на оборудовании до
согласованного дня переключения.
18
19.
APIExolve
https://exolve.ru/faq/kak-nachat-rabotu-s-api-mtsexolve/
19