> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metricaas.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# As peças do fluxo

> O que cada peça do editor de fluxos faz: os gatilhos, as ações (WhatsApp e Instagram), as condições e as esperas — inclusive o Esperar resposta, que para o fluxo até o lead responder, e o Portão de seguidor, que só libera para quem segue o perfil.

Um **fluxo** é a automação que sabe esperar, decidir e seguir por mais de um caminho. Ele é montado no editor
(**Automações → Fluxos**) com três famílias de peça: **Quando** (o gatilho, por onde o lead entra), **Faça** (as
ações) e **Decidir** (condições e esperas). Publicar liga o fluxo; para ver antes o que ele faria, use **simular**
no editor.

## Quando: os gatilhos

| Peça | Dispara quando |
| - | - |
| **entrou na etapa** | o lead entra numa etapa do funil (dá para esperar N horas antes) |
| **ficou parado** | o lead fica N horas na etapa sem mudar de etapa e sem trocar mensagem |
| **não respondeu** | a última mensagem foi nossa há N horas e o cliente não respondeu |
| **ninguém atendeu** | o lead está na etapa há N horas e nunca recebeu mensagem nossa |
| **lead criado** | chega um lead novo (dá para limitar pela origem) |
| **mensagem recebida** | o cliente manda mensagem no WhatsApp ou no Instagram (dá para escolher o canal); filtra por "contém" ou palavra exata |
| **comentaram no post** | alguém comenta num post do Instagram da empresa; filtra por "contém", palavra exata, **qualquer comentário** ou **parece uma data** (veja abaixo) |
| **atendimento mudou** | a conversa muda de estado (aguardando, em atendimento, resolvida) |
| **ninguém disponível** | chega conversa nova e o rodízio não acha ninguém com a cadeira aberta |

### Comentaram no post

| Campo | Valor |
| - | - |
| **Quais comentários** | vazio = os que têm as palavras do campo seguinte; **Qualquer comentário** (a pessoa comenta o próprio nome, por exemplo); **Comentário que parece uma data** (`21/03/1988`, `21/03/88`, `21.03.1988`, `21-03-1988`, "21 de março de 1988") |
| **Só se o comentário contém** · **Palavra exata** | o filtro por palavra, como sempre |
| **Uma entrada por pessoa, por post, a cada** | em horas (0 a 720). Quem comenta de novo no **mesmo post** dentro da janela não entra de novo — não recebe outra DM. Vazio ou 0 = cada comentário é uma entrada |
| **No comentário repetido** | responder em público de novo (sem DM) · não fazer nada |

**Quais posts.** Sem post ligado, o fluxo vale para **todos** os posts da conta. Com posts ligados (pela tela, pela
API ou pelo Estúdio), só para eles. Com o **ligar post automático** (no painel do gatilho), o fluxo liga sozinho os
posts **novos** — publicados depois de ligar a regra — cuja legenda tem um termo que começa com o que você escolheu
(`#mcn-desenho`), ou todo Reels novo. Com essa regra ligada e nenhum post ainda, o fluxo **não** vale para todos:
ele espera o primeiro post que bater. Se um post bater em dois fluxos, o painel avisa (a Meta só aceita uma resposta
privada por comentário, então a DM do segundo é pulada).

O painel do gatilho mostra também os **repetidos evitados**: quantos comentários a janela segurou.

> [!WARNING]
>
> **Qualquer comentário** e **parece uma data** valem para todo comentário do post. Pelo MCP e pela API eles só são
> aceitos com post ligado ou com o ligar automático — para nunca disparar em todos os posts sem querer.

## Variáveis nas mensagens

Valem no texto de toda mensagem (WhatsApp, DM, resposta pública, aviso ao time) e no **link de um botão**. Variável
sem valor vira texto vazio — nunca `{{…}}`.

| Variável | O que vira |
| - | - |
| `{{primeiro_nome}}` · `{{nome}}` · `{{lead.telefone}}` · `{{lead.etapa}}` · `{{lead.origem}}` · `{{lead.ig_username}}` | os dados do lead |
| `{{campo.<chave>}}` | um campo personalizado |
| `{{mensagem.texto}}` · `{{mensagem.botao}}` | a mensagem que disparou o "mensagem recebida" (e o botão tocado) |
| `{{comentario}}` | o comentário **limpo**: sem menções `@`, links, hashtags e emoji repetido, espaços colapsados, até 60 caracteres sem quebrar palavra. `"@fulana Maria Clara 😍😍 #tag"` → `Maria Clara 😍` |
| `{{comentario.url}}` | o mesmo, **sem emoji** e codificado para ir num link (`"Maria Clara 😍"` → `Maria%20Clara`) |
| `{{comentario.primeira_palavra}}` | a primeira palavra, sem emoji, com inicial maiúscula (`maria clara` → `Maria`) |
| `{{comentario.texto}}` · `{{comentario.media_id}}` | o comentário cru e o id do post (como antes) |
| `{{resposta}}` · `{{resposta.url}}` · `{{resposta.primeira_palavra}}` | o mesmo para a última mensagem de **texto** que a pessoa mandou e acordou um **Esperar resposta**; vazio se ela só tocou no botão |
| `{{post.id}}` | o id do post comentado |
| `{{post.codigo}}` | o código do post achado na legenda pelo ligar automático (vazio nos outros) |
| `{{lead.ref}}` | o código do lead, **só no link de um botão** e só para um domínio liberado pela empresa |

