Pular para o conteúdo

Automações do Instagram

Regras de comentário: palavra-chave, resposta pública e mensagem direta.

As automações do Instagram respondem comentários nos seus posts: a regra olha as palavras do comentário, responde em público (se você quiser) e manda uma mensagem no direct de quem comentou. Duas permissões: automacoes:ler (regras, contas do Instagram e automações) e automacoes:escrever (criar, editar, ligar, desligar e apagar regras). O módulo Automações precisa estar no plano.

  • Comece por GET /instagram/contas (o id é o conexao_id). Para iniciar uma automação com a mensagem direta, pegue o automacao_id em GET /automacoes?gatilho=comentario.
  • Sempre informe `post_id`. Sem ele (null) a regra vale para todas as publicações da conta e responde em qualquer post.
  • A primeira regra que combinar com o comentário é a que vale. Em modo: contem o comentário só precisa ter a palavra; em igual ele é só a palavra.
  • A regra nasce desligada, a menos que você mande ativo: true. Para pausar, use PATCH com ativo: false; DELETE não tem volta.
  • PATCH muda só os campos enviados, mas o resultado final precisa ser válido (por exemplo, não dá para ficar sem resposta pública e sem resposta privada).
  • qualquer_comentario e botoes só funcionam se estiverem liberados na organização; senão a resposta é 403 recurso_desligado.
  • Cada botão é um texto (devolve o toque) ou { "titulo": "Agendar", "url": "https://..." } (abre o link; só https, até 2000 caracteres, 422 regra_botao_url_invalida). A resposta traz botoes (títulos) e botoes_detalhe (título e link). Se a Meta recusar os botões na resposta a um comentário, a mensagem sai uma vez só com texto e os links vão no fim dele: o link nunca se perde.
  • Limite de 200 regras por organização (422 limite_de_regras).
  • Dois tipos de regra. tipo: "comum" é o padrão (e o que toda regra antiga é): responde o comentário e manda a mensagem no direct. tipo: "seguir" entrega um conteúdo só para quem segue o seu perfil. O fluxo, todos os campos e os padrões estão no guia Seguir para receber. Toda regra traz tipo na resposta; filtre a listagem com ?tipo=seguir ou ?tipo=comum.
  • Toda mudança fica na auditoria da organização com o nome da chave. Ids de outra organização dão 404.
  • Fora da API de propósito: regras por expressão regular, criação e edição de automações (fluxos) e listar as publicações da conta.
Regra comum (tipo omitido = comum)
{
  "nome": "Comente QUERO",
  "conexao_id": "54b27747-86c2-455a-91a4-c0c02d0bd891",
  "post_id": "17912345678901234",
  "palavras": ["quero"],
  "responder_publico": "Te mandei no direct!",
  "resposta_privada": "Oi, {nome}! Aqui está o link: https://exemplo.com.br/oferta"
}

Endpoints#

Códigos de erro#

Além dos gerais (chave, limite, JSON), estes podem vir em erro.codigo nas rotas daqui. Todos estão em Erros.

Códigos de erro
codigoO que significa
regra_inexistenteRegra de comentário não encontrada (veja GET /regras-comentario).
regra_conexao_invalidaconexao_id precisa ser uma conta do Instagram conectada por login (veja GET /instagram/contas).
regra_sem_palavrasInforme de 1 a 30 palavras, ou use qualquer_comentario: true.
regra_modo_invalidomodo deve ser contem ou igual.
regra_sem_acaoA regra precisa de uma resposta pública ou de uma resposta privada.
regra_texto_longoTexto longo demais: resposta pública até 2200 caracteres e resposta privada até 1000.
regra_variantes_demaisNo máximo 5 respostas_publicas.
regra_extra_sem_publicorespostas_publicas e ocultar_apos só valem com responder_publico preenchido.
regra_automacao_invalidaautomacao_id não é uma automação desta organização (veja GET /automacoes?gatilho=comentario).
regra_automacao_sem_privadaPara ligar uma automação, preencha resposta_privada.
regra_botao_longoCada botão tem no máximo 20 caracteres.
regra_botao_repetidoBotões repetidos. Cada botão deve ser diferente.
regra_botao_url_invalidaA url do botão deve ser um link https:// válido, com até 2000 caracteres.
regra_botoes_demaisNo máximo 3 botões.
regra_botoes_invalidosbotoes deve ser uma lista de textos ou de objetos { titulo, url }.
regra_botoes_sem_privadaPara ter botões, preencha resposta_privada.
recurso_desligadoEste recurso não está liberado para a sua organização.
seguir_invalidoAlgum campo de `seguir` é inválido. A mensagem diz qual: textos de 1 a 640 caracteres (os de "já segue" e "seguiu depois" podem ser vazios), botões de 1 a 20 e sem `{` (botão não troca variáveis), cada texto até 900 bytes (emoji e acento contam mais), sem caractere de controle ou invisível, `max_tentativas` de 1 a 50 e link do conteúdo em https.
limite_de_regrasLimite de 200 regras de comentário por organização. Apague alguma para criar outra.