> 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/whatsapp-components/mensagem-do-whatsapp.md).

# Mensagem do WhatsApp

### Visão Geral

O **Componente de Envio de Mensagem do WhatsApp** é um nó de ação focado em comunicação outbound de sessão. Sua função principal é transmitir mensagens ativas contendo textos ou arquivos de mídia diretamente para o aparelho do usuário final durante o fluxo da automação. Ele é utilizado para dar retornos informativos, compartilhar materiais informativos e enriquecer a experiência de atendimento com mídias variadas dentro da janela de conversação ativa do cliente.

### Parâmetros de Configuração

A parametrização do componente determina o formato do conteúdo que será disparado para a fila de envio do aplicativo:

* **Tipo de mensagem:** Menu suspenso que define a natureza e o comportamento estrutural do balão de mensagem que o cliente receberá. As opções englobam:
  * `Texto`: Mensagens compostas estritamente por blocos de texto (com suporte a emojis e links).<br>
  * `Áudio`: Transmissão de arquivos de som (geralmente enviados com a propriedade nativa de gravação).<br>
  * `Documento`: Compartilhamento de arquivos corporativos ou fiscais (PDFs, planilhas, arquivos de texto).<br>
  * `Imagem`: Envio de arquivos visuais e gráficos corporativos (PNG, JPG).<br>
  * `Vídeo`: Compartilhamento de mídias audiovisuais em formatos compatíveis (MP4).<br>
  * `Pagamento`: Módulo especializado para envio de ordens de cobrança ou cobranças interativas.<br>
* \_*Mensagem (* Campo Obrigatório):\_\* O corpo do texto principal da mensagem que acompanhará o disparo (nos formatos de mídia como `Documento` ou `Imagem`, este campo funciona como a legenda da mídia enviada).<br>

### Construtor Visual

A interface gráfica é altamente responsiva e adapta seus blocos de formulário instantaneamente de acordo com o item selecionado no campo *Tipo de mensagem*:

* **Estrutura Básica (`Texto`):** Renderiza uma interface enxuta composta apenas pelo seletor de tipo e por uma caixa de texto rica de preenchimento obrigatório (`*`).<br>
* **Estrutura Avançada de Mídias (`Documento`, `Imagem`, `Vídeo`):** Ao alternar para o envio de mídias, o construtor expande e adiciona novos blocos gerenciais na tela:
  * `URL do arquivo`: Campo de entrada de texto para informar o endereço HTTP ou link público onde a mídia está hospedada para o servidor da API capturar.<br>
  * `Botão Upload`: Botão roxo nativo que abre a janela de arquivos do sistema local para carregar o arquivo diretamente para a CDN da plataforma.<br>
  * `Bloco documents (+ Adicionar arquivo)`: Seletor repetidor de lista que permite agrupar múltiplos arquivos de anexo em lote dentro do mesmo nó de processamento.<br>

### Operadores Especiais

As propriedades lógicas deste componente gerenciam a compilação do payload e a injeção dinâmica de dados na camada de visualização:

* **Interpolação de Tags de Escopo (Mapeamento Dinâmico):** Tanto o campo de conteúdo da *Mensagem* (ou legenda) quanto o campo de *URL do arquivo* aceitam a inclusão de variáveis globais e locais da plataforma através da sintaxe de chaves duplas (`{{...}}`). Isso permite que o sistema busque o link de um boleto em PDF gerado por um nó anterior de API e insira o link dinamicamente no campo de envio.<br>
* **Envio Assíncrono Sequencial:** O motor da automação processa o envio de forma linear rápida. Após passar o pacote de dados para o gateway do WhatsApp, a porta de saída do bloco libera o contato instantaneamente para o próximo componente do fluxo de design, evitando travamentos na experiência.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente para disparar conteúdos variados ao longo de um fluxo:

| **Tipo de Mensagem Selecionado** | **URL do Arquivo / Upload** | **Conteúdo Configurado (Mensagem)**                                                | **Caso de Uso Prático**                                                                                   |
| -------------------------------- | --------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `Texto`                          | *Nenhum*                    | "Obrigado por se cadastrar, `{{nome}}`! Um consultor entrará em contato em breve." | Enviar um texto simples de confirmação de cadastro usando variáveis coletadas na triagem.                 |
| `Documento`                      | `{{link_boleto_pdf}}`       | "Segue o boleto da sua fatura gerado para o mês atual."                            | Enviar de forma automatizada o arquivo PDF de cobrança de um cliente que solicitou a segunda via no menu. |
| `Imagem`                         | *Upload de banner.png*      | "Confira os nossos novos horários de atendimento para o final de ano! 🎄"          | Disparar um card gráfico informativo com uma legenda explicativa na abertura de um fluxo específico.      |


---

# 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/whatsapp-components/mensagem-do-whatsapp.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.