Перейти к основному содержимому

Отправка Voice (звонок)

Voice-сообщения позволяют отправлять клиентам сервисную информацию голосовым сообщением или сделать автоматический обзвон по базе клиентов.

Отправка Voice осуществляется через общий метод отправки сообщений POST /api/message.

Пример запроса для отправки Voice:

curl -X POST "https://cp.redsms.ru/api/message" \
-H "login: <USERNAME>" \
-H "ts: ts-value-42" \
-H "secret: $(echo -n 'ts-value-42<API_KEY>' | md5sum | awk '{print $1}')" \
-H "Content-type: application/json" \
-d '{
"route": "voice",
"from": "<VOICE_SENDER_NAME>",
"to": "+79993332211",
"text": "Ваш код авторизации - 0 8 3 5. Повторяю - 0 8 3 5"
}'

# В OSX вместо команды md5sum необходимо использовать команду md5
примечание

Вы можете найти доступные значения для имени отправителя Voice <VOICE_SENDER_NAME> в личном кабинете в разделе «Имена отправителей».

Пример тела ответа:

{
"items": [
{
"uuid": "0f9a4cfa-8bed-11ee-94af-0242c0a86496",
"status": "created",
"status_time": 1703956078,
"to": "+79993332211"
}
],
"errors": [],
"count": 1,
"success": true
}

Тарификация

Тарификация звонков посекундная. Оплачиваются только прослушанные секунды, но не менее 5 секунд. Количество прослушанных секунд указывается в поле parts_count.

По умолчанию происходит тарификация за максимально возможное количество секунд (по длине аудиодорожки). В случае, если пользователь принял звонок, в поле parts_count будет указано фактическое количество прослушанных секунд (не менее 5), а разница в стоимости будет возвращена на баланс.

Параметры синтеза речи

Вы можете использовать параметры voice_voice, voice_speed и voice_emotion для изменения аудиодорожки звонка.

Пример запроса Voice с параметрами синтеза речи:

curl -X POST "https://cp.redsms.ru/api/message" \
-H "login: <USERNAME>" \
-H "ts: ts-value-42" \
-H "secret: $(echo -n 'ts-value-42<API_KEY>' | md5sum | awk '{print $1}')" \
-H "Content-type: application/json" \
-d '{
"route": "voice",
"from": "<VOICE_SENDER_NAME>",
"voice_voice": "jane",
"voice_speed": 0.9,
"voice_emotion": "good",
"to": "+79993332211",
"text": "Ваш код авторизации - 0 8 3 5. Повторяю - 0 8 3 5"
}'

# В OSX вместо команды md5sum необходимо использовать команду md5

Варианты голоса voice_voice

ЗначениеПолПример аудиодорожки
alyss👩 женский
erkanyavas👨 мужской
ermil👨 мужской
jane👩 женский
oksana👩 женский
omazh👩 женский
zahar👨 мужской

Скорость воспроизведения аудиодорожки voice_speed

Скорость воспроизведения поддерживается для всех вариантов голосов.

В таблице ниже приведены примеры разной скорости воспроизведения для голоса ermil.

ЗначениеПример аудиодорожки
0.5
1
2

Интонация голоса voice_emotion

Настройка интонации поддерживается только для голосов jane и omazh.

В таблице ниже приведены примеры разной интонации голоса jane.

ЗначениеПример аудиодорожки
good
neutral
evil