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

Обновлено: 24 апреля 2026

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

к сведению

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

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

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

Вызов метода

Чтобы отправить сообщение в канал MAX Bot через каскад по методу 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": {
    "maxBotContent": {
      "contentType": "TEXT",
      "text": "Привет! Это моё первое сообщение в MAX Bot, отправленное по каскаду"
    }
  }
}

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

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "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": {
    "maxBotContent": {
      "contentType": "DOCUMENT",
      "attachment": {
        "url": "https://example.com/docs/contract.pdf",
        "name": "contract.pdf"
      },
      "caption": "Договор оферты",
      "text": "Пожалуйста, ознакомьтесь с документом"
    }
  }
}

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

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

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

к сведению

Текст на устройстве получателя будет отображаться отдельным сообщением.

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "AUDIO",
      "attachment": {
        "url": "https://example.com/audio/message.mp3",
        "name": "message.mp3"
      },
      "text": "Аудиосообщение от нашего сервиса"
    }
  }
}

Голосовое сообщение с текстом

к сведению

Текст на устройстве получателя будет отображаться отдельным сообщением.

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "VOICE",
      "attachment": {
        "url": "https://example.com/voice/greeting.ogg",
        "name": "greeting.ogg"
      },
      "text": "Добрый день! Ответили на Ваши вопросы в голосовом сообщении"
    }
  }
}

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

к сведению

Текст на устройстве получателя будет отображаться отдельным сообщением.

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "LOCATION",
      "location": {
        "longitude": 37.617635,
        "latitude": 55.755819
      },
      "text": "Наш офис находится здесь"
    }
  }
}

Сообщение с текстом и кнопкой-ссылкой

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "BUTTON",
      "caption": "Открыть сайт",
      "action": "https://example.com/promo",
      "text": "Перейдите на наш сайт для подробностей"
    }
  }
}

Сообщение с текстом и клавиатурой — кнопка-ссылка

к сведению

Клавиатура может содержать до 30 кнопок в одном сообщении, не более трёх кнопок в одном ряду.

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "KEYBOARD",
      "text": "Добрый день! Ознакомьтесь с нашими продуктами",
      "keyboard": {
        "rows": [
          {
            "buttons": [
              {
                "type": "URL",
                "text": "edna Pulse",
                "url": "https://docs-pulse.edna.ru/"
              },
              {
                "type": "URL",
                "text": "edna Chat Center",
                "url": "https://docs-chatcenter.edna.ru/"
              },
              {
                "type": "URL",
                "text": "edna Prisma",
                "url": "https://docs-enterprise.edna.ru/"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "URL",
                "text": "Продукт 1",
                "url": "https://edna.ru/whatsapp-chat-bot/"
              },
              {
                "type": "URL",
                "text": "Продукт 2",
                "url": "https://edna.ru/chat-center/"
              },
              {
                "type": "URL",
                "text": "Продукт 3",
                "url": "https://edna.ru/imsi/"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "URL",
                "text": "Продукт 4",
                "url": "https://edna.ru/newsletters/"
              },
              {
                "type": "URL",
                "text": "Продукт 5",
                "url": "https://edna.ru/chatflow/"
              },
              {
                "type": "URL",
                "text": "Продукт 6",
                "url": "https://edna.ru/notifications/"
              }
            ]
          }
        ]
      }
    }
  }
}

Сообщение с текстом и клавиатурой — кнопка отправки текста в чат

к сведению

Клавиатура может содержать до 30 кнопок в одном сообщении, не более трёх кнопок в одном ряду.

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "KEYBOARD",
      "text": "Добрый день! Ознакомьтесь с нашими предложениями",
      "keyboard": {
        "rows": [
          {
            "buttons": [
              {
                "type": "TEXT",
                "text": "Расскажите подробнее"
              },
              {
                "type": "TEXT",
                "text": "Всё понятно"
              },
              {
                "type": "TEXT",
                "text": "Не интересно"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "TEXT",
                "text": "Напишите позже"
              },
              {
                "type": "TEXT",
                "text": "Напишу позже"
              },
              {
                "type": "TEXT",
                "text": "Подумаю над вашим предложением"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "TEXT",
                "text": "Позовите менеджера"
              },
              {
                "type": "TEXT",
                "text": "Хочу забронировать"
              },
              {
                "type": "TEXT",
                "text": "Хочу узнать детали"
              }
            ]
          }
        ]
      }
    }
  }
}

Сообщение с текстом и клавиатурой — кнопка быстрого ответа (callback)

к сведению

