API PARA DESENVOLVEDORES

Ligue o seu sistema
ao Notifiquei.

Crie, ligue e desligue automações “comenta QUERO” do Instagram direto do seu sistema. Você diz o que deve acontecer; o Notifiquei cuida do resto.

Testar na referência Pegar minha chave

Última novidade: Pedir para seguir a conta agora é opcional (14/10/2026)

O que dá para fazer

Comenta QUERO

Alguém comenta a palavra no post, recebe uma resposta pública e a mensagem no direct, com botão ou carrossel de produtos.

Ligar e desligar

Veja as automações do time, o que cada uma envia, e ligue ou desligue quando quiser.

A API não manda mensagem sozinha. Ela só deixa tudo pronto. Quem dispara o envio é o comentário de verdade no Instagram — e é isso que mantém tudo dentro das regras da Meta.

Começo rápido

Pegue a sua chave

No painel, abra API (app.notifiquei.com.br/api-keys) e clique em Gerar chave. Só o dono do time gera chaves. A chave começa com ntq_live_ e aparece uma vez só: guarde num lugar seguro. Perdeu? Gere outra e revogue a antiga.

A chave é presa a um time: ela só enxerga as contas do Instagram daquele time.
Faça o primeiro pedido

Toda chamada leva a chave no cabeçalho X-API-Key. Comece listando as contas:
```
curl -X GET https://api.notifiquei.com.br/partners/accounts \
  -H "X-API-Key: SUA_CHAVE_AQUI"
```
Guarde o id da conta. Se podeCriarAutomacao vier false, o dono precisa reconectar a conta no painel.
Crie o seu “comenta QUERO”

Pegue o primeiro exemplo de Exemplos prontos e troque o contaInstagram pelo id do passo 2. Com "posts": "proximo", a automação espera o próximo post publicado e se prende a ele sozinha. Outras opções: "todos" ou a lista de IDs de post.
Confira e controle

GET /partners/automations mostra todas, com o alvo em vigor. Para desligar: PATCH /partners/automations/{id}/status com {"ativa": false}.

Usa o Claude? Tem um atalho

Na tela de chaves, o botão Copiar kit pro Claude entrega um texto com a sua chave já dentro. Cole nas instruções de um Projeto do Claude e converse em português (“cria um comenta QUERO no meu próximo post com esses links”). O Claude faz as chamadas e confirma com você antes de criar.

Exemplos prontos

Os mesmos exemplos da referência, prontos para copiar. Troque SUA_CHAVE_AQUI pela sua chave.

POST /partners/automations — Comenta QUERO no próximo post (o clássico)

curl -X POST https://api.notifiquei.com.br/partners/automations \
  -H "X-API-Key: SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
  "nome": "Comenta QUERO — Planner",
  "contaInstagram": "17841405503524573",
  "palavras": [
    "quero",
    "eu quero"
  ],
  "posts": "proximo",
  "respostaPublica": [
    "Te enviei no direct! 😉",
    "Enviado, confere lá! 😊"
  ],
  "mensagens": [
    {
      "texto": "Oi! Vi seu comentário 🤗 Toque abaixo para receber o link:",
      "botoes": [
        {
          "rotulo": "Quero o link",
          "acao": "continuar"
        }
      ]
    },
    {
      "texto": "Aqui está: https://loja.exemplo.com/planner ✨"
    }
  ]
}'

POST /partners/automations — Carrossel de produtos (achadinhos) — só nome e link

curl -X POST https://api.notifiquei.com.br/partners/automations \
  -H "X-API-Key: SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
  "nome": "Achadinhos de beleza — comenta QUERO",
  "contaInstagram": "17841405503524573",
  "palavras": [
    "quero"
  ],
  "posts": "todos",
  "respostaPublica": [
    "Te mandei os links no direct! 😍"
  ],
  "mensagens": [
    {
      "texto": "Separei os achadinhos pra você 💖 Toque abaixo:",
      "botoes": [
        {
          "rotulo": "Ver os produtos",
          "acao": "continuar"
        }
      ]
    },
    {
      "cards": [
        {
          "nome": "Pó translúcido Bella",
          "link": "https://s.shopee.com.br/4ftndxVAcy"
        },
        {
          "nome": "Base matte X",
          "link": "https://s.shopee.com.br/outroLink"
        },
        {
          "link": "https://s.shopee.com.br/maisUm"
        }
      ]
    }
  ]
}'

POST /partners/automations — Só em posts escolhidos, com botão de link no fim

curl -X POST https://api.notifiquei.com.br/partners/automations \
  -H "X-API-Key: SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
  "nome": "Comenta QUERO — só no post do lançamento",
  "contaInstagram": "17841405503524573",
  "palavras": [
    "quero"
  ],
  "posts": [
    "18100000001"
  ],
  "mensagens": [
    {
      "texto": "Oba! Toque abaixo para receber o cupom:",
      "botoes": [
        {
          "rotulo": "Quero o cupom",
          "acao": "continuar"
        }
      ]
    },
    {
      "texto": "Seu cupom: LANCA10 🎉",
      "botoes": [
        {
          "rotulo": "Ir para a loja",
          "acao": {
            "link": "https://loja.exemplo.com"
          }
        }
      ]
    }
  ]
}'

Regras dos botões

