Отправка сообщений в канал Telegram
Обновлено: 9 ноября 2026
Для отправки сообщений в канал Telegram используется метод /api/v1/out-messages/telegram.
Вызов метода
Чтобы отправить сообщение в канал Telegram по методу /api/v1/out-messages/telegram, отправьте POST-запрос на URL-адрес:
https://app.edna.ru/api/v1/out-messages/telegram
Примеры запросов
Сообщение с текстом и отправкой по номеру телефона
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"from": "Telegram_test_sender",
"to": {
"value": "+79000000000",
"type":"PHONE"
},
"content": {
"type": "TEXT",
"text": "Добрый день! Рады представить наш новый канал для коммуникаций — Telegram"
}
}
Сообщение с текстом и отправкой по TELEGRAM_ID
{
"outMessageId": "c699c7bd-af08-43f3-ae4c-b54765f38f8f",
"from": "Telegram_test_sender",
"to": {
"value": "1234567890",
"type":"TELEGRAM_ID"
},
"content": {
"type": "TEXT",
"text": "Добрый день! Отправка сообщения по TELEGRAM_ID — Telegram"
}
}
Сообщение с отложенной отправкой
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"from": "Telegram_test_sender",
"to": {
"value": "+79000000000",
"type": "PHONE"
},
"content": {
"type": "TEXT",
"text": "Добрый день! Это отложенная отправка сообщения — 2 минуты"
},
"options": {
"sendDelay": "PT2M",
"priority": "NORMAL",
"comment": "Сообщение с отложенной отправкой - 2026-10-22T08:01:15.851Z sendDelay PT2M"
}
}
Сообщение с изображением
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"from": "Telegram_test_sender",
"to": {
"value": "+79000000000",
"type":"PHONE"
},
"content": {
"type": "IMAGE",
"name": "Изображение",
"url": "https://avatarko.ru/img/kartinka/33/multfilm_lyagushka_32117.jpg"
}
}
Сообщение с документом
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"from": "Telegram_test_sender",
"to": {
"value": "+79000000000",
"type":"PHONE"
},
"content": {
"type": "DOCUMENT",
"name": "Документ",
"url": "https://pdfobject.com/pdf/sample.pdf"
}
}
Сообщение с видео
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"from": "Telegram_test_sender",
"to": {
"value": "+79000000000",
"type":"PHONE"
},
"content": {
"type": "VIDEO",
"name": "Видео 5 МБ",
"url": "https://samplelib.com/mp4/sample-10s-720p.mp4"
}
}
Сообщение с аудио
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"from": "Telegram_test_sender",
"to": {
"value": "+79000000000",
"type":"PHONE"
},
"content": {
"type": "AUDIO",
"name":"Аудиозапись",
"url": "https://samplelib.com/mp4/sample-10s-2160p.mp4"
}
}
Сообщение с геолокацией
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"from": "Telegram_test_sender",
"to": {
"value": "+79000000000",
"type":"PHONE"
},
"content": {
"type": "LOCATION",
"latitude": "97.421999",
"longitude": "-122.084067"
}
}
Параметры запроса
| Параметр | Тип данных | Характер | Описание |
|---|---|---|---|
outMessageId | string | Необязательный | Внутренний идентификатор исходящего сообщения. |
from | string | Обязательный | Название канала.
Чтобы узнать название канала, используйте метод API для получения списка каналов — параметр subject.
Получение списка каналов |
to | object | Обязательный | Объект с информацией об адресе получателя. |
to.value | string | Обязательный | Адрес получателя — номер телефона или идентификатор пользователя в Telegram. Номер телефона в соответствии с форматом стандарта E.164.
Паттерн стандарта: ^+[1-9]\d{1,14}$. Чтобы узнать адрес получателя, используйте метод API для запроса данных получателей — параметр addresses.address.
Запрос данных получателей |
to.type | string | Обязательный | Тип идентификатора получателя.
Возможные значения: - PHONE — номер телефона получателя;
- TELEGRAM_ID — идентификатор пользователя в Telegram. |
content | object | Обязательный | Объект с информацией о содержимом сообщения. |
content.type | string | Обязательный | Тип содержимого сообщения.
Возможные значения: - TEXT — текстовое сообщение;
- IMAGE — изображение;
- DOCUMENT — документ;
- VIDEO — видео;
- AUDIO — аудио;
- LOCATION — геолокация. |
content.url | string | Обязательный, если content.type = IMAGE, VIDEO, AUDIO или DOCUMENT | Общедоступный URL-адрес вложения — изображения, видео, аудио или документа.
Максимальная длина — 1000 символов. Поддерживается только протокол HTTPS. |
content.name | string | Необязательный | Имя файла — изображения, видео, аудио или документа. Не отображается на устройстве получателя.
Максимальная длина — 25 символов. |
content.latitude | string | Обязательный, если content.type = LOCATION | Координаты (широта). Диапазон значений — от -90.000000 до 90.000000.
Поддерживается до 6 знаков после запятой. |
content.longitude | string | Обязательный, если content.type = `LOCATION | Координаты (долгота). Диапазон значений — от -180.000000 до 180.000000.
Поддерживается до 6 знаков после запятой. |
options | object | Необязательный | Объект с информацией о дополнительных параметрах настройки сообщения. |
options.sendDelay | string | Необязательный | Дата и время в формате ISO 8601 Duration (например, 2024-07-01T00:00:00Z), раньше которого сообщение не будет отправлено. Используется при отложенной отправке. Допустимое значение — не более 2 недель. |
options.comment | string | Необязательный | Любой комментарий к сообщению. Максимальная длина — 256 символов.
Не отображается на устройстве получателя. Отображается в отчёте по сообщениям в личном кабинете и в ответе метода API для получения истории сообщений — параметр comment. Получение истории сообщений |
options.priority | string | Необязательный | Приоритет сообщения.
Возможные значения: - LOW — низкий приоритет;
- NORMAL — средний приоритет;
- HIGH — высокий приоритет;
- REALTIME — доставка в режиме реального времени. |
Пример ответа
Ответ при отправке сообщения по номеру телефона
{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"phone": "+79000000000"
}
Ответ при отправке сообщения по TELEGRAM_ID
{
"outMessageId": "c699c7bd-af08-43f3-ae4c-b54765f38f8f",
"telegramId": "1234567890"
}
Параметры ответа
| Параметр | Тип данных | Описание |
|---|---|---|
outMessageId | string | Внутренний идентификатор исходящего сообщения. |
phone | string | Адрес получателя — номер телефона в соответствии с форматом стандарта E.164.
Паттерн стандарта: ^+[1-9]\d{1,14}$. В ответе возвращается идентификатор получателя, указанный в качестве адреса при отправке сообщения. |
telegramId | string | Адрес получателя — идентификатор пользователя в Telegram.
В ответе возвращается идентификатор получателя, указанный в качестве адреса при отправке сообщения. |