Клавиатура может содержать до 30 кнопок в одном сообщении, не более трёх кнопок в одном ряду.

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "KEYBOARD",
      "text": "Добрый день! Ознакомьтесь с нашими предложениями",
      "keyboard": {
        "rows": [
          {
            "buttons": [
              {
                "type": "CALLBACK",
                "text": "Хочу забронировать",
                "payload": "01"
              },
              {
                "type": "CALLBACK",
                "text": "Хочу узнать детали",
                "payload": "02"
              },
              {
                "type": "CALLBACK",
                "text": "Позвать менеджера",
                "payload": "03"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "CALLBACK",
                "text": "Рассказать подробнее",
                "payload": "04"
              },
              {
                "type": "CALLBACK",
                "text": "Всё понятно",
                "payload": "05"
              },
              {
                "type": "CALLBACK",
                "text": "Подумаю над вашим предложением",
                "payload": "06"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "CALLBACK",
                "text": "Написать позже",
                "payload": "07"
              },
              {
                "type": "CALLBACK",
                "text": "Я напишу позже",
                "payload": "08"
              },
              {
                "type": "CALLBACK",
                "text": "Не интересно",
                "payload": "09"
              }
            ]
          }
        ]
      }
    }
  }
}

Сообщение с текстом и клавиатурой — кнопка запроса геолокации

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "KEYBOARD",
      "text": "Для доставки нам нужна ваша геолокация",
      "keyboard": {
        "rows": [
          {
            "buttons": [
              {
                "type": "LOCATION",
                "text": "Поделиться геолокацией"
              }
            ]
          }
        ]
      }
    }
  }
}

Сообщение с текстом и клавиатурой — кнопка запроса контакта

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "KEYBOARD",
      "text": "Оставьте свой номер телефона, чтобы мы могли связаться с Вами",
      "keyboard": {
        "rows": [
          {
            "buttons": [
              {
                "type": "CONTACT",
                "text": "Поделиться контактом"
              }
            ]
          }
        ]
      }
    }
  }
}

Сообщение с текстом и клавиатурой — все типы кнопок

{
  "requestId": "test-001",
  "cascadeId": 1,
  "subscriberFilter": {
    "address": "123456789",
    "type": "MAX_ID"
  },
  "startTime": "2026-03-19T09:06:29Z",
  "ttl": "PT1M",
  "content": {
    "maxBotContent": {
      "contentType": "KEYBOARD",
      "text": "Выберите действие",
      "keyboard": {
        "rows": [
          {
            "buttons": [
              {
                "type": "URL",
                "text": "Перейти на сайт",
                "url": "https://docs-pulse.edna.ru/"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "TEXT",
                "text": "Расскажите подробнее"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "CALLBACK",
                "text": "Хочу забронировать",
                "payload": "01"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "LOCATION",
                "text": "Поделиться геолокацией"
              }
            ]
          },
          {
            "buttons": [
              {
                "type": "CONTACT",
                "text": "Поделиться контактом"
              }
            ]
          }
        ]
      }
    }
  }
}

Параметры `maxBotContent`

к сведению

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

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

