> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/telegram-components/mensagem-do-telegram.md).

# Mensagem do Telegram

### 1. Visão Geral

O Componente de Envio de Mensagem do Telegram (identificado na interface como `telegram_message`) é um nó de ação outbound focado na transmissão de conteúdo. Sua função principal é injetar e-mails, alertas, textos informativos ou arquivos de mídia diretamente no chat privado do usuário que interage com o bot do Telegram. Ele é utilizado para guiar conversas de forma linear, entregar materiais de marketing ou emitir avisos de transações sem reter o usuário em validações de resposta.

### 2. Parâmetros de Configuração

A parametrização do bloco estabelece as diretrizes do formato e o conteúdo do balão de mensagem que o cliente receberá:

* Tipo de mensagem: Menu suspenso utilizado para escolher a categoria de payload que o robô transmitirá. As opções mapeadas incluem:
  * `Texto`: Mensagens compostas puramente por strings de texto plano, suportando formatações simples de emojis e links.
  * `Áudio`: Envio de arquivos sonoros ou recados de voz em formatos compatíveis com o Telegram.
  * `Imagem`: Envio de mídias gráficas, banners corporativos ou fotos promocionais (PNG, JPG).
  * `Vídeo`: Compartilhamento de arquivos audiovisuais assistíveis de forma nativa no player do aplicativo (MP4).
* Mensagem (\* Campo Obrigatório se Texto): O corpo principal do texto que será enviado ao cliente no chat.
* URL do arquivo (\* Obrigatório para mídias): Disponibilizado quando selecionadas as opções `Imagem`, `Áudio` ou `Vídeo`. Permite colar o endereço HTTP/HTTPS público do arquivo ou realizar o carregamento via botão de Upload.

### 3. Construtor Visual

A interface gráfica adapta seus campos de forma condicional conforme a opção escolhida no parâmetro *Tipo de mensagem*:

* Layout de Texto Simplificado: Ao trabalhar no modo `Texto`, a interface isola apenas a caixa de digitação *Mensagem*, exigindo o preenchimento de conteúdo (`*`) para que o nó possa ser salvo.
* Layout de Mídias Avançado: Ao alternar para o modo `Imagem`, a caixa de texto longa é substituída pelo campo *URL do arquivo* e o botão roxo de Upload, que permite arrastar arquivos diretamente do computador do administrador do fluxo para os servidores da plataforma.

### 4. Operadores Especiais

As propriedades lógicas deste componente gerenciam a interpolação de strings dinâmicas e o processamento de entrega assíncrona:

* Interpolação de Tags por Chaves Duplas: O campo *Mensagem* é totalmente compatível com a inserção de metadados salvos no contato utilizando a sintaxe `{{...}}`. Isso permite personalizar avisos ativos de forma individualizada (ex: "Seu boleto vence amanhã, `{{nome}}`!").
* Processamento Assíncrono sem Estado de Standby: Diferente do nó de pergunta do Telegram, este componente não gera pausa de execução na jornada. O motor da plataforma envia a requisição de postagem para os servidores da API do Telegram e libera o contato imediatamente para o próximo bloco conectado ao nó.

### 5. Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente para abastecer fluxos de conversação no Telegram:

| **Tipo de Mensagem Selecionado** | **URL do Arquivo / Upload** | **Conteúdo Configurado (Mensagem)**                                                                                     | **Caso de Uso Prático**                                                                                          |
| -------------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `Texto`                          | *Nenhum*                    | "Seja bem-vindo ao canal oficial de suporte! 🤖"                                                                        | Disparar uma saudação inicial instantânea assim que o contato ativa o bot por um gatilho receptivo.              |
| `Imagem`                         | *Upload de comprovante.png* | *Nenhum*                                                                                                                | Exibir um infográfico explicativo com o passo a passo de um produto logo após o lead escolher uma opção de menu. |
| `Texto`                          | *Nenhum*                    | "Aguarde um momento, `{{nome}}`. Estamos transferindo seu atendimento para a fila do setor de `{{setor_escolhido}}`..." | Mostrar um aviso de transição dinâmico antes de acionar o componente de transferência humana.                    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/telegram-components/mensagem-do-telegram.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.