Одиночные сообщения
Имена отправителей
Дополнительно
Отправка TELEGRAM
Для получения возможности отправки TELEGARAM-сообщений необходимо:
- 1.
- 2.
- 3.Попросить абонентов запустить бота и поделиться с ним номером телефона
После этого всем абонентам, которые поделились номером телефона с ботом, получится доставить TELEGRAM-сообщение
post
https://direct.i-dgtl.ru/api
/v1/message
Отправка TELEGRAM-сообщений
Рекомендуемое минимальное время таймаута: 70 секунд
Для использования личного домена в сокращенных ссылках необходимо обратиться в поддержку
Возможные варианты перечислений:
Параметр
Варианты
callbackEvents
Текстовое сообщение
Текстовое TELEGRAM-сообщение, помимо текста, может содержать кнопки с ссылками
Для отправки текстового TELEGRAM-сообщения используется следующий объект
content:1
{
2
"contentType": "text",
3
"text": "Текст TELEGRAM-сообщения",
4
"inlineKeyboard": [
5
[
6
{
7
"text": "текст кнопки 1",
8
"url": "https://i-dgtl.ru/1"
9
},
10
{
11
"text": "текст кнопки 2",
12
"url": "https://i-dgtl.ru/2"
13
}
14
],
15
[
16
{
17
"text": "текст кнопки 3",
18
"url": "https://i-dgtl.ru/3"
19
},
20
{
21
"text": "текст кнопки 4",
22
"url": "https://i-dgtl.ru/4"
23
}
24
]
25
]
26
}
Copied!
Параметр
Тип
Описание
contentType
string
required
Тип контента (
text)text
string
required
Текст сообщения; строка в кодировке UTF-8 без Byte Order Mark
От 1 до 5000 символов
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:1
{
2
"contentType": "image",
3
"imageUrl": "https://image.png",
4
"caption": "Подпись к изображению",
5
"inlineKeyboard": [
6
[
7
{
8
"text": "текст кнопки 1",
9
"url": "https://i-dgtl.ru/1"
10
},
11
{
12
"text": "текст кнопки 2",
13
"url": "https://i-dgtl.ru/2"
14
}
15
],
16
[
17
{
18
"text": "текст кнопки 3",
19
"url": "https://i-dgtl.ru/3"
20
},
21
{
22
"text": "текст кнопки 4",
23
"url": "https://i-dgtl.ru/4"
24
}
25
]
26
]
27
}
Copied!
Параметр
Тип
Описание
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
1
POST https://direct.i-dgtl.ru/api/v1/message
2
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
3
Content-Type: application/json
4
[
5
{
6
"senderName": "i-digital_bot",
7
"channelType": "TELEGRAM",
8
"content": {
9
"contentType": "text",
10
"text": "Текст TELEGRAM-сообщения",
11
"inlineKeyboard": [
12
[
13
{
14
"text": "текст кнопки 1",
15
"url": "https://i-dgtl.ru/1"
16
},
17
{
18
"text": "текст кнопки 2",
19
"url": "https://i-dgtl.ru/2"
20
}
21
],
22
[
23
{
24
"text": "текст кнопки 3",
25
"url": "https://i-dgtl.ru/3"
26
},
27
{
28
"text": "текст кнопки 4",
29
"url": "https://i-dgtl.ru/4"
30
}
31
]
32
]
33
},
34
"destination": "79999999999",
35
"localSendTime": "2022-06-15 18:00:00",
36
"localCompletionTime": "2022-06-16 21:00:00",
37
"shortUrl": true,
38
"callbackUrl": "https://company.com/callback",
39
"callbackEvents": [
40
"delivered",
41
"click"
42
],
43
"useLocalTime": true,
44
"ttl": 43200,
45
"hours": [
46
12,
47
13,
48
14,
49
15,
50
16,
51
17,
52
18,
53
19,
54
20,
55
21
56
],
57
"days": [
58
1,
59
2,
60
3,
61
4,
62
5,
63
6,
64
7
65
],
66
"tags": [
67
"tag1",
68
"tag2"
69
]
70
}
71
]
Copied!
1
curl -X POST 'https://direct.i-dgtl.ru/api/v1/message' \
2
-H 'Content-Type: application/json' \
3
-H 'Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==' \
4
-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"]}]'
Copied!