Отправка сообщений по каскаду в канал Telegram

Обновлено: 20 октября 2026

Для отправки сообщений в канал Telegram через каскад используется метод api/cascade/schedule.

подсказка

В этой статье описана отправка сообщений по каскаду с использование метода api/cascade/schedule и объекта telegramContent.

Подробную информацию о методе api/cascade/schedule смотрите в статье:

Отправка сообщений по каскаду

к сведению

Telegram Метод поддерживает отправку сообщений в Telegram как по номеру телефона, так и по идентификатору пользователя — TELEGRAM_ID.

Вызов метода

Чтобы отправить сообщение в канал Telegram через каскад по методу api/cascade/schedule, отправьте POST-запрос на URL-адрес https://app.edna.ru/api/cascade/schedule.

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

Сообщение с текстом

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "TELEGRAM_ID"
  },
  "startTime": "2026-09-10T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "telegramContent": {
      "contentType": "TEXT",
      "text": "Привет! Это моё первое сообщение в Telegram, отправленное по каскаду"
    }
  }
}

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

{
  "requestId": "test-002",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "79000000000",
    "type": "PHONE"
  },
  "ttl": "PT1M",
  "content": {
    "telegramContent": {
      "contentType": "IMAGE",
      "attachment": {
        "url": "https://example.com/images/promo.jpg",
        "name": "promo.jpg"
      },
      "text": "Добрый день! Обратите внимание на наше новое предложение!"
    }
  }
}

Сообщение с текстом и документом

{
  "requestId": "test-003",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "TELEGRAM_ID"
  },
  "ttl": "PT1M",
  "content": {
    "telegramContent": {
      "contentType": "DOCUMENT",
      "attachment": {
        "url": "https://example.com/docs/contract.pdf",
        "name": "contract.pdf"
      },
      "text": "Пожалуйста, ознакомьтесь с документом"
    }
  }
}

Сообщение с геолокацией

{
  "requestId": "test-005",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "TELEGRAM_ID"
  },
  "ttl": "PT1M",
  "content": {
    "telegramContent": {
      "contentType": "LOCATION",
      "location": {
        "longitude": 37.617635,
        "latitude": 55.755819
      },
      "text": "Наш офис находится здесь"
    }
  }
}

Параметры telegramContent

к сведению

Подробную информацию об общих параметрах метода api/cascade/schedule смотрите в статье:

Отправка сообщений по каскаду: Общие параметры

Параметр	Тип данных	Характер	Описание
telegramContent	object	Обязательный, если в шагах каскада используется канал Telegram	Объект с информацией о содержимом сообщения, направляемого в канал Telegram.
contentType	string	Обязательный	Тип содержимого сообщения. Возможные значения: - TEXT — текст; - IMAGE — изображение; - VIDEO — видео; - DOCUMENT — документ; - AUDIO — аудио; - LOCATION — геолокация.
text	string	Обязательный, если contentType = TEXT	Текст сообщения. Максимальная длина при наличии вложения — 1024 символов. Может содержать эмодзи.
attachment	object	Обязательный, если contentType = IMAGE, VIDEO, DOCUMENT или AUDIO	Объект с информацией о вложении — изображение, видео, аудио или документ.
attachment.url	string	Обязательный, если contentType = IMAGE, VIDEO, DOCUMENT или AUDIO	Общедоступный URL-адрес вложения — изображения, видео, аудио или документа. Максимальная длина — 4096 символов.
attachment.name	string	Обязательный, если contentType = IMAGE, VIDEO, DOCUMENT или AUDIO	Имя файла — изображения, видео, аудио или документа. Не отображается на устройстве получателя. Максимальная длина — 4096 символов.
location	object	Обязательный, если contentType = LOCATION	Объект с информацией о геолокации.
location.latitude	string	Обязательный, если contentType = LOCATION	Координаты (широта). Диапазон значений — от −90.000000 до 90.000000. Поддерживается до 6 знаков после запятой.
location.longitude	string	Обязательный, если contentType = LOCATION	Координаты (долгота). Диапазон значений — от −180.000000 до 180.000000. Поддерживается до 6 знаков после запятой.

Примеры отправки сообщений по каскаду в несколько каналов

к сведению

Каскад может включать любое количество шагов — по числу зарегистрированных в edna Pulse каналов, включая каналы одного типа.

Каждый шаг каскада может содержать сообщение с типом контента, отличным от сообщения на предыдущем шаге.

Сообщение с текстом, двухшаговый каскад Telegram → SMS

{
  "requestId": "test-007",
  "cascadeId": 2,
  "subscriberFilter": {
    "address": "79000000000",
    "type": "PHONE"
  },
  "ttl": "PT1M",
  "content": {
    "telegramContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста двухшагового каскада Telegram → SMS"
    },
    "smsContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста двухшагового каскада Telegram → SMS"
    }
  }
}

Формат ответа

{
   "requestId": "string"
}

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

{
    "requestId": "test-001"
}

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

Параметр	Тип данных	Описание
requestId	string	Внутренний идентификатор исходящего сообщения. Был сгенерирован внешней системой клиента при отправке сообщения.