Skip to main content
Instagram Direct é a caixa de entrada do perfil: atendimento, notificações e automação em DM, sem depender só de WhatsApp ou Telegram.

​
O que é Instagram na Notifique?

É o canal para mandar e receber mensagens diretas (DM) e moderar comentários na conta conectada. Você integra pelo painel ou API; a plataforma cuida da fila, da sessão e do status de cada envio. Hoje o foco é a conexão não oficial (login com usuário e senha da conta Instagram). A integração oficial Meta está em desenvolvimento e será documentada em breve. Você pode:
  • Conectar uma conta de operação com login ou link compartilhável
  • Enviar texto e mídia por URL (imagem, vídeo, áudio, documento)
  • Receber DMs e acompanhar por webhook (instagram.received)
  • Editar texto enviado (janela de 15 min) ou apagar (unsend)
  • Responder e moderar comentários em posts da conta
Conectar conta Instagram envolve risco de restrição pela plataforma. É obrigatório acceptInstagramTerms: true. Use conta dedicada e leia a Política anti-suspensão, não reconecte em loop após queda.

​
Quando usar?

Funciona muito bem para atendimento em DM, notificações e canal paralelo ao WhatsApp. Não serve para publicar feed ou stories, aqui é Direct e comentários.

​
Como funciona na prática

  1. Crie uma conexão no painel ou API (login ou generateShareableLink: true para outra pessoa conectar)
  2. Se o Instagram pedir 2FA ou desafio de segurança, complete o fluxo (HTTP 428)
  3. Com status ACTIVE, envie com instanceId, destinatário (@usuario ou ID) e tipo de conteúdo
  4. A plataforma enfileira, envia e atualiza o status; seu backend recebe avisos se configurou webhooks
Cada API Key pertence a um workspace. Na v1 não envie x-workspace-id.
Conexão oficial Meta (em breve): quando disponível, seguirá o padrão dos outros canais oficiais (credenciais Meta, sem login por senha). A documentação será atualizada nesta mesma aba.

​
Ciclo da conexão

Depois de criar, a instância passa por PENDING (aguardando login) ou ACTIVE (sessão válida). Se a sessão cair, fica DISCONNECTED até reconectar. Instância removida → CANCELLED. Webhooks úteis: instagram.instance.connected, instagram.instance.disconnected, instagram.instance.challenge_required.

​
Ciclo da mensagem

Após o POST, a mensagem fica em QUEUED ou SCHEDULED, depois PROCESSING → SENT. Engajamento pode vir como DELIVERED, READ ou RESPONDED. Edição vira EDITED; falha vira FAILED; cancelamento na fila vira CANCELLED; unsend vira DELETED. Editar texto enviado: só mensagens de texto, até 1000 caracteres, 15 minutos após o envio, máximo 5 edições. Webhook: instagram.edited.

​
Depois de conectar

  • Envie com POST /v1/instagram/messages
  • Liste inbound com GET /v1/instagram/messages/inbound
  • Modere comentários com os escopos instagram:comments:reply e instagram:comments:moderate
  • Configure webhooks (instagram.sent, instagram.received, …), eventos começam com instagram., não message.* (WhatsApp)
Conta nova? Veja Política anti-suspensão antes de campanhas.

​
Próximos passos