Comentário para DMAPI

Transforme comentários “me manda o link” em mensagens privadas

Crie uma automação e o FoPost monitora os comentários das suas contas do Instagram e do Facebook. Quando um comentário corresponde, quem comentou recebe uma resposta privada na DM, retida primeiro para sua aprovação, a menos que você diga o contrário.

Obtenha sua chave de APILer a documentação
POST /v1/automations
curl -X POST https://api.fopost.com/v1/automations \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "9b2f6c1e-...",
    "name": "Price comments to DM",
    "triggerType": "inbox_message",
    "triggerConfig": { "keywords": ["price", "link"], "types": ["comment"], "maxRunsPerDay": 20 },
    "graph": {
      "nodes": [
        { "id": "t1", "kind": "trigger" },
        { "id": "m1", "kind": "send_message", "config": {
          "channel": "private",
          "text": "Hi {{contact.name}}, here is the link you asked for.",
          "buttons": [{ "title": "Shop now", "url": "https://yourbrand.com/shop" }]
        } }
      ],
      "edges": [{ "id": "e1", "source": "t1", "target": "m1" }]
    }
  }'

Correspondência de palavra-chave

Qualquer uma ou todas de até 20 palavras-chave, só em comentários ou em todos os tipos de mensagem.

Aprovação primeiro

Novas automações retêm cada resposta até uma pessoa aprová-la antes do envio.

Uma vez por comentário

Um comentário é reservado antes de a DM sair, então nunca é respondido duas vezes.

Gatilho

Decida quais comentários recebem uma mensagem

O gatilho inbox_message dispara em novos comentários, menções, respostas, DMs, respostas a stories e avaliações. Restrinja com palavras-chave, tipos de mensagem, contas específicas ou posts específicos, e escolha responder apenas a seguidores ou apenas à primeira mensagem de alguém. Cada automação roda no máximo 3 vezes por dia por padrão; aumente maxRunsPerDay até 20.

Leia a referência de gatilhos
Automações rodando em agenda, em um feed e entre redes

Por post

postIds limita a automação aos comentários dos posts que você indicar.

Só seguidores

followersOnly ignora quem comenta sem seguir a conta.

Limite diário

maxRunsPerDay evita que um post viral dispare centenas de mensagens.

Mensagem

Uma resposta privada, escrita do seu jeito

A etapa send_message com channel definido como private envia uma DM a quem comentou por meio da resposta privada da Meta. Use {{contact.name}} e {{message.text}} no texto, adicione até 3 botões de link ou 13 respostas rápidas e anexe um link que recebe tags UTM e um redirecionamento contado. A Meta só aceita uma resposta privada em até 7 dias após o comentário, então comentários mais antigos falham com esse motivo.

Veja a etapa send_message
POST /v1/automations/:id/dry-run
curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../dry-run \
  -H "X-API-Key: $API_KEY"

{
  "would_defer": false,
  "approval_mode": false,
  "steps": [
    { "node_id": "t1", "action_type": "trigger", "status": "completed", ... },
    { "position": 1, "node_id": "m1", "action_type": "send_message", "status": "completed",
      "handle": "out", "error_message": null,
      "output": { "messagePreview": "Hi Jordan, here is the link you asked for.", "channel": "private" } }
  ],
  "drafts": [],
  "total_delay_ms": 0,
  "credits_charged": 0
}

Simulação

Visualize a mensagem em um comentário recente. Nada é enviado nem criado.

Links rastreados

Os cliques são contados e a URL leva utm_medium=dm.

Janela de 7 dias

Limite da Meta para respostas privadas, verificado antes de qualquer envio.

Controle

Aprove, pause e audite cada execução

A menos que uma etapa defina requireApproval como false, cada resposta aguarda em GET /v1/inbox/approvals até alguém aprovar ou rejeitar. Ative e desative a automação com uma chamada e leia o histórico de execuções para ver o que disparou, o que está aguardando e o que falhou.

Comece a construir
POST /v1/automations/:id/toggle
curl "https://api.fopost.com/v1/inbox/approvals?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/inbox/approvals/:id/approve -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../toggle -H "X-API-Key: $API_KEY"

{ "id": "f2b7d9a4-...", "active": false }

Histórico de execuções

GET /v1/automations/:id/runs com status, horário de início e qualquer erro.

Reexecutar

Execute de novo uma execução passada depois de corrigir a mensagem ou o gatilho.

Versões

Cada alteração salva é uma versão que você pode ver ou restaurar.

Perguntas sobre Comentário para DM, respondidas

Quais redes suportam comentário para DM?

Instagram e Facebook. A resposta privada a comentários é um recurso da Meta, e outras redes não oferecem equivalente. A mesma automação ainda pode responder comentários publicamente em outras redes com channel definido como same.

A mesma pessoa pode receber a mensagem duas vezes?

Não para o mesmo comentário. O comentário é marcado antes do envio da DM e uma automação dispara apenas uma vez por comentário, então novas tentativas e execuções repetidas não enviam nada novo.

Ela envia sem ninguém conferir?

Não por padrão. Uma etapa send_message criada sem requireApproval retém toda resposta para aprovação. Defina requireApproval como false na etapa quando estiver pronto para o envio automático.

O que acontece com comentários com mais de 7 dias?

A Meta não permite resposta privada após 7 dias, então a execução falha com esse motivo e nada é enviado.

De quais escopos de chave de API eu preciso?

Criar e gerenciar automações exige o escopo automations. Listar e aprovar respostas retidas usa o escopo inbox.

Posso iniciar uma automação a partir do meu próprio sistema?

Sim, com outro gatilho. Uma automação com o gatilho api_webhook roda quando você faz POST em /v1/automations/:id/trigger com o segredo no cabeçalho x-automation-secret.

Comece a construir com Comentário para DM hoje

Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.

Obtenha sua chave de API