MakeVoiceMessage

Метод MakeVoiceMessage

Примените метод MakeVoiceMessage для запуска автоматизированного обзвона с предзаписанным аудиосообщением или синтезированной в режиме онлайн речью (TTS — text-to-speech).

Совет: увеличьте конверсию в дозвон и срок службы номеров с помощью услуги «Карусель». Платформа МТС Exolve будет автоматически менять номер при каждом исходящем звонке — по порядку или случайным образом. Для этого создайте карусель и передайте её авторизационный номер в параметре “source” метода MakeVoiceMessage. Подробнее — в этой инструкции.

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

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

Авторизация

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

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

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

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

• service_id — если хотите проиграть принимающим абонентам предзаписанное аудио и уже создали для него ресурс голосового SMS в Личном кабинете или с помощью API-метода Create
• tts — если хотите синтезировать речь по заданным параметрам в режиме онлайн

TTS

SynthesisSettings

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

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

Примеры

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

Звонок с предзаписанным аудиофайлом

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

Звонок с синтезированием речи в режиме онлайн

{  
  "source": "74959999999",
  "destination": "79999999999",
  "tts": {
          "text": "МТС Exolve — конструктор омниканальных диалогов для бизнеса",
          "voice": 1,
          "lang": 1,
          "volume": -19,
          "speed": 1.1,
          "emotion": 2
        }
}

Звонок с автоматической ротацией номеров (каруселью)

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

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

{
    "call_id": "7374422070618357761"
}

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