Параметр	Тип данных	Характер	Описание
`maxBotContent`	object	Обязательный, если в шагах каскада используется канал MAX Bot.	Объект с информацией о содержимом сообщения, направляемого в канал MAX Bot.
`maxBotContent.contentType`	string	Обязательный	Тип содержимого сообщения. Возможные значения: - `TEXT` — текст; - `IMAGE` — изображение; - `VIDEO` — видео; - `AUDIO` — аудио; - `VOICE` — голосовое сообщение; - `DOCUMENT` — документ; - `LOCATION` — геолокация; - `BUTTON` — кнопка-ссылка; - `KEYBOARD` — клавиатура.
`maxBotContent.text`	string	Обязательный, если `maxBotContent.contentType` = `TEXT`, `BUTTON` или `KEYBOARD`	Текст сообщения. Максимальная длина — 4000 символов. Может содержать эмодзи.
`maxBotContent.attachment`	object	Обязательный, если `maxBotContent.contentType` = `IMAGE`, `VIDEO`, `AUDIO`, `VOICE` или `DOCUMENT`	Объект с информацией о вложении — изображение, видео, аудио, голосовое сообщение или документ.
`maxBotContent.attachment.url`	string	Обязательный, если `maxBotContent.contentType` = `IMAGE`, `VIDEO`, `AUDIO`, `VOICE` или `DOCUMENT`	Общедоступный URL-адрес вложения — изображения, видео, аудио, голосового сообщения или документа. Максимальная длина — 4096 символов на стороне edna Pulse.
`maxBotContent.attachment.name`	string	Обязательный, если `maxBotContent.contentType` = `IMAGE`, `VIDEO`, `AUDIO`, `VOICE` или `DOCUMENT`	Имя файла — изображения, видео, аудио, голосового сообщения или документа. Не отображается на устройстве получателя. Максимальная длина — 4096 символов на стороне edna Pulse.
`maxBotContent.caption`	string	Обязательный, если `maxBotContent.contentType` = `BUTTON`. Необязательный, если `maxBotContent.contentType` = `IMAGE` или `DOCUMENT`.	Если `maxBotContent.contentType` = `BUTTON` — текст кнопки. Максимальная длина — 30 символов на стороне edna Pulse. Если `maxBotContent.contentType` = `IMAGE` или `DOCUMENT` — комментарий к вложению, изображению или документу. Не отображается на устройстве получателя. Максимальная длина — 4096 символов на стороне edna Pulse.
`maxBotContent.location`	object	Обязательный, если `maxBotContent.contentType` = `LOCATION`	Объект с информацией о локации.
`maxBotContent.location.latitude`	string	Обязательный, если `maxBotContent.contentType` = `LOCATION`	Координаты (широта). Диапазон значений — от -90.000000 до 90.000000. Поддерживается до 6 знаков после запятой на стороне edna Pulse.
`maxBotContent.location.longitude`	string	Обязательный, если `maxBotContent.contentType` = `LOCATION`.	Координаты (долгота). Диапазон значений — от -180.000000 до 180.000000. Поддерживается до 6 знаков после запятой на стороне edna Pulse.
`maxBotContent.action`	string	Обязательный, если `maxBotContent.contentType` = `BUTTON`	Общедоступный URL-адрес внешнего ресурса, на который выполняется переход по нажатию кнопки-ссылки. Максимальная длина — 1024 символа на стороне edna Pulse. Поддерживается только протокол HTTPS.
`maxBotContent.keyboard`	object	Обязательный, если `maxBotContent.type` = `KEYBOARD`	Объект клавиатуры. Максимум 30 кнопок в одном сообщении, из них: - 1 кнопка запроса локации; - 1 кнопка запроса контакта; - до 30 кнопок-ссылок; - до 30 кнопок отправки текста в чат; - до 30 кнопок быстрого ответа (callback).
`maxBotContent.keyboard.rows`	array of objects	Обязательный, если `maxBotContent.contentType` = `KEYBOARD`	Массив объектов, в котором настраивается количество рядов в клавиатуре. Максимальное количество кнопок в одном ряду - 3. Максимальное количество кнопок в одном сообщении - 30.
`maxBotContent.keyboard.rows.buttons`	array of objects	Обязательный, если `maxBotContent.contentType` = `KEYBOARD`	Массив объектов с информацией о кнопках клавиатуры.
`maxBotContent.keyboard.rows.buttons.type`	string	Обязательный, если `maxBotContent.contentType` = `KEYBOARD`	Тип кнопки клавиатуры. Возможные значения: - `URL` — кнопка-ссылка; - `TEXT` — кнопка отправки текста в чат; - `CALLBACK` — кнопка быстрого ответа (callback); - `LOCATION` — кнопка запроса локации; - `CONTACT` — кнопка запроса контакта.
`maxBotContent.keyboard.rows.buttons.text`	string	Обязательный, если `maxBotContent.contentType` = `KEYBOARD`	Текст кнопки. Указывается для кнопок всех типов. Максимальная длина — 30 символов на стороне edna Pulse. Количество отображаемых символов зависит от количества кнопок в ряду.
`maxBotContent.keyboard.rows.buttons.url`	string	Обязательный, если `maxBotContent.keyboard.rows.buttons.type` = `URL`	Общедоступный URL-адрес внешнего ресурса, на который выполняется переход по нажатию кнопки-ссылки. Максимальная длина — 1024 символа на стороне edna Pulse. Поддерживается только протокол HTTPS.
`maxBotContent.keyboard.rows.buttons.payload`	string	Обязательный, если `maxBotContent.keyboard.rows.buttons.type` = `CALLBACK`	Код или текст кнопки быстрого ответа (callback), скрытый от получателя. Возвращается во входящем сообщении при нажатии кнопки быстрого ответа. Максимальная длина — 1024 символа на стороне edna Pulse.

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

к сведению

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

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

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

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

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

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

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

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

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

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

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

{
   "requestId": "string"
}

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

{
    "requestId": "test-001"
}

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

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

Вызов метода​

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

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

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

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

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

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

Голосовое сообщение с текстом​

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

Сообщение с текстом и кнопкой-ссылкой​

Сообщение с текстом и клавиатурой — кнопка-ссылка​

Сообщение с текстом и клавиатурой — кнопка отправки текста в чат​

Сообщение с текстом и клавиатурой — кнопка быстрого ответа (callback)​

Сообщение с текстом и клавиатурой — кнопка запроса геолокации​

Сообщение с текстом и клавиатурой — кнопка запроса контакта​

Сообщение с текстом и клавиатурой — все типы кнопок​

Параметры maxBotContent​

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

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

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

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

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

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

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

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

Вызов метода

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

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

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

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

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

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

Голосовое сообщение с текстом

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

Сообщение с текстом и кнопкой-ссылкой

Сообщение с текстом и клавиатурой — кнопка-ссылка

Сообщение с текстом и клавиатурой — кнопка отправки текста в чат

Сообщение с текстом и клавиатурой — кнопка быстрого ответа (callback)

Сообщение с текстом и клавиатурой — кнопка запроса геолокации

Сообщение с текстом и клавиатурой — кнопка запроса контакта

Сообщение с текстом и клавиатурой — все типы кнопок

Параметры `maxBotContent`

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

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

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

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

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

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

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

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