MakeCallBack

Метод MakeCallBack

Примените этот метод для совершения обратного звонка: платформа позвонит абонентам (например, оператору и клиенту), затем объединит их для разговора. Обоим абонентам можно перед соединением проиграть аудиосообщение — предварительно записанное или синтезированное в режиме онлайн в рамках этого же звонка.

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

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

Авторизация

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

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

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

Line_x

Destination

Audio

ВАЖНО! Для одного плеча можно указать только один из параметров:

• media_resource_id — проиграть принимающим абонентам предзаписанное аудио
• tts — (Text-to-Speech) — синтезировать речь по заданным параметрам в режиме онлайн

TTS

SynthesisSettings

ВАЖНО! Каждый голос поддерживает определённые параметры языка и эмоции. При формировании API-запроса важно, чтобы выбранный голос был доступен с указанным языком и эмоцией

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

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

Примеры

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

{
    "request_description": "internal_id_148",
    "number_code": 74999999999,
    "callback_resource_id": 1221,
    "line_1": {
        "destinations": [
            {
                "number": "78129999999"
            },
            {
                "number": "74959999999"
            }
        ],
        "ring_logic": 1,
        "audio": {
            "tts": {
                "text": "МТС Exolve — конструктор омниканальных диалогов для бизнеса",
                "voice": 1,
                "lang": 1,
                "volume": -19,
                "speed": 1.1,
                "emotion": 2
            }
        }
    },
    "line_2": {
        "destinations": [
            {
                "number": "79599999999"
            },
            {
                "number": "79999999999"
            }
        ],
        "ring_logic": 1,
        "audio": {
            "media_resource_id": 685
        }
    }
}

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

{
    "call_id": "1890033117915127808",
    "request_description": "Идентификатор"
}