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(oidé oconexao_id). Para iniciar uma automação com a mensagem direta, pegue oautomacao_idemGET /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: contemo comentário só precisa ter a palavra; emigualele é só a palavra. - A regra nasce desligada, a menos que você mande
ativo: true. Para pausar, usePATCHcomativo: false;DELETEnão tem volta. PATCHmuda 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_comentarioebotoessó 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 trazbotoes(títulos) ebotoes_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 traztipona resposta; filtre a listagem com?tipo=seguirou?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#
- GETListar contas do Instagram
/instagram/contas - GETListar automações para ligar a uma regra
/automacoes - GETListar regras de comentário
/regras-comentario - POSTCriar regra de comentário
/regras-comentario - GETVer uma regra de comentário
/regras-comentario/{id} - PATCHEditar regra de comentário
/regras-comentario/{id} - DELApagar regra de comentário
/regras-comentario/{id}
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.
| codigo | O que significa |
|---|---|
| regra_inexistente | Regra de comentário não encontrada (veja GET /regras-comentario). |
| regra_conexao_invalida | conexao_id precisa ser uma conta do Instagram conectada por login (veja GET /instagram/contas). |
| regra_sem_palavras | Informe de 1 a 30 palavras, ou use qualquer_comentario: true. |
| regra_modo_invalido | modo deve ser contem ou igual. |
| regra_sem_acao | A regra precisa de uma resposta pública ou de uma resposta privada. |
| regra_texto_longo | Texto longo demais: resposta pública até 2200 caracteres e resposta privada até 1000. |
| regra_variantes_demais | No máximo 5 respostas_publicas. |
| regra_extra_sem_publico | respostas_publicas e ocultar_apos só valem com responder_publico preenchido. |
| regra_automacao_invalida | automacao_id não é uma automação desta organização (veja GET /automacoes?gatilho=comentario). |
| regra_automacao_sem_privada | Para ligar uma automação, preencha resposta_privada. |
| regra_botao_longo | Cada botão tem no máximo 20 caracteres. |
| regra_botao_repetido | Botões repetidos. Cada botão deve ser diferente. |
| regra_botao_url_invalida | A url do botão deve ser um link https:// válido, com até 2000 caracteres. |
| regra_botoes_demais | No máximo 3 botões. |
| regra_botoes_invalidos | botoes deve ser uma lista de textos ou de objetos { titulo, url }. |
| regra_botoes_sem_privada | Para ter botões, preencha resposta_privada. |
| recurso_desligado | Este recurso não está liberado para a sua organização. |
| seguir_invalido | Algum 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_regras | Limite de 200 regras de comentário por organização. Apague alguma para criar outra. |