Отправка TELEGRAM

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

Одиночные сообщения - Previous

Отправка WHATSAPP

Next - Одиночные сообщения

Отправка VK

Last modified 1mo ago

Copy link

On this page

post

Отправка TELEGRAM-сообщений

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

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

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