Отправка TELEGRAM
Для получения возможности отправки TELEGARAM-сообщений необходимо:
  1. 1.
    Создать TELEGRAM-бота (инструкция)
  2. 2.
    Добавить TELEGRAM-бота в ЛК Direct
  3. 3.
    Попросить абонентов запустить бота и поделиться с ним номером телефона
После этого всем абонентам, которые поделились номером телефона с ботом, получится доставить TELEGRAM-сообщение
post
https://direct.i-dgtl.ru/api
/v1/message
Отправка TELEGRAM-сообщений
Рекомендуемое время ожидания ответа: 70 секунд. Как правило, ответ на запрос возвращается не более чем за несколько секунд, но таймаут величиной в 70 секунд позволяет гарантированно получить ответ на запрос, в том числе в ситуациях повышенной нагрузки.
Для использования личного домена в сокращенных ссылках необходимо обратиться в поддержку
Возможные варианты перечислений:
Параметр
Варианты

Текстовое сообщение

Текстовое TELEGRAM-сообщение, помимо текста, может содержать кнопки с ссылками
Для отправки текстового TELEGRAM-сообщения используется следующий объект content:
{
"contentType": "text",
"text": "Текст TELEGRAM-сообщения",
"inlineKeyboard": [
[
{
"text": "текст кнопки 1",
"url": "https://i-dgtl.ru/1"
},
{
"text": "текст кнопки 2",
"url": "https://i-dgtl.ru/2"
}
],
[
{
"text": "текст кнопки 3",
"url": "https://i-dgtl.ru/3"
},
{
"text": "текст кнопки 4",
"url": "https://i-dgtl.ru/4"
}
]
]
}
Параметр
Тип
Описание
contentType
string
required
Тип контента (text)
text
string
required
Текст сообщения; строка в кодировке UTF-8 без Byte Order Mark
От 1 до 4096 символов
inlineKeyboard
array (arrays) optional
Массив с массивами объектов кнопок Каждый вложенный массив является отдельной строкой из кнопок. Допускается отправка не более чем 10 вложенных массивов, в каждом из которых не более 10 объектов
inlineKeyboard.text
string optonal
Текст кнопки; от 1 до 50 символов
inlineKeyboard.url
string optional
Ссылка, на которую происходит переход при нажатии на кнопку; от 1 до 1000 символов
Вы можете форматировать текст сообщения:
  • Для полужирного шрифта нужны две звездочки слева и справа от фрагмента. **text** → text
  • Для курсива понадобятся по два знака нижнего подчеркивания слева и справа. __text__ → text
  • Чтобы сделать текст моноширинным, оберните его в тройные апострофы. '''text'''→ text
  • Для переноса текста на новую строку используйте символ \n.

Сообщение с изображением

Для отправки TELEGRAM-сообщения с изображением используется следующий объект content:
{
"contentType": "image",
"imageUrl": "https://image.png",
"caption": "Подпись к изображению",
"inlineKeyboard": [
[
{
"text": "текст кнопки 1",
"url": "https://i-dgtl.ru/1"
},
{
"text": "текст кнопки 2",
"url": "https://i-dgtl.ru/2"
}
],
[
{
"text": "текст кнопки 3",
"url": "https://i-dgtl.ru/3"
},
{
"text": "текст кнопки 4",
"url": "https://i-dgtl.ru/4"
}
]
]
}
Параметр
Тип
Описание
contentType
string
required
Тип контента (image)
imageUrl
string
required
Ссылка на изображение
caption
string optional
Подпись к изображению; до 1024 символов
inlineKeyboard
array (arrays) optional
Массив с массивами объектов кнопок Каждый вложенный массив является отдельной строкой из кнопок. Допускается отправка не более чем 10 вложенных массивов, в каждом из которых не более 10 объектов
inlineKeyboard.text
string optonal
Текст кнопки; от 1 до 50 символов
inlineKeyboard.url
string optional
Ссылка, на которую происходит переход при нажатии на кнопку; от 1 до 1000 символов

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

JSON
cURL
POST https://direct.i-dgtl.ru/api/v1/message
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
[
{
"senderName": "i-digital_bot",
"channelType": "TELEGRAM",
"content": {
"contentType": "text",
"text": "Текст TELEGRAM-сообщения",
"inlineKeyboard": [
[
{
"text": "текст кнопки 1",
"url": "https://i-dgtl.ru/1"
},
{
"text": "текст кнопки 2",
"url": "https://i-dgtl.ru/2"
}
],
[
{
"text": "текст кнопки 3",
"url": "https://i-dgtl.ru/3"
},
{
"text": "текст кнопки 4",
"url": "https://i-dgtl.ru/4"
}
]
]
},
"destination": "79999999999",
"localSendTime": "2022-06-15 18:00:00",
"localCompletionTime": "2022-06-16 21:00:00",
"shortUrl": true,
"callbackUrl": "https://company.com/callback",
"callbackEvents": [
"delivered",
"click"
],
"useLocalTime": true,
"ttl": 43200,
"hours": [
12,
13,
14,
15,
16,
17,
18,
19,
20,
21
],
"days": [
1,
2,
3,
4,
5,
6,
7
],
"tags": [
"tag1",
"tag2"
]
}
]
curl -X POST 'https://direct.i-dgtl.ru/api/v1/message' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
-d '[{"senderName":"i-digital_bot","channelType":"TELEGRAM","content":{"contentType":"text","text":"Текст TELEGRAM-сообщения","inlineKeyboard":[[{"text":"текст кнопки 1","url":"https://i-dgtl.ru/1"},{"text":"текст кнопки 2","url":"https://i-dgtl.ru/2"}],[{"text":"текст кнопки 3","url":"https://i-dgtl.ru/3"},{"text":"текст кнопки 4","url":"https://i-dgtl.ru/4"}]]},"destination":"79999999999","localSendTime":"2022-06-15 18:00:00","localCompletionTime":"2022-06-16 21:00:00","shortUrl":true,"callbackUrl":"https://company.com/callback","callbackEvents":["delivered","click"],"useLocalTime":true,"ttl":43200,"hours":[12,13,14,15,16,17,18,19,20,21],"days":[1,2,3,4,5,6,7],"tags":["tag1","tag2"]}]'