Links

Отправка FLASHCALL

Отправленное сообщение поступит абоненту в виде звонка; последние цифры номера соответствуют коду, переданному в сообщении.
post
https://direct.i-dgtl.ru/api
/v1/message
Отправка FLASHCALL-сообщений
Метод позволяет отправлять массив одиночных сообщений (от 1 до 1000)
Parameters
Header
Authorization*
string
Basic {TOKEN_1}
Content-Type*
string
application/json
Body
channelType*
string
Канал отправки (FLASHCALL)
senderName*
string
Имя отправителя. Допускается любая строка. Звонок будет произведен с номера телефона, последние цифры которого являются кодом подтверждения
destination*
string
Номер абонента
content*
string
Числовой код, 4 символа
ttl
integer
Время жизни сообщения в секундах. По истечении ttl сообщению присваивается финальный статус.
30ttl86400
tags
array
Теги сообщения (массив строк). Каждый тег должен соответствовать выражению ^\w+$ (допускаются буквы в любом регистре, цифры и нижнее подчеркивание "_")
callbackUrl
string
Адрес для отправки callback
callbackEvents
array
События, по которым будут отправлены callback (массив строк). При наличии callbackUrl и отсутствии callbackEvents в запросе, будет отправлен callback по событию delivered.
Responses
200
В случае успешного запроса возвращается ответ, в котором перечислены идентификаторы сообщений и коды результата. При значении errors = false гарантируется, что все переданные сообщения успешно созданы.
401
Использование невалидного токена / отсутствие заголовка авторизации
402: Payment Required
Недостаточно средств на балансе
403
Использование неподходящего токена
422
Невалидные параметры в теле запроса; ниже приведены несколько примеров ответа
Рекомендуемое время ожидания ответа: 70 секунд. Как правило, ответ на запрос возвращается не более чем за несколько секунд, но таймаут величиной в 70 секунд позволяет гарантированно получить ответ на запрос, в том числе в ситуациях повышенной нагрузки.
Возможные варианты перечислений:
Параметр
Варианты
callbackEvents

Пример запроса

JSON
cURL
POST https://direct.i-dgtl.ru/api/v1/message
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
[
{
"channelType": "FLASHCALL",
"senderName": "FLASHCALL",
"destination": "79818268484",
"content": "1234",
"callbackUrl": "https://company.com/callback",
"callbackEvents": [
"sent",
"delivered"
],
"ttl": 30
}
]
curl -X POST 'https://direct.i-dgtl.ru/api/v1/message' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
-d '[{"channelType":"FLASHCALL","senderName":"FLASHCALL","destination":"79818268484","content":"1234","callbackUrl":"https://company.com/callback","callbackEvents":["sent","delivered"],"ttl":30}]'
post
https://direct.i-dgtl.ru/api
/v1/flashcall-conversion
Отправка конверсии FLASHCALL
Возможные варианты перечислений:
Параметр
Варианты
result
Передача конверсии помогает нам улучшать качество отправки FLASHCALL-сообщений

Пример запроса

JSON
cURL
POST https://direct.i-dgtl.ru/api/v1/flashcall-conversion
Authorization: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
[
{
"messageUuid": "063464ec-a34f-4558-90c5-984395000004",
"result": "NUMBER_VERIFIED",
"code": "7777"
}
]
curl -X POST 'https://direct.i-dgtl.ru/api/v1/flashcall-conversion' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
-d '[{"messageUuid":"063464ec-a34f-4558-90c5-984395000004","result":"NUMBER_VERIFIED","code":"7777"}]'