# Formatação de mensagens no Telegram

## Marcação Markdown

Para marcar corretamente o texto no bloco desejado (a marcação fica localizada abaixo do campo de entrada de texto da mensagem), siga rigorosamente os seguintes passos:

<div data-with-frame="true"><figure><img src="/files/ad04d24c85a9cd57fe86fb26f655cf2e5d927e7d" alt="" width="563"><figcaption></figcaption></figure></div>

1. Coloque o texto necessário no campo de resposta.

Se você estiver usando variáveis no texto, você <mark style="color:vermelho;">**não deve**</mark> especificá-las nesta etapa. Caso contrário, a sintaxe da variável será quebrada e os caracteres #{} também serão escapados, e a variável não aparecerá no texto.

2. Ativamos "Markdown no Telegram". Dessa forma, serão adicionados caracteres de escape ao seu texto.
3. Selecionamos o texto \*\* ou \_ \_, etc.

{% hint style="danger" %}
se qualquer um dos seguintes caracteres ocorrer neste bloco: '\_', '\*', '\[', ']', '(', ')', '\~', '\`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!' — eles precisam ser escapados adicionando uma barra invertida antes deles \\&#x20;

Caso contrário, a mensagem não será enviada de forma alguma. Não importa qual parte do texto você marque.

Exemplo: oi\\. Prazer em ver \*você\* \\!
{% endhint %}

Caracteres especiais:

