> 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

O módulo **Referência 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.

### 🧭 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 **Referência de mensagem** na lista de módulos disponíveis.
5. Arraste o módulo para o diagrama e abra a configuração.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F0zIrBbbBZXiF4764ys7D%2Fimage.png?alt=media&amp;token=526b9800-58c2-4461-8044-619b95305137" alt=""><figcaption><p>Imagem 1 - Caminho Aplicativo > Fluxos e módulo Referência de mensagem na lista de módulos no Hyperflow Integrações.</p></figcaption></figure>

{% hint style="info" %}
O módulo **Referência 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.

#### ⚙️ 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. |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FZpjKnkTqKOZ9wf7PIDap%2F03-id-nome-amigavel.png?alt=media&amp;token=b32e6ee3-a53b-4380-8a6b-ca23927367b9" alt=""><figcaption><p>Imagem 2 - Painel de configuração com os campos ID e Nome amigável preenchidos.</p></figcaption></figure>

#### 🔀 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.

#### 🛠️ 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 **Referência 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FznGNnpvoWwcpYV7LkhO3%2Fimage.png?alt=media&amp;token=e35ac12e-002b-482a-9a7d-bb4fe8e184b7" alt=""><figcaption><p>Imagem 3 - Campo ID preenchido e módulo salvo no diagrama.</p></figcaption></figure>

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 **Referência de mensagem**.
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**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FxFlZbD75v7vycjO2cnwy%2Fimage.png?alt=media&amp;token=cc4ec892-44fc-4135-8bb4-f420d5b14a87" alt=""><figcaption><p>Imagem 4 - Módulo Referência de mensagem conectado ao próximo passo no diagrama.</p></figcaption></figure>

#### ⚠️ Comportamento durante atendimento ativo

{% hint style="warning" %}
Se o usuário já estiver em atendimento humano (transferido para um atendente), o módulo **Referência 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.

Caso precise de um comportamento diferente, entre em contato com o time técnico para verificar as opções de configuração avançada do canal.
{% endhint %}

### 📌 Dicas úteis

* Use o campo **Nome amigável** sempre que tiver mais de um módulo **Referência de mensagem** no mesmo fluxo. Isso facilita a identificação de qual anúncio cada módulo representa.
* Cada módulo **Referência de mensagem** 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.

### 💡 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 Referência 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.

### 📝 Resumo

* O módulo **Referência 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 amigável** é 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.