Formatar mensagens de bot

Artigo
06/24/2024

Importante

Este artigo baseia-se no SDK v3 do Bot Framework. Se estiver à procura da versão atual da documentação 4.6 ou posterior do SDK, consulte a secção bots de conversação .

Você pode definir a propriedade opcional TextFormat para controlar como o conteúdo de texto da mensagem é renderizado.

O Microsoft Teams dá suporte às seguintes opções de formatação:

Valor TextFormat	Descrição
Sem formatação	O texto deve ser tratado como texto não processado sem qualquer formatação aplicada.
Markdown	O texto deve ser tratado como formatação markdown e composto no canal conforme adequado; consulte Formatar conteúdo de texto para estilos suportados.
xml	O texto é uma marcação XML simples; consulte Formatar conteúdo de texto para estilos suportados.

Formatar conteúdo de texto

O Teams suporta um subconjunto de etiquetas de formatação Markdown e XML (HTML).

Aplicam-se as seguintes limitações:

As mensagens somente texto não dão suporte à formatação da tabela.

Para obter informações sobre formatação em cartões, consulte Referência de Cartões do Teams.

Suporte à plataforma cruzada.

Para garantir que a sua formatação funciona em todas as plataformas suportadas pelo Teams, tenha em atenção que alguns estilos não são suportados em todas as plataformas.

Style	Mensagens somente texto	Cartões (apenas XML)
bold	✔	✖
italic	✔	✔
cabeçalho (níveis 1 a 3)	✖	✔
rasurado	✖	✔
regra horizontal	✖	✖
lista não ordenada	✖	✔
lista ordenada	✖	✔
texto pré-formatado	✔	✔
blockquote	✔	✔
hiperlink	✔	✔
ligação de imagem	✔	✖

Suporte por plataforma individual

O suporte para formatação de texto varia consoante o tipo de mensagem e por plataforma.

Mensagens somente texto

Style	Área de trabalho	iOS	Android
bold	✔	✔	✔
italic	✔	✔	✔
cabeçalho (níveis 1 a 3)	✖	✖	✖
rasurado	✔	✔	✖
regra horizontal	✖	✖	✖
lista não ordenada	✔	✖	✖
lista ordenada	✔	✖	✖
texto pré-formatado	✔	✔	✔
blockquote	✔	✔	✔
hiperlink	✔	✔	✔
ligação de imagem	✔	✔	✔

Exemplos de formatação de texto

Estilo	Exemplo	Markdown	XML (HTML)
bold	text	`text`	`<strong>text</strong>`
italic	text	`text`	`<em>text</em>`
cabeçalho (níveis 1 a 3)	Text	`### Text`	`<h3>Text</h3>`
rasurado	~~text~~	`~~text~~`	`<strike>text</strike>`
lista não ordenada	texto texto	`* text` `* text`	`<ul><li>text</li><li>text</li></ul>`
lista ordenada	texto texto	`1. text` `2. text`	`<ol><li>text</li><li>text</li></ol>`
texto pré-formatado	`text`	`text`	`<pre>text</pre>`
blockquote	texto	`>text`	`<blockquote>text</blockquote>`
hiperlink	Bing	`[Bing](https://www.bing.com/)`	`<a href="https://www.bing.com/">Bing</a>`
ligação de imagem		`![Duck on a rock](http://aka.ms/Fo983c)`	`<img src="https://aka.ms/Fo983c" alt="Duck on a rock"></img>`

Partilhar via