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

  • Статья

Форматирование сообщений позволяет выявить лучшее в сообщениях ботов. Сообщения бота можно отформатировать так, чтобы они включали расширенные карточки в виде вложений, содержащих интерактивные элементы, такие как кнопки, текст, изображения и т. д.

Примечание.

Максимальный размер сообщений бота составляет 40 КБ. Если максимальный размер сообщения бота превышает 40 КБ, бот получает 413 код состояния (RequestEntityTooLarge), содержащий код MessageSizeTooBigошибки . Ограничение на размер сообщений бота включает все полезные данные сообщения, закодированные как UTF-16, и не включает изображения в кодировке Base64.

Форматирование текстового содержимого

Чтобы отформатировать сообщения бота, можно настроить необязательное свойство TextFormat, чтобы управлять отображением текстового содержимого сообщения бота.

Microsoft Teams поддерживает следующие параметры форматирования:

значение TextFormat Описание
plain Текст должен рассматриваться как необработанный текст без применения форматирования.
markdown Текст должен обрабатываться как формат Markdown и отображаться в канале соответствующим образом.
xml Текст является простой разметкой XML.

Teams поддерживает подмножество тегов markdown форматирования и xml или HTML. Бот также может упоминание других пользователей и теги в текстовых сообщениях, размещенных в каналах. Дополнительные сведения см. в статье Добавление упоминаний в сообщения.

В настоящее время на форматирование распространяются следующие ограничения:

  • Текстовые сообщения не поддерживают форматирование таблиц.
  • Форматированные карточки поддерживают форматирование только в текстовом свойстве, а не в свойствах заголовка или подзаголовка.
  • Расширенные карточки не поддерживают разметку Markdown или форматирование таблиц.

После форматирования текстового содержимого убедитесь, что форматирование работает на всех платформах, поддерживаемых Teams.

Кроссплатформенная поддержка

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

Style Только текстовые сообщения Форматированные карточки — только XML
Полужирный ✔️️ ❌
Курсив ✔️ ✔️
Заголовок (уровни 1–3) ❌ ✔️
Зачеркнутый ❌ ✔️
Горизонтальная линейка ❌ ❌
Неупорядоченный список ❌ ✔️
Упорядоченный список ❌ ✔️
Предварительно отформатированный текст ✔️ ✔️
Цитата ✔️ ✔️
Hyperlink ✔️ ✔️
Ссылка на изображение ❌ ❌

После проверки кроссплатформенной поддержки убедитесь, что также доступна поддержка отдельных платформ.

Поддержка индивидуальной платформой

Поддержка форматирования текста зависит от типа сообщения и платформы.

Только текстовые сообщения

В следующей таблице приведен список стилей, поддерживаемых на настольных компьютерах, iOS и Android:

Style Версия для настольного компьютера iOS Android
Полужирный ✔️ ✔️ ✔️
Курсив ✔️ ✔️ ✔️
Заголовок (уровни 1–3) ❌ ❌ ❌
Зачеркнутый ✔️ ✔️ ❌
Горизонтальная линейка ❌ ❌ ❌
Неупорядоченный список ✔️ ❌ ❌
Упорядоченный список ✔️ ❌ ❌
Предварительно отформатированный текст ✔️ ✔️ ✔️
Цитата ✔️ ✔️ ✔️
Hyperlink ✔️ ✔️ ✔️
Ссылка на изображение ❌ ❌ ❌

Карточки

Подробнее о поддержке карточек см. Форматирование карточки.

Следующий этап

Обновление и удаление сообщений, отправленных ботом

См. также