**Texto em negrito** — coloque asteriscos em ambos os lados: \* aqui está o texto\*\
**Itálico** — sublinhado:  \_text&#x6F;*\_*\
**Texto sublinhado** — dois sublinhados inferiores em ambos os lados: \_\_texto\_\_\
**Texto tachado -** é um til em ambos os lados do texto: \~texto\~\
Link no texto: \[texto entre colchetes]\(link entre parênteses):\
\[URL embutida] ([http://www.example.com/](https://vk.com/away.php?to=http%3A%2F%2Fwww.example.com%2F\&cc_key=)) \
**Menção do usuário no Telegram:** \[texto entre colchetes] (link para o usuário entre parênteses). Você pode usar #{platform\_id} depois do sinal de igual no link.\
\[menção embutida de um usuário]\(tg://user?id=123456789)\
**Texto no formato de código** — coloque um apóstrofo invertido em ambos os lados do texto: `código inline de largura fixa`\
**Texto oculto ou spoiler** - use || em ambos os lados do texto

4. Em seguida, marque o texto desejado usando caracteres especiais.

**Exemplo:**

<div data-with-frame="true"><figure><img src="/files/3f5674fdd1068a016eb5a28c12f51436b7442884" alt="" width="563"><figcaption><p>Exemplo de marcação</p></figcaption></figure></div>

Resultado:

<div data-with-frame="true"><figure><img src="/files/89ebbfd018bdeacf34fd62042563fac279ec2140" alt="" width="425"><figcaption></figcaption></figure></div>

Ao trabalhar com Markdown, é necessário não esquecer que os caracteres especiais devem ser escapados, e os caracteres de controle no texto devem ser substituídos por substituições de texto apropriadas. Isso é feito de forma bastante simples, adicionando uma **barra invertida \\** antes do caractere especial ou usando a função Calculadora.

**txt = tg\_escape(s), onde** **s** - string de texto de origem&#x20;

{% hint style="info" %}
Para atribuir um valor de texto com várias linhas a uma variável, especifique-o da seguinte forma:

`your_variable = "Texto da primeira linha" + "\n" + "Texto da segunda linha" + "\n" +"Texto da terceira linha"`
{% endhint %}

A saída no **txt** arquivo é uma linha com barras já inseridas nos lugares apropriados.

**Exemplo:**

<figure><img src="/files/10296d15e8ffb4fac1944bf273cb5c6224d98017" alt=""><figcaption><p>Exemplo de escape</p></figcaption></figure>

<div data-with-frame="true"><figure><img src="/files/179581ba10be222e90fab608e1e5a27e22394159" alt=""><figcaption><p>Como o texto do Telegram fica</p></figcaption></figure></div>

Em seguida, marque o texto desejado.

#### Um exemplo com um texto longo:

<div data-with-frame="true"><figure><img src="/files/c071e81cc70b6366a93b2e40ca98014823167ae4" alt="" width="364"><figcaption></figcaption></figure></div>

Para fazer isso, você precisa usar a calculadora:

Passo 1. Cole o texto no campo da mensagem:

<div data-with-frame="true"><figure><img src="/files/132e3830aa5cd98a8fcf3dd03cef7fcf015dcf58" alt="" width="375"><figcaption></figcaption></figure></div>

Passo 2. Ative o botão de marcação Markdown:

<div data-with-frame="true"><figure><img src="/files/6eb7ea55a953bd9105ab7e345c4d76aefe3183c6" alt="" width="375"><figcaption><p>Depois de ativar o botão de marcação, os caracteres especiais são escapados.</p></figcaption></figure></div>

Passo 3. Organize os caracteres especiais para formatar a mensagem no texto:

<div data-with-frame="true"><figure><img src="/files/b4283569c4c3a26db55a2dbf696ac66689b670b0" alt="" width="375"><figcaption></figcaption></figure></div>

Se, depois de enviar a mensagem, ela não chegou ao mensageiro e você vê um erro no diálogo na seção Clientes, isso significa que você escapou os caracteres incorretamente..&#x20;

Ao mesmo tempo, você verá um erro ao enviar uma mensagem na seção "Clientes", ele conterá um caractere que não foi escapado.

Mensagens de erro que você pode ver:

1. Não há caractere de fechamento:

<div data-with-frame="true"><figure><img src="/files/fc6e5e7c3b80496e73f83a36c1eddab1b3497f05" alt="" width="188"><figcaption></figcaption></figure></div>

<div data-full-width="true" data-with-frame="true"><figure><img src="/files/5d0b9f03344e5ef146c5d2bcf54062ddf4a4e1bd" alt="" width="188"><figcaption></figcaption></figure></div>

2. Falta escape de caractere:

<div data-with-frame="true"><figure><img src="/files/d80a10176dffa143d4fc2a66edff015996dc77f7" alt="" width="188"><figcaption></figcaption></figure></div>

## &#x20;Marcação HTML

Para fazer a marcação HTML funcionar, não se esqueça de clicar no botão HTML abaixo do campo de texto da mensagem:

<div data-with-frame="true"><figure><img src="/files/811d3283f2e9a7b89ec5b088786c404f3e933113" alt="" width="563"><figcaption></figcaption></figure></div>

1. \<a href="[https://google.com">ссылка\\](https://docs.mavibot.ai/doc/pt/chatbot/mensageiros/telegram/https:/google.com">ссылка\\)</a> - incorpora um link em uma única palavra.

Exemplo de preenchimento:

<div data-with-frame="true"><figure><img src="/files/92c112f59d11e17de64db52f2bcc29306732799e" alt="" width="563"><figcaption></figcaption></figure></div>

2. \<u>sublinhado\</u> - fonte sublinhada

Exemplo:

<div data-with-frame="true"><figure><img src="/files/fca0c324618ede8b817cbcc6215c2d64d7f8dc25" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/3b594e933ad593639f41e1c62d46716cb5ccca61" alt="" width="563"><figcaption></figcaption></figure></div>

3. \<ins>sublinhado\</ins> - fonte sublinhada

Exemplo:

<div data-with-frame="true"><figure><img src="/files/21b42966d72009136a480ef91e000647687760d3" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/f81c1480bcda0011fb590c94966a36b17cfb5a70" alt="" width="563"><figcaption></figcaption></figure></div>

4. \<em>itálico\</em> - fonte itálica

Exemplo:

<div data-with-frame="true"><figure><img src="/files/69b0d6e39f24dcf055972a31c718ecece666e69f" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/4d7f0d1972a2825d649a9d68051db8afcba3c722" alt="" width="563"><figcaption></figcaption></figure></div>

5. \<i>itálico\</i> - fonte itálica

Exemplo:

<div data-with-frame="true"><figure><img src="/files/1e7fc2c5a432c86dd58b31f1af79acb6b554f7eb" alt="" width="563"><figcaption></figcaption></figure></div>

\<strong>forte\</strong> - fonte em negrito

<div data-with-frame="true"><figure><img src="/files/76a9ba59021394d477ccc15c4ceb294e5aef60a7" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/02826c5bb92e83c42e36989a17d28788d02c6cb9" alt="" width="563"><figcaption></figcaption></figure></div>

\<strike>strike\</strike> - texto tachado

<div data-with-frame="true"><figure><img src="/files/3c8b2bf69e0f803c4f9a3b3ab6be44cffe6f8ddd" alt="" width="563"><figcaption></figcaption></figure></div>

\<span class="tg-spoiler">hidden\</span> - texto oculto

Exemplo:

<div data-with-frame="true"><figure><img src="/files/54a6504da13d2cc181ebb8e38b73c68ad59cbb6d" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/a78058fab8e421f16a2737aae4f6ec44519d4389" alt="" width="563"><figcaption></figcaption></figure></div>

\<code>Prerfomatted\</code> - texto formatado

Exemplo:

<div data-with-frame="true"><figure><img src="/files/ea26b119bb88d7406de2bb3ce46330d8ad17cd2d" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/3eaa816e8bc8cb3cd2dda762dd43c593e3f69667" alt="" width="563"><figcaption></figcaption></figure></div>

\<pre>Pré-formatado\</pre> - fonte formatada

Exemplo:

<div data-with-frame="true"><figure><img src="/files/1058f36db08bc1a5e7cf71fe83ba4b09c1583a68" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/cd3a74fa997f1124b2bf0e1681c481427fc07b0f" alt="" width="526"><figcaption></figcaption></figure></div>

## Como ativar o modo protegido para conteúdo

Para proteger o conteúdo de ser compartilhado, você pode ativar o modo protegido para mensagens. Para fazer isso, vá até a seção “Mensagem” e ative “Proteger conteúdo":

<div data-with-frame="true"><figure><img src="/files/51ad94c9556c082ef56daa38f7979fb0207beaed" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Mensagens protegidas não podem ser encaminhadas, e você não pode tirar uma captura de tela no seu celular.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/chatbot/mensageiros/telegram/formatting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
