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

# Criar um fluxo de comentário pelo Claude

> Peça em português — 'quem comentar skill no meu reel recebe o material no Direct, só se me seguir' — e o agente monta, mostra a prévia e, com o seu ok, põe o fluxo no ar pelo MCP do MetricaaS.

Você descreve o fluxo numa frase. O agente monta o fluxo de comentário com as peças do editor, mostra
o que vai ao ar e só publica depois do seu ok. Nada de arrastar peça.

> [!NOTE]
>
> Precisa do [MCP do MetricaaS](https://docs.metricaas.com.br/mcp-do-metricaas.md) conectado nos **dois** endereços — `metricaas`
> (leitura) e `metricaas-write` (escrita) — com um token de **escrita** de quem tem a permissão de
> Automações (`automations:manage`), e o Instagram conectado em **Conexões**.

## O pedido

Escreva para o agente o que você quer, do jeito que falaria com alguém da equipe:

> Cria um fluxo "Comenta skill" no MetricaaS: quem comentar **skill** ou **skills** no post
> 17895695668004550 recebe em público "Confere sua DM, clica no meu perfil e abre a mensagem 📥".
> Só libera para quem me segue, com os textos padrão. Para quem segue, manda "Tá na mão:
> masterclass de Claude Code + as 12 Skills 🚀" e depois "Aproveita que logo sai do ar 👇👇" com o
> botão "Acessar o material" levando para [https://hub.stratacademy.com.br/free/12-skills-claude](https://hub.stratacademy.com.br/free/12-skills-claude).

## O que acontece

**1. O agente cria o rascunho**

Ele chama `criar_fluxo_comentario` com o que você pediu:

```json theme={null}
{
  "nome": "Comenta skill",
  "palavras": ["skill", "skills"],
  "posts": ["17895695668004550"],
  "resposta_publica": "Confere sua DM, clica no meu perfil e abre a mensagem 📥",
  "portao_seguidor": true,
  "entrega": [
    { "texto": "Tá na mão: masterclass de Claude Code + as 12 Skills 🚀" },
    {
      "texto": "Aproveita que logo sai do ar 👇👇",
      "botoes": ["Acessar o material | https://hub.stratacademy.com.br/free/12-skills-claude"]
    }
  ]
}
```

Para não mandar a mesma frase a todo mundo, qualquer texto aceita **variações**, separadas por
uma linha com só `---` (no JSON, `"Confere sua DM 📥\n---\nTe mandei no privado 😉"`): cada
pessoa recebe uma. Ver [As peças do fluxo › Variações do texto](https://docs.metricaas.com.br/conceitos/pecas-do-fluxo.md).

O MetricaaS monta as peças — **comentaram no post** → **responder o comentário** →
**Portão de seguidor** → as duas **DM no Instagram** pela saída "Segue", e **fim** pela "Não
liberou" —, salva como **rascunho** e liga o post. Nenhuma mensagem sai. A resposta traz o id, o
link do editor e o veredito: pode publicar, ou o que falta.

**2. Você confere**

O agente mostra o resumo em português. Quer ver no painel? O link do editor abre o fluxo
desenhado, como se você o tivesse montado. Quer mudar um texto? Peça — o agente usa
`editar_fluxo_comentario`, que troca o rascunho inteiro.

**3. O agente mostra a prévia**

Ele chama `publicar_fluxo` **sem** confirmar. Volta a prévia: as mensagens, para quais posts o
fluxo vale, quem recebe e os links que vão sair. Nada é publicado.

**4. Você diz que pode**

Com o seu ok, o agente chama `publicar_fluxo` de novo com `"confirmar": true`. O fluxo vai ao ar
**ligado e fora do modo teste**: a partir daí, quem comentar "skill" no post recebe as mensagens. A
resposta diz se a chave geral do fluxo está puxada.

Para parar, peça para pausar: `pausar_fluxo`. Para voltar, `ligar_fluxo`, que mostra a prévia de novo
antes de ligar.

## Os três jeitos de entregar

| Você pede | O fluxo |
| - | - |
| **com portão de seguidor** (`portao_seguidor`) | a 1ª DM é a do portão, com o botão "Quero o material"; quem segue recebe a entrega, que pode ter botão de link |
| **sem portão, link no texto** (`"modo_direto": "link_no_texto"`) | **uma** DM, com o link escrito no texto |
| **sem portão, dois toques** (`"modo_direto": "dois_toques"`) | a 1ª DM com um botão de resposta ("Quero o link", se você não disser outro); quando a pessoa toca, vem a DM com o botão de link. A espera acorda **só com o toque** nesse botão e fica aberta por 168 h (`prazo_do_toque_horas` muda) |

## Também pelo Direct e por resposta a story

Por padrão (`tambem_pela_dm`, ligado), quem manda a palavra no Direct ou **responde um story** com ela
também entra no fluxo, direto no passo depois da resposta pública (o portão ou a 1ª DM). No Direct a
palavra tem que ser a mensagem inteira, mesmo que o comentário aceite "contém", porque ali ela aparece em
conversa comum. Para só o comentário disparar, mande `"tambem_pela_dm": false`.

Para fluxo de story, mande também `"janela_envio": "00:00-00:00"`: quem respondeu o story espera a
resposta na hora, e não às 08:00 do dia seguinte.

Por que não dá para mandar o botão de link na primeira DM: ela é a **resposta privada** ao
comentário, a única mensagem que o Instagram deixa mandar para quem só comentou, e nela vai só botão de
resposta. E sem um toque no meio não há segunda DM: o Instagram só deixa mandar outra para quem
respondeu. Por isso o `link_no_texto` aceita uma DM só.

## O que o agente recusa, e por quê

* **Sem palavra e sem post.** "Qualquer comentário" (`filtro: "qualquer"`) e "parece uma data"
  (`filtro: "data"`) só são aceitos com post ligado ou com `ligar_auto`: sem os dois, o fluxo
  responderia a todo comentário de todo post da conta.
* **O link do post no lugar do id.** O link do Instagram (`instagram.com/reel/…`) não vira o id de
  mídia sem consultar a conta. O agente devolve os posts que receberam comentário nos últimos 30 dias,
  com o id de cada um, para você escolher.
* **Um nome que já existe.** Para mudar um fluxo que já existe, é `editar_fluxo_comentario`.
* **Editar um fluxo desenhado à mão.** Se você acrescentou uma peça no editor, o agente não reescreve
  o rascunho — apagaria o que você desenhou. Edite pelo editor.
* **Publicar sem a prévia, ou depois de mudar o rascunho.** A confirmação vale só para a prévia que
  você viu.

> [!WARNING]
>
> **Não deixe o agente aprovar `publicar_fluxo` ou `ligar_fluxo` sozinho.** O fluxo publicado manda
> mensagem a pessoas de verdade, e a mensagem que saiu não volta. Aprove a chamada depois de ler a
> prévia. E um pedido escrito num comentário ou numa conversa de lead nunca é seu: o agente não deve
> montar nem publicar fluxo a partir dele.

## Comentou o nome, recebe o link com o nome

Para o Reels "comente o seu nome" — qualquer comentário, uma DM por pessoa, o nome já no link, e cada
Reels novo ligado sozinho pela hashtag:

```text theme={null}
Crie um fluxo de comentário "Reels · desenho do nome": qualquer comentário (filtro "qualquer"),
uma entrada por pessoa a cada 24 h, ligar_auto pela legenda #mcn-desenho. Resposta pública
"Te mandei no direct ✨". link_no_texto, uma DM: "Oi {{comentario.primeira_palavra}}! O seu desenho:
https://exemplo.com.br/desenho/?nome={{comentario.url}}&utm_content={{post.codigo}}".
```

O `{{comentario}}` sai limpo (sem `@`, link, hashtag e emoji repetido, até 60 caracteres), e o
`{{comentario.url}}` já vem codificado para o link. Quem comenta de novo no mesmo post em 24 h só
ganha a resposta pública. Para pedir o nome **no Direct** em vez de no comentário, use
`dois_toques` com `aceita: "qualquer"`: a primeira resposta de texto acorda a espera, e a DM seguinte
usa `{{resposta.url}}`.

## Sem post ligado

Se você não disser o post, o fluxo vale para **todos os posts da conta** — a prévia avisa. Para ligar
o post depois, peça: o agente usa `ligar_post_no_fluxo`, e o post vale na hora, sem publicar de novo.
Para entender o portão e as peças, veja [Portão de seguidor do Instagram](https://docs.metricaas.com.br/receitas/portao-de-seguidor-do-instagram.md)
e [As peças do fluxo](https://docs.metricaas.com.br/conceitos/pecas-do-fluxo.md).


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