Как отправить голосовое SMS (автообзвон)

Голосовое SMS — это автоматизированный обзвон с предзаписанным аудиосообщением или синтезированной в режиме онлайн речью. Такая голосовая рассылка поможет рассказать клиентам об акции, напомнить про мероприятие или сообщить о статусе заказа без помощи менеджера.

Сообщение можно подготовить двумя способами:

1. Загрузить готовый аудиофайл в формате WAV или MP3
2. Передать текст в API-запросе на звонок — платформа преобразует его в речь с помощью TTS (text-to-speech).

Вариант 1. Голосовое SMS с готовым аудиофайлом

1. Добавьте аудиофайл в библиотеку приложения. Это можно сделать следующими способами: Вы можете загрузить или синтезировать речь

• Загрузите предварительно записанное аудиосообщение с компьютера в разделе «Аудиофайлы» в Личном кабинете или с помощью API-метода Upload
• Преобразуйте текст в речь в разделе «Аудиофайлы» → «Синтезированная речь» в Личном кабинете или с помощью API-метода SynthesizeAndSave В обоих случаях в медиабиблиотеку будет добавлен аудиофайл, ему присвоится идентификатор.

1. Создайте ресурс голосового SMS в Личном кабинете или с помощью API-метода Create. Для этого укажите внутреннее название ресурса и идентификатор аудио из бибилиотеки приложения. При необходимости настройте перевод звонка на оператора при нажатии абонентом на определённую клавишу. Созданному ресурсу голосового SMS присвоится идентификатор.
2. Примените API-метод MakeVoiceMessage для совершения звонка. Во входных параметрах укажите:

• source: номер, с которого нужно позвонить
• destination: номер, на который нужно позвонить
• service_id: идентификатор ресурса голосового SMS

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

Пример отправки голосового SMS из Postman

В Postman выберите тип запроса POST и введите URL точки подключения. Во вкладе Auth выберите тип Bearer Token и подставьте токен вашего приложения в аккаунте МТС Exolve. Перейдите во вкладку Body и выберете формат отправляемых данных JSON. Пример:

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

Вариант 2. Голосовое SMS с синтезом речи (TTS)

Если у вас нет готовой аудиозаписи, передайте текст сообщения непосредственно в API-запросе. МТС Exolve синтезирует речь во время запуска звонка — загружать аудиофайл и предварительно создавать голосовое SMS не нужно.

1. Примените API-метод MakeVoiceMessage для совершения звонка. Во входных параметрах укажите:

• source: номер, с которого нужно позвонить
• destination: номер, на который нужно позвонить
• tts: настройки синтеза речи (текст, голос, язык, громкость, скорость речи, эмоцию)

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

Пример отправки голосового SMS из Postman

В Postman выберите тип запроса POST и введите URL точки подключения. Во вкладе Auth выберите тип Bearer Token и подставьте токен вашего приложения в аккаунте МТС Exolve. Перейдите во вкладку Body и выберете формат отправляемых данных JSON. Пример:

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