Regras de comentários

Como criar regras que respondem, ocultam, apagam ou curtem comentários sozinhas no Instagram, no Facebook e no TikTok, e que respondem perguntas no Mercado Livre.

Uma regra de comentários age sozinha sobre cada comentário novo de outra pessoa numa conta conectada: responde em público, responde em privado, oculta, apaga ou curte, conforme o canal. No Mercado Livre, a regra vale para as perguntas dos anúncios, e a resposta pública é a resposta à pergunta.

As rotas estão nos grupos Instagram, Facebook, TikTok e Mercado Livre da Referência da API. Para conectar as contas, veja Conectar canais.

Como uma regra é escolhida

  1. Chega um comentário novo de outra pessoa. Comentários da própria conta e comentários ocultos não rodam regras.
  2. As regras da conta são lidas por priority crescente (o número menor roda antes); no empate, as regras de uma publicação específica vêm antes das que valem para todas, e depois vale a data de criação. Uma regra com publicação definida só vale para os comentários dessa publicação; sem publicação, vale para todas.
  3. A primeira regra ligada que combinar com o comentário roda, e as outras são ignoradas. Cada comentário roda no máximo uma regra, mesmo que o aviso do canal chegue mais de uma vez.
  4. As ações da regra rodam na ordem de actions. Uma ação que falha não impede as outras.

Combinação

matchCombina quando
anySempre. keywords não é usado.
contains (padrão)O comentário contém uma das palavras de keywords.
exactO comentário inteiro é igual a uma das palavras de keywords.

A comparação ignora maiúsculas, acentos e espaços nas pontas: "preço" combina com "PRECO". Com contains ou exact, keywords precisa de pelo menos uma palavra. Palavras vazias e repetidas são removidas ao salvar.

Textos das respostas

publicReplyText é o texto de public_reply e privateReplyText, o de private_reply; cada um é obrigatório quando a ação está na regra. Os dois aceitam:

MarcadorVira
{USERNAME}O nome de quem comentou.
{{comment}}O texto do comentário.

Uma resposta privada vai para a caixa de mensagens de quem comentou. Cada comentário recebe no máximo uma resposta privada, e só até 7 dias depois do comentário; sem a data do comentário, a resposta privada não é enviada.

Criar uma regra

Cada canal tem as próprias rotas, e o campo da publicação muda de nome:

CanalRotasPublicação
Instagram/instagram/accounts/{id}/comment-rules e /instagram/accounts/{id}/comment-rules/{ruleId}igMediaId
Facebook/facebook/pages/{id}/comment-rules e /facebook/pages/{id}/comment-rules/{ruleId}postId
TikTok/tiktok/accounts/{id}/comment-rules e /tiktok/accounts/{id}/comment-rules/{ruleId}containerId
Mercado Livre/mercadolivre/accounts/{id}/comment-rules e /mercadolivre/accounts/{id}/comment-rules/{ruleId}containerId, o id do anúncio

GET lista e POST cria; DELETE remove uma regra. Para alterar, use PUT (no Mercado Livre, PATCH): nos quatro canais o corpo substitui a regra inteira, e um campo ausente fica vazio (enabled ausente desliga a regra). {id} é o id da conta ou da página no painel.

curl -X POST "https://api.vozkoia.com/instagram/accounts/ACCOUNT_ID/comment-rules" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "X-Workspace-ID: SEU_WORKSPACE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Preço no direct",
    "enabled": true,
    "igMediaId": "",
    "match": "contains",
    "keywords": ["preço", "valor"],
    "actions": ["public_reply", "private_reply"],
    "publicReplyText": "Oi @{USERNAME}, te mandei os detalhes no direct!",
    "privateReplyText": "Olá {USERNAME}! Recebemos seu comentário: {{comment}}",
    "priority": 0
  }'

No Mercado Livre, uma regra que responde perguntas sobre frete em todos os anúncios:

{
  "name": "Frete",
  "enabled": true,
  "containerId": "",
  "match": "contains",
  "keywords": ["frete"],
  "actions": ["public_reply"],
  "publicReplyText": "Olá! O frete é calculado no anúncio pelo seu CEP.",
  "priority": 0
}
RecusaQuando
400 invalid_ruleSem name, sem ações, ação desconhecida ou que o canal não aceita, keywords vazio com contains ou exact, texto de resposta vazio ou longo demais. A mensagem diz qual.
404 not_foundRegra inexistente ou de outra conta.
404Conta ou página fora do workspace do cabeçalho X-Workspace-ID.

O que cada canal aceita

Esta seção é gerada a partir das mesmas regras que conferem cada regra ao salvar, então traz exatamente o que a API aceita hoje. Uma ação que o canal não aceita recusa a regra com 400 invalid_rule.

Canalpublic_replyprivate_replyhidedeletelike
InstagramSimSimSimNãoNão
FacebookSimSimSimSimSim
TikTokSimNãoSimNãoSim
Mercado LivreSimNãoNãoSimNão

Tamanho das respostas

O texto é conferido ao salvar com {USERNAME} trocado por um nome do maior tamanho que o canal permite, e de novo antes de cada envio, já com o nome e o comentário reais. Uma resposta que passa do limite no envio não é enviada, e as outras ações da regra seguem.

CanalResposta pública (publicReplyText)Resposta privada (privateReplyText)Maior nome considerado
Instagram2.200 caracteres1.000 bytes em UTF-830 caracteres
Facebook8.000 caracteres2.000 caracteres100 caracteres
TikTok1.200 caracteresNão se aplica24 caracteres
Mercado Livre2.000 caracteresNão se aplica64 caracteres