Voice API

Voice API — программный интерфейс, который позволяет пользователям управлять ресурсами голосовых SMS в Личном кабинете и отправлять созданные голосовые SMS абонентам. Voice API позволяет совершать вызовы на номера абонентов и проигрывать им заранее загруженные в Личный кабинет аудиосообщения.

Voice API Exolve предлагает пользователям следующие методы для управления голосовыми SMS и их отправки:

• Create - создает ресурс голосового SMS в приложении Личного кабинета;

• GetList - получает список всех голосовых SMS приложения в Личном кабинете;

• GetInfo - получает информацию об одном ресурсе голосового SMS приложения в Личном кабинете;

• Delete - удаляет ресурс голосового SMS приложения в Личном кабинете;

• MakeVoiceMessage - отправляет голосовое SMS абоненту;

• GetInfo - получает информацию об отправленном голосовом SMS.

Решения, где используется Voice API

Попробовать бесплатно

Метод Create

Примените этот метод для создания голосового сообщения (SMS). Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/voice-message/v1/Create

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

RedirectInfo

Выходные параметры

Возможные ошибки

Примеры

Входные параметры:

{
    "name": "Тестовая голосовая SMS",
    "media_id": "1967",
     "redirect_info": {
        "digit":5,
        "redirect_number": "79295800000"
    }
}

Выходные параметры:

{
    "id": "cal55094238-bc5f-4b2d-8a95-5a20d7cbb5bc"
}

Метод GetList

Примените этот метод для получения списка всех голосовых сообщений. Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/voice-message/v1/GetList

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Пустой JSON

Выходные параметры

VoiceMessageList

Возможные ошибки

Примеры

Входные параметры:

{}

Выходные параметры:

{
    "voice_message_list": [
        {
            "id": "14b8d7b3-5468-418f-8592-b1d2127ad36b",
            "name": "test",
            "created_at": "2022-12-15T10:23:54.912Z"
        },
        {
            "id": "40d781c9-a559-4175-82be-96d5fd4b1ca7",
            "name": "test1",
            "created_at": "2022-12-15T10:29:53.157Z"
        }
    ]
}

Метод GetInfo

Примените этот метод для получения информации о голосовом сообщении. Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/voice-message/v1/GetInfo

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Возможные ошибки

Примеры

Входные параметры:

{ 
    "id": "14b8d7b3-5468-418f-8592-b1d2127ad36b"
}

Выходные параметры:

{
            "id": "14b8d7b3-5468-418f-8592-b1d2127ad36b",
            "name": "test",
            "digit": 5,
            "redirect_number": "79269999999",
            "media_id": 1979,
            "created_at": "2022-12-22T11:19:36.567Z"
}

Метод Delete

Примените этот метод для удаления голосового сообщения (SMS). Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/voice-message/v1/Delete

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Возможные ошибки

Выходные параметры

Пустой JSON

Примеры

Входные параметры:

{ 
    "id": "14b8d7b3-5468-418f-8592-b1d2127ad36b"
}

Выходные параметры:

{}

Метод MakeVoiceMessage

Примените этот метод для отправки голосового сообщения (SMS). Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/call/v1/MakeVoiceMessage

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Возможные ошибки

Примеры

Входные параметры:

{
  "source": "74959999999",
  "destination": "79999999999",
  "service_id": "app24226e5c-ce2b-4aa9-aac8-317f8dd42714"
}

Выходные параметры:

{
    "call_id": "cal55094238-bc5f-4b2d-8a95-5a20d7cbb5bc"
}

Метод GetInfo

Примените этот метод для получения статистики об отправленном голосовом сообщении (SMS). Для этого выполните POST запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/call/v1/GetInfo

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Входные параметры

Передайте следующие параметры в теле запроса в JSON формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Выходные параметры

Возможные ошибки

Примеры

Входные параметры:

{
    "call_id": "caldf32f642-6313-4dae-94db-98502ad3249c"
}

Выходные параметры:

{
    "call_id": "caldf32f642-6313-4dae-94db-98502ad3249c",
    "created": "Wed, 29 Mar 2023 10:32:45 +0000",
    "updated": "Wed, 29 Mar 2023 10:33:07 +0000",
    "started": "Wed, 29 Mar 2023 10:32:58 +0000",
    "ended": "Wed, 29 Mar 2023 10:33:07 +0000",
    "duration": 9,
    "timeout": 60,
    "status": "completed",
    "direction": "outbound",
    "source": "79990557296",
    "destination": "79995556789"
}