Перейти к основному содержимому

Отправка сообщений в канал 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"
}
}

Параметры запроса​

ПараметрТип данныхХарактерОписание
outMessageIdstringНеобязательныйВнутренний идентификатор исходящего сообщения.
fromstringОбязательныйНазвание канала.
Чтобы узнать название канала, используйте метод API для получения списка каналов — параметр subject. File IconПолучение списка каналов
toobjectОбязательныйОбъект с информацией об адресе получателя.
to.valuestringОбязательныйАдрес получателя — номер телефона или идентификатор пользователя в Telegram. Номер телефона в соответствии с форматом стандарта E.164.
Паттерн стандарта: ^+[1-9]\d{1,14}$. Международный телекоммуникационный план нумерации E.164
Чтобы узнать адрес получателя, используйте метод API для запроса данных получателей — параметр addresses.address. File IconЗапрос данных получателей
to.typestringОбязательныйТип идентификатора получателя.
Возможные значения:
- PHONE — номер телефона получателя;
- TELEGRAM_ID — идентификатор пользователя в Telegram.
contentobjectОбязательныйОбъект с информацией о содержимом сообщения.
content.typestringОбязательныйТип содержимого сообщения.
Возможные значения:
- TEXT — текстовое сообщение;
- IMAGE — изображение;
- DOCUMENT — документ;
- VIDEO — видео;
- AUDIO — аудио;
- LOCATION — геолокация.
content.urlstringОбязательный, если content.type = IMAGE, VIDEO, AUDIO или DOCUMENTОбщедоступный URL-адрес вложения — изображения, видео, аудио или документа.
Максимальная длина — 1000 символов.
Поддерживается только протокол HTTPS.
content.namestringНеобязательныйИмя файла — изображения, видео, аудио или документа. Не отображается на устройстве получателя.
Максимальная длина — 25 символов.
content.latitudestringОбязательный, если content.type = LOCATIONКоординаты (широта). Диапазон значений — от -90.000000 до 90.000000.
Поддерживается до 6 знаков после запятой.
content.longitudestringОбязательный, если content.type = `LOCATIONКоординаты (долгота). Диапазон значений — от -180.000000 до 180.000000.
Поддерживается до 6 знаков после запятой.
optionsobjectНеобязательныйОбъект с информацией о дополнительных параметрах настройки сообщения.
options.sendDelaystringНеобязательныйДата и время в формате ISO 8601 Duration (например, 2024-07-01T00:00:00Z), раньше которого сообщение не будет отправлено.

Используется при отложенной отправке. ISO 8601 - Durations
Допустимое значение — не более 2 недель.
options.commentstringНеобязательныйЛюбой комментарий к сообщению. Максимальная длина — 256 символов.
Не отображается на устройстве получателя.

Отображается в отчёте по сообщениям в личном кабинете и в ответе метода API для получения истории сообщений — параметр comment. File IconПолучение истории сообщений
options.prioritystringНеобязательныйПриоритет сообщения.
Возможные значения:
- LOW — низкий приоритет;
- NORMAL — средний приоритет;
- HIGH — высокий приоритет;
- REALTIME — доставка в режиме реального времени.

Пример ответа​

Ответ при отправке сообщения по номеру телефона​

{
"outMessageId": "c1e34af5-da98-6e0a-945d-18db30fde070",
"phone": "+79000000000"
}

Ответ при отправке сообщения по TELEGRAM_ID​

{
"outMessageId": "c699c7bd-af08-43f3-ae4c-b54765f38f8f",
"telegramId": "1234567890"
}

Параметры ответа​

ПараметрТип данныхОписание
outMessageIdstringВнутренний идентификатор исходящего сообщения.
phonestringАдрес получателя — номер телефона в соответствии с форматом стандарта E.164.
Паттерн стандарта: ^+[1-9]\d{1,14}$. Международный телекоммуникационный план нумерации E.164
В ответе возвращается идентификатор получателя, указанный в качестве адреса при отправке сообщения.
telegramIdstringАдрес получателя — идентификатор пользователя в Telegram.
В ответе возвращается идентификатор получателя, указанный в качестве адреса при отправке сообщения.