No link de um botão, **todo** valor entra codificado para URL (um `&` no comentário não abre outro parâmetro). Use
`{{comentario.url}}` ou `{{comentario}}` — os dois saem codificados uma vez só. Exemplo:

```
Ver meu desenho | https://exemplo.com.br/desenho/?nome={{comentario.url}}&utm_source=instagram&utm_medium=dm&utm_content={{post.codigo}}
```

## Faça: as ações

| Peça | O que faz |
| - | - |
| **enviar mensagem** | manda no WhatsApp do lead — ou no Direct, para lead só do Instagram que escreveu nas últimas 24 h |
| **DM no Instagram** | manda no Direct. Depois de um comentário, a primeira sai como **resposta privada** a ele (uma por comentário, até 7 dias); as seguintes só até 24 h depois da última mensagem da pessoa. Aceita até 3 botões: **resposta rápida** (`Título`) ou **link** (`Título \| https://…`). Na resposta privada vai só a **resposta rápida**: o botão de link vai na DM seguinte |
| **responder o comentário** | responde o comentário em público, embaixo dele no post |
| **mover de etapa** / **qualificar o lead** | muda o lead de etapa; qualificar leva à etapa marcada como "Qualificado" e manda a conversão para a Meta |
| **atribuir** · **avisar o time** · **mudar atendimento** · **abrir/fechar cadeira** · **etiqueta** · **preencher campo** | o resto do CRM, sem sair do fluxo |

### Variações do texto

A mesma frase mandada para centenas de pessoas é o que o Instagram e o WhatsApp leem como spam. Nas mensagens para
a pessoa (**enviar mensagem**, **DM no Instagram**, **responder o comentário** e as duas mensagens do **Portão de
seguidor**) você pode escrever **várias versões**, separadas por uma linha com só `---`:

```
Te mandei no direct 📥
---
Olha o seu direct, {{primeiro_nome}} 😉
---
Mandei agora no privado! Se não achar, veja em Solicitações de mensagem.
```

Cada pessoa recebe **uma** delas, e **sempre a mesma** se o passo rodar de novo. As variáveis valem em todas, e o
limite de caracteres vale para cada uma. Uma variação vazia (um `---` sobrando) impede a publicação; o **simular**
mostra qual versão sairia para o lead escolhido. Pela API ou pelo MCP, é o mesmo texto, com `\n`:
`"Te mandei no direct 📥\n---\nOlha o seu direct 😉"`.

## Decidir: condições e esperas

| Peça | O que faz | Saídas |
| - | - | - |
| **se / senão** | divide o caminho: origem, etapa, canal, etiqueta, campo do CRM, "tem conversa", "segue o perfil do Instagram"… | sim · não |
| **esperar** | segura o lead um tempo antes do próximo passo | uma |
| **esperar até a data** | segura até um horário de um campo, menos N ("24 h antes da reunião"); recalcula se a data mudar | na hora · passou |
| **Esperar resposta** | **para o fluxo até o lead responder** (veja abaixo) | Respondeu · Não respondeu |
| **Portão de seguidor** | **só libera para quem segue o perfil do Instagram**: pede, espera o toque, confere e pede de novo (veja abaixo) | Segue · Não liberou |
| **fim** | encerra o fluxo para o lead, inclusive as esperas dos outros caminhos | — |

## Esperar resposta

O fluxo para nesta peça e espera o lead responder, no canal da conversa (WhatsApp ou Direct). É o bloco de
"esperar a resposta" de ferramentas como o ManyChat:

* **a resposta vai para o fluxo que está esperando**, e não para os gatilhos **mensagem recebida**. Com vários
  fluxos esperando palavras parecidas (um por material, por exemplo), cada resposta acorda só quem está esperando
  por ela;
* **Respondeu** segue assim que a resposta chega e bate o filtro; **Não respondeu** segue quando o prazo acaba. Sem
  nada ligado no "Não respondeu", o caminho termina ali, com o motivo na trilha;
* a mensagem que **não bate** o filtro não conta: o lead continua esperando, e ela segue o caminho normal (os
  gatilhos "mensagem recebida" a recebem);
* dá para **voltar para a mesma espera** depois de uma mensagem — "ainda não me segue → já estou seguindo" — e o
  fluxo espera de novo. O teto de passos por dia do fluxo continua valendo.

