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
- Chega um comentário novo de outra pessoa. Comentários da própria conta e comentários ocultos não rodam regras.
- As regras da conta são lidas por
prioritycrescente (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. - 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.
- As ações da regra rodam na ordem de
actions. Uma ação que falha não impede as outras.
Combinação
match | Combina quando |
|---|---|
any | Sempre. keywords não é usado. |
contains (padrão) | O comentário contém uma das palavras de keywords. |
exact | O 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:
| Marcador | Vira |
|---|---|
{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:
| Canal | Rotas | Publicação |
|---|---|---|
/instagram/accounts/{id}/comment-rules e /instagram/accounts/{id}/comment-rules/{ruleId} | igMediaId | |
/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
}| Recusa | Quando |
|---|---|
400 invalid_rule | Sem 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_found | Regra inexistente ou de outra conta. |
404 | Conta 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.
| Canal | public_reply | private_reply | hide | delete | like |
|---|---|---|---|---|---|
| Sim | Sim | Sim | Não | Não | |
| Sim | Sim | Sim | Sim | Sim | |
| TikTok | Sim | Não | Sim | Não | Sim |
| Mercado Livre | Sim | Não | Não | Sim | Nã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.
| Canal | Resposta pública (publicReplyText) | Resposta privada (privateReplyText) | Maior nome considerado |
|---|---|---|---|
| 2.200 caracteres | 1.000 bytes em UTF-8 | 30 caracteres | |
| 8.000 caracteres | 2.000 caracteres | 100 caracteres | |
| TikTok | 1.200 caracteres | Não se aplica | 24 caracteres |
| Mercado Livre | 2.000 caracteres | Não se aplica | 64 caracteres |