Automatize o comentário para DM no Instagram via API
O CommentKeyword transforma comentários do Instagram em conversas por DM automatizadas. A API REST permite criar gatilhos de palavras-chave, definir o texto das respostas e conectar agentes de IA programaticamente — para que suas ferramentas, fluxos de trabalho e agentes de IA gerenciem tudo sem tocar no painel.
// 1. Find your live AI agent
const agentsResponse = await ck.get("/api/agents");
const agent = agentsResponse.data.find((item) => item.status === "live");
if (!agent) throw new Error("No live agent found");
// 2. Create the keyword trigger
const keywordResponse = await ck.post("/api/keywords", {
keyword: "GUIDE",
matchMode: "contains",
scope: "global",
commentReplies: ["Sent it to you, {{namefirst}}!"],
dmMessages: ["Hey {{namefirst}}, here's your free guide."],
delaySec: 20,
aiAgentId: agent.id
});
// 3. Go live.
console.log("Live:", keywordResponse.data.id);Tudo o que você pode controlar via API
Um único token PAT dá ao seu código controle total sobre gatilhos de palavras-chave, texto de resposta e conexões de agentes de IA.
Criar e gerenciar palavras-chave
Crie um novo gatilho de palavra-chave em uma única requisição POST. Defina o modo de correspondência (exato ou contém), o escopo (global ou específico por publicação) e as variantes de mensagem sem tocar no painel.
POST /api/keywords
{
"keyword": "GUIDE",
"matchMode": "contains",
"scope": "global"
}Definir respostas a comentários e DMs
Inclua commentReplies e dmMessages na mesma chamada de criação ou atualização. Use placeholders como {{handle}}, {{name}} e {{namefirst}} para personalizar o texto no momento do envio.
{
"commentReplies": ["Sent it to you, {{namefirst}}!"],
"dmMessages": ["Hey {{namefirst}}, here's the guide."],
"delaySec": 20
}Anexar um agente de IA por ID
Se você tiver um agente de IA ativo no workspace, vincule-o a qualquer palavra-chave passando seu ID público. O agente assume as conversas por DM automaticamente depois que a pergunta gancho é disparada.
PATCH /api/keywords/{id}
{
"aiAgentId": "a6be1900-8f4f-4ae6-8f4e-48f8b28f0f17"
}Deixe seu agente de IA se configurar sozinho
Se você está construindo um sistema de IA — um GPT personalizado, um agente n8n, um fluxo Claude ou seu próprio backend —, pode dar a ele um token da API do CommentKeyword e deixar que ele gerencie toda a configuração de automação do Instagram.
O agente pode ler seus agentes ativos existentes, criar o gatilho de palavra-chave com o texto de resposta certo, anexar o agente de IA correto e ativar tudo — sem nenhuma interação manual com o painel.
- Sem login no painel depois que o token é configurado
- IDs de agentes de IA podem ser consultados via GET /api/agents
- Palavras-chave podem ser criadas em uma única requisição POST
- Atualizações PATCH parciais permitem trocar textos ou agentes sem recriá-los
- Desative palavras-chave quando a campanha terminar via PATCH
Exemplo: lançamento de campanha conduzido por agente
1. O gatilho da campanha dispara
Uma nova publicação de produto entra no ar. Seu fluxo de trabalho do n8n ou seu agente de IA recebe o evento.
2. O agente busca os agentes de IA disponíveis
Faz uma chamada a GET /api/agents para encontrar o agente ativo certo para esse tipo de campanha.
3. O agente cria a palavra-chave
Envia a palavra-chave, a resposta ao comentário, o texto do DM e o aiAgentId em uma única chamada. Define delaySec como 20.
4. Ativo em segundos
O CommentKeyword começa a monitorar os comentários em busca dessa palavra-chave imediatamente. Sem intervenção humana.
Quem usa a API
Qualquer fluxo de trabalho que precise criar ou atualizar automações de palavras-chave do Instagram sem trabalho manual no painel.
Agentes de IA que se autoconfiguram
Dê ao seu sistema de IA um PAT e ele poderá criar a palavra-chave, escrever a resposta e se integrar como o agente da conversa — sem nenhum trabalho manual no painel.
Fluxos de n8n, Make e Zapier
Dispare a criação ou atualização de palavras-chave a partir de plataformas de automação quando uma campanha começa, um produto é lançado ou um lead magnet entra no ar.
Dashboards personalizados e ferramentas para agências
Construa sua própria interface de gerenciamento sobre a API. Crie e atualize palavras-chave para vários clientes sem fazer login em cada workspace separadamente.
Campanhas via script
Escreva um script para configurar toda uma campanha do Instagram: crie a palavra-chave, defina o texto do DM e atualize-a ou desative-a conforme um cronograma — tudo a partir de um único script.
Servidor MCP — vindo a seguir
Um servidor Model Context Protocol exporia as ações do CommentKeyword como ferramentas nativas para Claude, GPT e qualquer sistema de IA compatível com MCP. Em vez de escrever chamadas HTTP, seu agente chamaria diretamente ferramentas como create_keyword ou attach_agent.
Se você está construindo um fluxo de trabalho de IA que se beneficiaria de uma integração MCP, fale conosco — isso nos ajuda a priorizar.
// Uso futuro do MCP
await agent.use("commentkeyword");
await create_keyword({
keyword: "LAUNCH",
aiAgentId: agentId,
});
Comece em minutos
Crie sua conta, gere um token PAT nas configurações do seu workspace e comece a fazer requisições.
1. Gere um token PAT
Nas configurações do seu workspace, crie um Personal Access Token e escolha as permissões que sua integração precisa: keywords:read, keywords:write ou agents:read.
2. Faça sua primeira requisição
curl -H "Authorization: Bearer TOKEN" \
https://commentkeyword.com/api/keywords3. Construa seu fluxo de trabalho
Crie palavras-chave, anexe agentes, defina o texto de resposta e gerencie campanhas a partir do seu código, da sua plataforma de automação ou do seu sistema de IA. Consulte a referência completa em /api-docs ou use a especificação OpenAPI legível por máquinas.
Perguntas frequentes
O que posso fazer com a API do CommentKeyword?
Você pode listar, criar, ler, atualizar e excluir gatilhos de palavras-chave. Cada palavra-chave pode incluir respostas a comentários, mensagens de DM, configurações de correspondência e o anexo opcional de um agente de IA. A API também expõe um endpoint de leitura para seus agentes de IA, para que você possa consultar IDs de agentes programaticamente.
Como faço a autenticação?
Use um Personal Access Token (PAT) emitido nas configurações do seu workspace. Passe-o no header Authorization como token Bearer. Os tokens têm escopo de workspace e não expiram automaticamente.
Posso anexar um agente de IA a uma palavra-chave via API?
Sim. Inclua o campo aiAgentId em uma requisição POST ou PATCH. O valor deve ser o ID público de um agente ativo no mesmo workspace. Você pode recuperar todos os IDs de agentes no endpoint GET /api/agents.
Já existe um servidor MCP disponível?
Ainda não, mas está no roadmap. Um servidor MCP permitiria que agentes de IA interoperassem com o CommentKeyword diretamente por meio do Model Context Protocol, sem escrever chamadas HTTP brutas. Se você está construindo um sistema de IA e isso importa para o seu fluxo de trabalho, fale conosco — isso ajuda a priorizar.
Preciso de um plano pago para usar a API?
A API está disponível em todos os planos, incluindo o gratuito. Contas gratuitas incluem 300 DMs automatizados por mês. Planos pagos desbloqueiam volumes maiores, agentes de IA e recursos adicionais que também podem ser gerenciados via API.
Existe limite de requisições (rate limit)?
A API do CommentKeyword tem rate limit por token de workspace. A entrega no Instagram é colocada em fila separadamente para cada conta profissional conectada e segue os limites específicos de cada endpoint da Meta. Se a Meta limitar uma requisição, as mensagens e respostas elegíveis são atrasadas e reenviadas automaticamente.
Construa uma vez. Deixe a API cuidar do resto.
O CommentKeyword dá ao seu código — e aos seus agentes de IA — controle total sobre gatilhos de palavras-chave, texto de resposta e roteamento de conversas de IA. Comece grátis e adicione o token da API nas configurações do seu workspace.