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

Обновлено: 9 июня 2026

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

подсказка

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

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

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

к сведению

MAX

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

Отправка сообщений по номеру телефона возможна, если аккаунт получателя в MAX является публичным или в edna Pulse для него существует связка «номер телефона + maxId».

Вызов метода

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

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

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

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

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

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxContent": {
      "contentType": "IMAGE",
      "attachment": {
        "url": "https://example.com/images/promo.jpg",
        "name": "promo.jpg"
      },
      "text": "Добрый день! Обратите внимание на наше новое предложение!"
    }
  }
}

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

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxContent": {
      "contentType": "DOCUMENT",
      "attachment": {
        "url": "https://example.com/docs/contract.pdf",
        "name": "contract.pdf"
      },
      "text": "Пожалуйста, ознакомьтесь с документом"
    }
  }
}

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

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxContent": {
      "contentType": "VIDEO",
      "attachment": {
        "url": "https://example.com/video/promo.mp4",
        "name": "promo.mp4"
      },
      "text": "Смотрите наш новый ролик!"
    }
  }
}

Параметры maxContent

к сведению

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

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

Параметр	Тип данных	Характер	Описание
maxContent	object	Обязательный, если в шагах каскада используется канал MAX	Объект с информацией о содержимом сообщения, направляемого в канал MAX.
maxContent.contentType	string	Обязательный	Тип содержимого сообщения. Возможные значения: - TEXT — текст; - IMAGE — изображение; - VIDEO — видео; - DOCUMENT — документ.
maxContent.text	string	Обязательный, если maxContent.contentType = TEXT	Текст сообщения. Максимальная длина — 4000 символов. Может содержать эмодзи.
maxContent.attachment	object	Обязательный, если maxContent.contentType = IMAGE, VIDEO или DOCUMENT	Объект с информацией о вложении — изображение, видео или документ.
maxContent.attachment.url	string	Обязательный, если maxContent.contentType = IMAGE, VIDEO или DOCUMENT	Общедоступный URL-адрес вложения — изображения, видео или документа. Максимальная длина — 4096 символов на стороне edna Pulse.
maxContent.attachment.name	string	Обязательный, если maxContent.contentType = IMAGE, VIDEO или DOCUMENT	Имя файла — изображения, видео или документа. Не отображается на устройстве получателя. Максимальная длина — 4096 символов на стороне edna Pulse.

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

к сведению

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

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

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

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

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

{
  "requestId": "test-003",
  "cascadeId": 3,
  "subscriberFilter": {
    "address": "123456789", 
    "type": "MAX_ID"
  },
  "ttl": "PT1M",
  "content": {
    "maxContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста двухшагового каскада MAX → WhatsApp"
    },
    "whatsappContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста двухшагового каскада MAX → WhatsApp"
    }
  }
}

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

{
  "requestId": "test-004",
  "cascadeId": 4,
  "subscriberFilter": {
    "address": "123456789", 
    "type": "MAX_ID"
  },
  "ttl": "PT1M",
  "content": {
    "maxContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста двухшагового каскада MAX → Viber"
    },
    "viberContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста двухшагового каскада MAX → Viber"
    }
  }
}

Сообщение с текстом, трёхшаговый каскад MAX → WhatsApp → SMS

{
  "requestId": "test-005",
  "cascadeId": 5,
  "subscriberFilter": {
    "address": "123456789", 
    "type": "MAX_ID"
  },
  "ttl": "PT1M",
  "content": {
    "maxContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста трёхшагового каскада MAX → WhatsApp → SMS"
    },
    "whatsappContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста трёхшагового каскада MAX → WhatsApp → SMS"
    },
    "smsContent": {
      "contentType": "TEXT",
      "text": "Привет! Это сообщение для теста трёхшагового каскада MAX → WhatsApp → SMS"
    } 
  }
}

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

{
   "requestId": "string"
}

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

{
    "requestId": "test-001"
}

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

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