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

# Mensagem Facebook

### Visão Geral

O **Componente de Envio de Mensagem do Facebook Messenger** é 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 a caixa de mensagens privadas (DM) do usuário final durante o fluxo da automação. Ele é utilizado para dar retornos informativos, compartilhar materiais promocionais e enriquecer a experiência de atendimento de forma multimídia dentro da janela de conversação ativa do cliente na página.

### Parâmetros de Configuração

A parametrização do componente determina o formato do conteúdo que será disparado para a API de mensagens da Meta:

* **Tipo de mensagem:** Menu suspenso que define a natureza e o comportamento estrutural do balão de mensagem que o cliente receberá no chat. 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.<br>
  * `Documento`: Compartilhamento de arquivos corporativos (PDFs, guias, e-books).<br>
  * `Imagem`: Envio de arquivos visuais e gráficos corporativos (PNG, JPG, GIFs).<br>
  * `Vídeo`: Compartilhamento de mídias audiovisuais em formatos compatíveis (MP4).<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 atua como a legenda ou texto de apoio da mídia enviada).<br>

### Construtor Visual

A interface gráfica 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 limpa composta apenas pelo seletor de tipo e por uma caixa de texto rica de preenchimento obrigatório (`*`).<br>
* **Estrutura de Mídias (`Áudio`, `Documento`, `Imagem`, `Vídeo`):** Ao alternar para o envio de mídias, o construtor expande e adiciona os campos de gerenciamento de arquivos na tela:
  * `URL do arquivo`: Campo de texto para informar o endereço HTTP ou link público onde a mídia está hospedada para o servidor da Meta capturar.<br>
  * `Botão Upload`: Abre a janela de arquivos do sistema operacional local para carregar o arquivo diretamente para a CDN da plataforma.<br>
  * `Botão + Adicionar arquivo`: Permite agrupar múltiplos arquivos de anexo para serem enviados em lote sequencial dentro do mesmo nó.<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 do Messenger:

* **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 uma imagem de um produto selecionado pelo cliente em um nó anterior e insira o link dinamicamente no campo de envio.<br>
* **Monitoramento da Janela de Sessão (Regra de Saída):** O motor da automação processa o envio de forma linear rápida. Após passar o pacote de dados para o gateway do Facebook Messenger, a porta de saída do bloco libera o contato instantaneamente para o próximo componente do fluxo de design, operando de forma assíncrona.<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 no Facebook Messenger:

| **Tipo de Mensagem Selecionado** | **URL do Arquivo / Upload**      | **Conteúdo Configurado (Mensagem)**                                        | **Caso de Uso Prático**                                                                                      |
| -------------------------------- | -------------------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `Texto`                          | *Nenhum*                         | "Olá, `{{nome}}`! Seu agendamento foi confirmado com sucesso para amanhã." | Enviar um texto simples de confirmação de agendamento usando variáveis coletadas ao longo do fluxo.          |
| `Documento`                      | `{{link_catalogo_pdf}}`          | "Aqui está o nosso catálogo completo de produtos em PDF!"                  | Enviar de forma automatizada o arquivo de catálogo para um cliente que solicitou a tabela de preços no menu. |
| `Imagem`                         | *Upload de banner\_promocao.jpg* | "Aproveite nossa condição especial da semana! 🚀"                          | Disparar um card gráfico promocional com uma legenda explicativa na abertura de uma ramificação do fluxo.    |


---

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