Формат сообщений через API

Для отправки и редактирования сообщения через API передавайте текст в content, а его формат — в content_format. Формат описывает исходный текст, а не платформу получателя. Senler сам готовит сообщение для выбранного канала.

Выбор формата

plain_text — символы сохраняются буквально. Например, **Важно** останется текстом со звёздочками.
markdown — разметка задаёт оформление: **Важно** станет жирным текстом на поддерживающих его платформах.

При отправке сообщения от оператора без content_format используется обычный текст. При редактировании без этого поля сохраняется формат исходного сообщения. Явно задавайте формат, если меняете способ оформления.

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

Используйте POST /api/dialogs/DIALOG_ID/send. Авторизация описана в разделе API. Пример JSON-тела:

{
  "content": "**Заказ готов**\n\n[Посмотреть заказ](https://example.com/orders/123)",
  "content_format": "markdown"
}

Этот запрос отправляет сообщение клиенту. Для проверки интеграции используйте предназначенный для тестирования диалог.

Для редактирования используйте PATCH /api/dialogs/DIALOG_ID/events/EVENT_ID с теми же полями. Изменение возможно только при соблюдении ограничений редактирования.

Успешный ответ API не гарантирует доставку на внешнюю платформу. В частности, 202 при редактировании означает, что локальная правка принята, а синхронизация с платформой выполняется асинхронно. Проверяйте итоговый статус сообщения.

Поддерживаемая разметка

Markdown поддерживает жирный текст, курсив, зачёркивание, ссылки, заголовки, списки, цитаты, таблицы, встроенный код и блоки кода. Дополнительно доступны:

подчёркнутый текст;
<spoiler>скрытый текст</spoiler>.

Это специальные обозначения оформления, а не разрешение вставлять произвольный HTML. Например, текст не заменяет Markdown **текст**. В режиме plain_text даже  и <spoiler> остаются буквальным текстом.

Не передавайте готовый Telegram HTML или MarkdownV2 вместо исходного Markdown. Для картинки отправляйте вложение: Markdown-ссылка ![подпись](URL) сама по себе не загружает файл на внешнюю платформу.

Оформление в разных каналах

Кабинет и виджет отображают сохранённый формат сообщения, в том числе таблицы и раскрываемый скрытый текст.
Telegram получает поддерживаемое оформление, включая подчёркивание и скрытый текст. Таблица передаётся текстовыми строками, а не интерактивной таблицей.
MAX получает поддерживаемое оформление, но скрытый текст остаётся открытым.
Discord получает собственную разметку платформы. Если сочетание стилей нельзя передать без искажения текста, часть оформления упрощается.
Email получает HTML-письмо с оформлением и таблицами; скрытый текст остаётся открытым.
VK, Avito и StreamVi получают обычный текст. Если подпись ссылки отличается от адреса, адрес дописывается в скобках.

Не используйте скрытый текст для передачи секретов: он не ограничивает доступ к содержимому, а в некоторых каналах не скрывается вовсе. Длина сообщения и подписи к вложению ограничивается платформой; длинный текст в VK отправляется несколькими частями.