> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/gatilho/referencia-de-mensagem.md).

# Referência de Mensagem

## Referência de mensagem

O módulo **Referencia de mensagem** é um gatilho que identifica quando um usuário inicia uma conversa clicando em um anúncio ou post com botão "Clique para Enviar Mensagem". Ao reconhecer esse acesso, o fluxo é ativado automaticamente para esse usuário, permitindo uma experiência personalizada de acordo com a origem dele.

**📷 Inserir print:** visão geral do construtor com o módulo Message Referral selecionado no diagrama

### Como acessar

1. No menu lateral, clique em **Aplicativo**.
2. Acesse **Fluxos**.
3. Abra um fluxo existente ou crie um novo.
4. No construtor, localize o módulo **Referencia de mensagem** na lista de módulos disponíveis.
5. Arraste o módulo para o diagrama e abra a configuração.

**📷 Inserir print:** caminho Aplicativo > Fluxos e módulo Message Referral na lista de módulos

{% hint style="info" %}
O módulo **Referencia de mensagem** funciona exclusivamente nos canais **Instagram** e **Facebook Messenger**. Certifique-se de que o fluxo está vinculado a um desses canais antes de configurar o módulo.
{% endhint %}

### Conhecendo a tela

#### Cabeçalho do módulo

No topo da janela de configuração, você vê o nome do módulo e as etiquetas dos canais compatíveis (**Instagram** e **Messenger**). Abaixo há uma breve descrição sobre o propósito do módulo.

**📷 Inserir print:** cabeçalho do módulo com título e etiquetas de canais

#### Campos de configuração

O módulo possui dois campos principais:

| Campo                            | O que preencher                                                                                                                                                                                         |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID do anúncio ou post            | Informe o ID único do anúncio (encontrado no Gerenciador de Anúncios da Meta) ou o ID do post que possui o botão "Clique para Enviar Mensagem". Este campo é obrigatório. Aceita variáveis do fluxo.    |
| Nome amigável do anúncio ou post | (Opcional) Digite um nome descritivo para facilitar a identificação do módulo dentro do construtor. Esse texto não afeta o funcionamento — serve apenas como referência visual para quem monta o fluxo. |

**📷 Inserir print:** painel de configuração com os campos ID e Nome amigável preenchidos

#### Saída no diagrama

No cartão do módulo dentro do diagrama, há uma única saída:

* **Próximo**: encaminha o usuário para o próximo passo do fluxo após o gatilho ser reconhecido.

**📷 Inserir print:** cartão do módulo no diagrama com a saída Próximo conectada

#### Ações principais

1️⃣ **Configurar o ID do anúncio ou post**

**🎯 Propósito** Vincular o módulo a um anúncio ou post específico para que o fluxo seja acionado quando um usuário chegar por aquela origem.

**✅ Como fazer na tela**

1. Abra o módulo **Referencia de mensagem** no diagrama.
2. No campo **ID do anúncio ou post**, informe o ID correspondente. Você encontra esse número no Gerenciador de Anúncios da Meta ou nas configurações do post.
3. (Opcional) Preencha o campo **Nome amigável** para identificar facilmente o módulo no fluxo.
4. Feche a configuração. O módulo fica salvo automaticamente.

**📌 Resultado esperado** O módulo passa a reconhecer usuários que chegam por aquele anúncio ou post e os encaminha para o próximo passo do fluxo.

**📷 Inserir print:** campo ID preenchido e módulo salvo no diagrama

2️⃣ **Conectar o módulo ao restante do fluxo**

**🎯 Propósito** Definir o que acontece após o gatilho ser identificado — seja enviar uma mensagem de boas-vindas, coletar dados ou direcionar para um atendente.

**✅ Como fazer na tela**

1. No diagrama, clique na saída **Próximo** do módulo Message Referral.
2. Arraste a conexão até o módulo seguinte desejado (ex.: envio de mensagem, coleta de informação ou início de atendimento).
3. Teste o fluxo para validar o caminho completo.

**📌 Resultado esperado** Quando um usuário chega pelo anúncio ou post configurado, o fluxo segue automaticamente para o módulo conectado na saída **Próximo**.

**📷 Inserir print:** módulo Message Referral conectado ao próximo passo no diagrama

#### Comportamento durante atendimento ativo

{% hint style="warning" %}
Se o usuário já estiver em atendimento humano (transferido para um atendente), o módulo **Referencia de mensagem não será acionado** por padrão. O sistema prioriza o atendimento em andamento e bloqueia a execução automática do fluxo.

Isso significa que, se a pessoa clicar em um anúncio enquanto já está sendo atendida, a conversa não reinicia automaticamente pelo fluxo configurado.
{% endhint %}

**📷 Inserir print:** exemplo de conversa em atendimento ativo sem acionamento do gatilho

### Dicas úteis

* Use o campo **Nome do nó** de forma amigável sempre que tiver mais de um módulo **Referencia de mensagem** no mesmo fluxo. Isso facilita a identificação de qual anúncio cada módulo representa.
* Cada módulo Message Referral reconhece apenas **um** ID de anúncio ou post. Para campanhas diferentes, adicione um módulo para cada uma.
* O ID do anúncio é encontrado no **Gerenciador de Anúncios da Meta** (Ads Manager), na coluna de identificação de cada campanha.
* Certifique-se de que o anúncio ou post possui o botão **"Enviar Mensagem"** habilitado, caso contrário o gatilho nunca será disparado.

**📷 Inserir print:** exemplo de fluxo com múltiplos módulos Message Referral para anúncios diferentes

### Caso de uso

Imagine uma campanha no Instagram com dois anúncios diferentes: um para promoção de produto e outro para suporte técnico.

1. No construtor de fluxos, você adiciona **dois módulos Referencia de mensagem** — um para cada anúncio, com IDs diferentes.
2. Cada módulo é conectado a um caminho de fluxo distinto: o primeiro envia uma mensagem de oferta; o segundo direciona para um atendente de suporte.
3. Quando um usuário clica no anúncio de promoção e inicia a conversa, o fluxo identifica a origem e envia a mensagem de oferta automaticamente.
4. Quando outro usuário chega pelo anúncio de suporte, o fluxo o encaminha diretamente para atendimento humano.

Com isso, cada origem de anúncio tem um tratamento personalizado, sem precisar perguntar ao usuário de onde ele veio.

**📷 Inserir print:** diagrama com dois módulos Message Referral conectados a caminhos distintos no fluxo

### Resumo

* O módulo **Referencia de mensagem** identifica usuários que chegam por anúncios ou posts com botão "Clique para Enviar Mensagem" no Instagram ou Messenger.
* Você configura o **ID do anúncio ou post** para que o gatilho reconheça a origem correta.
* O campo **Nome do nó** é opcional e serve apenas para organizar o diagrama.
* Durante atendimento humano ativo, o módulo **não é acionado** por padrão.
* Use um módulo por anúncio para personalizar o atendimento conforme a origem do usuário.


---

# 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://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/gatilho/referencia-de-mensagem.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.