Até 3 botões por mensagem, com até 20 letras. "acao": "continuar" envia a mensagem seguinte (precisa existir uma); "acao": {"link": "https://..."} abre um site. A 1ª mensagem com “continuar” chega como resposta rápida e, depois do toque, o sistema confere se a pessoa segue a conta antes de mandar o resto.

Carrossel de produtos: mande só o link de afiliado — a foto e o nome saem da própria página do link. De 1 a 10 cards; uma mensagem tem texto ou cards, nunca os dois.

Todas as rotas

Esta lista vem direto da API, então está sempre em dia. Clique numa rota para ver os detalhes e testar. Versão v1 · 1.2.277

Tipo	Rota	Limite
Contas e posts
GET	`/partners/accounts`Listar as contas Instagram da chave	60 por minuto
GET	`/partners/accounts/{instagramId}/posts`Listar os posts recentes de uma conta	30 por minuto
Automações
GET	`/partners/automations`Listar as automações	60 por minuto
POST	`/partners/automations`Criar uma automação "comenta QUERO"	30 por minuto
GET	`/partners/automations/{id}`Ver uma automação	60 por minuto
PATCH	`/partners/automations/{id}/status`Ligar ou desligar uma automação	60 por minuto

Limites

Pedidos por minuto

Cada chave tem a sua cota, separada das outras. O limite de cada rota está na tabela acima. Passou, volta 429: espere alguns segundos e tente de novo.

Automações por chave

Uma chave pode ter um teto de automações criadas. Ao chegar nele, a criação volta 403.

Do Instagram

Até 3 botões por mensagem, 20 letras por botão e até 10 cards por carrossel de produtos.

Erros comuns

Todo erro vem com uma message em português dizendo o que aconteceu.

Código	Quando acontece	O que fazer
`400`	Pedido com algo errado (campo faltando, botão “continuar” sem mensagem depois, `posts` inválido)	Leia a `message`: ela diz o campo e como corrigir
`401`	Chave ausente, inválida ou revogada	Confira o cabeçalho `X-API-Key`
`403`	Conta desconectada ou com a conexão vencida; teto de automações da chave; plano vencido ao ligar	Reconectar a conta no painel ou falar com a gente
`404`	A conta ou a automação não existe ou não é do time da chave	Confira o ID
`429`	Muitos pedidos no mesmo minuto	Espere e tente de novo, com calma

{
  "message": "Chave de API inválida",
  "error": "Unauthorized",
  "statusCode": 401,
  "timestamp": "2026-10-13T20:00:00.000Z",
  "path": "/partners/accounts"
}

Novidades da API

O que mudou para quem integra, da mais nova para a mais antiga. Também em JSON, para o seu sistema acompanhar.

Mudança 14/10/2026 v1.2.277 Não precisa mudar nada

Pedir para seguir a conta agora é opcional

Antes, toda automação criada pela API cobrava que a pessoa seguisse a conta depois do 1º toque. Agora isso só acontece se você mandar "exigirSeguir": true na criação.

Sem o campo, a 1ª mensagem continua saindo como resposta rápida (chega para todo mundo) e o toque leva direto à mensagem seguinte.

A consulta de uma automação (GET /partners/automations/{id}) agora traz "exigirSeguir" para você conferir.

Aviso 13/10/2026 v1.2.276 Não precisa mudar nada

A especificação OpenAPI agora fica em notifiquei.com.br

A especificação mudou de endereço: notifiquei.com.br/developers/openapi.json (e openapi.yaml). As novidades em JSON ficam em notifiquei.com.br/developers/novidades.json. Os endereços antigos em api.notifiquei.com.br deixaram de responder.

As chamadas da API não mudam: continuam indo para https://api.notifiquei.com.br, com a mesma chave. Só troque o endereço se alguma ferramenta sua (Postman, gerador de SDK, agente) lia a especificação.

Aviso 13/10/2026 v1.2.275 Não precisa mudar nada

A documentação mudou para notifiquei.com.br/developers

O guia agora fica em notifiquei.com.br/developers e a referência para testar em notifiquei.com.br/developers/referencia. Os endereços antigos (/partners/docs e /partners/referencia) levam para lá sozinhos.

A API e a chave continuam no mesmo lugar.

Mudança 13/10/2026 v1.2.273 Não precisa mudar nada

A 1ª mensagem do direct agora chega também para quem não segue

O Instagram só entrega botão na 1ª mensagem do direct para quem já segue a conta. Por isso, quem comentava sem seguir não recebia nada.

Agora, nas automações criadas pela API, a 1ª mensagem com botão "continuar" sai como resposta rápida, que chega para todo mundo. Depois do toque, entra o passo "É seguidor?": quem ainda não segue recebe um pedido para seguir e um botão "Já estou seguindo"; quem segue recebe a mensagem seguinte normalmente.

Se a 1ª mensagem tiver também botão de link, o link vai no próprio texto da mensagem (resposta rápida só leva texto). A receita que você manda continua a mesma.

Para ferramentas e agentes

A especificação completa (OpenAPI 3) serve para Postman, Insomnia, geradores de SDK e agentes de IA:

notifiquei.com.br/developers/openapi.json · openapi.yaml
Novidades em JSON: notifiquei.com.br/developers/novidades.json
As chamadas vão para https://api.notifiquei.com.br, com a chave no X-API-Key.
Dúvidas: contato@notifiquei.com.br

Ligue o seu sistema ao Notifiquei.