Flash Call и Voice Password¶
Услуги Flash Call и Voice Password используются для отправки кодов двухфакторной авторизации. У пользователя запрашивается код подтверждения, и затем, в течение 10 секунд после запроса, на телефон пользователя поступает звонок.
Код подтверждения может поступить в двух форматах:
- Flash Call: Пользователь указывает в виде проверочного кода 4 последние цифры номера, с которого поступил звонок.
- Voice Password: Пользователь отвечает на звонок и слушает проверочный код, который произносит робот.
Коды подтверждения можно отправить с помощью вызовов стандартных API-запросов для SMS-рассылок.
Подключение¶
Чтобы использовать услуги Flash Call и Voice Password, вы должны быть зарегистрированы на платформе Devino Telecom.
Если вы хотите подключить две услуги одновременно, у вашей компании должны быть две учетные записи: к одной учетной записи будет привязан Flash Call, к другой – Voice Password.
Свяжитесь с вашим менеджером компании Devino Telecom или технической поддержкой для получения доступа.
Отправка кода подтверждения по HTTP¶
Для отправки кодов подтверждения Flash Call или Voice Password (в зависимости от настроек имени отправителя) необходимо вызвать POST https://integrationapi.net/rest/v2/Sms/Send, передавая необходимые параметры и данные авторизации.
Параметры запроса¶
В данном методе все параметры обязательны.
| Параметр | Тип данных | Описание |
|---|---|---|
| Login | string | Логин, полученный при регистрации. |
| Password | string | Пароль, соответствующий логину. |
| DestinationAddress | string | Номер телефона в международном формате, согласно стандарту E.164. На данный номер телефона поступит звонок. Примеры: |
| Data | string | Текст сообщения. В данном случае указываются только 4 цифры кода. При авторизации по 4 последним цифрам номера телефона (Flash Call) оператор автоматически подбирает подходящий номер телефона. |
| SourceAddress | string | Имя отправителя. Необходимо использовать имя отправителя, полученное от вашего менеджера при подключении услуги. |
Пример запроса¶
curl -X GET https://integrationapi.net/rest/v2/Sms/Send?Login=User&Password=Password&DestinationAddress=79854753323&Data=1336&SourceAddress=mysourceaddress \
--header 'Content-Type: multipart/form-data'
Параметры ответа¶
| Параметр | Тип данных | Описание |
|---|---|---|
| result | array[string] | ID отправленного сообщения. |
Пример ответа¶
["1076768631340138496"]
Статусы сообщений¶
Статус сообщения можно получить через метод получения статусов.
Для сообщений Flash Call и Voice Password доступны следующие статусы:
| Статус | Описание |
|---|---|
| DELIVERED | Случаи получения статуса: ○ Клиент сбросил полученный звонок. |
| UNDELIVERED | Случаи получения статуса: ○ Клиент был вне зоны действия сети и не получил звонок. |
Отправка кода подтверждения по SMPP¶
Отправка кодов подтверждений Flash Call и Voice Password по протоколу SMPP не отличается от отправки SMS. Однако необходимо соблюдать следующие условия:
- При использовании PDU submit_sm, то есть, при отправке сообщения, в параметре source_addr всегда должно быть указано имя отправителя, полученное от вашего менеджера при подключении услуги.
- В тексте сообщения может быть указано только 4 цифры кода, без дополнительного текста.
- Отправлять коды подтверждения можно только по IP-адресам для рекламных рассылок, так как Flash Call и Voice Password не поддерживают транзакционные рассылки.