| Campo | Valor |
| - | - |
| **Só se a resposta contém** | opcional. Várias palavras separadas por vírgula = qualquer uma delas, sem diferença de maiúscula nem de acento. O toque num botão de **resposta rápida** conta pelo título do botão ("Já estou seguindo" contém "seguindo"). Vazio = qualquer resposta |
| **O que acorda a espera** | **o que bate o filtro acima** (o padrão) · **Qualquer resposta**: a primeira mensagem de texto da pessoa (ou o toque no botão) acorda, e o filtro não conta. O texto vira `{{resposta}}` nas mensagens seguintes ("me diga o seu nome" → link com `{{resposta.url}}`) |
| **Esperar no máximo** | em horas, de 1 a 168 (7 dias). Vazio = 24 h |

> [!TIP]
>
> Com **Qualquer resposta**, a espera fica com a próxima mensagem da pessoa, seja ela qual for. Use um prazo curto
> (24 h) para não segurar uma conversa de outro assunto dias depois.

### Quem já estava esperando numa versão antiga

Publicar uma versão nova não mexe em quem já está dentro: cada lead termina pela versão em que entrou. Para levar
quem **está esperando** numa versão antiga para a versão no ar, use **Leads esperando numa versão antiga → migrar**
no painel do gatilho, ou a ferramenta `migrar_leads_do_fluxo` do MCP. Escolha a peça da versão no ar onde eles
continuam:

* um **Esperar resposta**: todos continuam esperando, agora nele, com o prazo que já tinham;
* uma ação, condição ou fim: o lead anda já, pelas travas de sempre. Só quem escreveu nas últimas **24 h** (a janela
  da Meta para mandar DM) anda; quem está fora é encerrado com o motivo "versão antiga".

A prévia mostra quantos e quem (nome mascarado) antes; o clique em **migrar** é a confirmação.

> [!NOTE]
>
> A mensagem que **criou** o lead não é resposta de ninguém, e um fluxo em **modo teste** que esteja esperando recebe
> a resposta (para você ver o que ele faria) sem tirá-la dos fluxos de verdade.

> [!TIP]
>
> Depois de um "Esperar resposta", a condição **segue o perfil do Instagram** sempre pergunta de novo ao Instagram — a
> pessoa pode ter acabado de seguir. Para o caso mais comum (o material exclusivo para seguidores), use o **Portão de
> seguidor**, logo abaixo: ele faz tudo isso num bloco só.

## Portão de seguidor

Um bloco que faz **tudo do seguidor** no Instagram, no modelo do ManyChat. Ele entra depois do **comentaram no
post** e do **responder o comentário** — ou em qualquer ponto em que o lead tenha conversa no Direct — e faz, por
dentro:

1. manda a DM do **pedido** com um botão de **resposta rápida** (“Quero o material”). Se ela é a primeira mensagem
   depois do comentário, sai como **resposta privada**, como na peça DM no Instagram;
2. **espera a pessoa responder** — qualquer resposta vale, e o toque no botão é uma resposta. Como no Esperar
   resposta, a resposta vai **para este fluxo**, e não para os gatilhos **mensagem recebida**;
3. pergunta ao Instagram, **naquela hora**, se a pessoa segue o perfil (o Instagram só responde depois de a pessoa
   escrever, por isso a pergunta vem depois da resposta);
4. se segue, sai por **Segue**;
5. se não segue, manda a DM “ainda não me segue” com o botão **Já estou seguindo** e volta a esperar;
6. passou do número de **tentativas**, ou o prazo acabou sem resposta: sai por **Não liberou**. Sem nada ligado no
   “Não liberou”, o caminho termina ali, com o motivo na trilha. Um toque no botão **depois** disso não volta ao
   portão: chega como mensagem comum. Em fluxo de material, use o prazo máximo (7 dias); ver
   [Portão de seguidor do Instagram](https://docs.metricaas.com.br/receitas/portao-de-seguidor-do-instagram.md).

| Campo | Valor |
| - | - |
| **Mensagem do pedido** | a 1ª DM. Vazio = “Eai, esse material é exclusivo para seguidores! Toca no botão aqui embaixo 👇” |
| **Botão do pedido** | resposta rápida, até 20 letras. Vazio = “Quero o material” |
| **Mensagem para quem ainda não segue** | vazio = “Vi aqui que você ainda não me segue… Me segue e toca no botão aqui embaixo 😉” |
| **Botão de quem ainda não segue** | resposta rápida, até 20 letras. Vazio = “Já estou seguindo” |
| **Esperar a resposta no máximo** | em horas, de 1 a 168 (7 dias), para cada DM. Vazio = 24 h |
| **Tentativas** | de 1 a 5: quantas vezes o bloco confere se a pessoa segue antes de sair por “Não liberou”. Vazio = 3 |

A **trilha** do fluxo mostra cada etapa em português: “pedido enviado”, “respondeu: …”, “não segue o perfil —
tentativa 2/3”, “segue o perfil — liberado”.

> [!NOTE]
>
> Se o Instagram recusar o botão na resposta privada, a mensagem sai **só com o texto** (a resposta privada é a única
> chance de falar com quem comentou) e a pessoa pode responder escrevendo — qualquer resposta vale.

Receita completa: [Portão de seguidor do Instagram](https://docs.metricaas.com.br/receitas/portao-de-seguidor-do-instagram.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.