O que é Instagram na Notifique?
É o jeito de mandar e receber mensagens diretas (DM) e moderar comentários na conta conectada. Você integra pelo painel ou API; a plataforma cuida da fila e do status de cada envio. Você pode:- Conectar conta de operação (oficial ou não oficial)
- Enviar texto e mídia por URL (imagem, vídeo, áudio, documento)
- Receber DMs e acompanhar por webhook (
instagram.received) - Responder e moderar comentários (no oficial, também ocultar)
- No não oficial: editar texto enviado ou unsend
Oficial ou não oficial?
Ao conectar uma conta, você escolhe um modo. Não dá para trocar depois na mesma instância: se mudar de ideia, crie uma nova.Conexão oficial (recomendada para produção)
É o caminho aprovado pela Meta (Messaging API). Ideal quando o produto já está no ar, você precisa de webhook confiável, hide de comentários e destinatário IGSID.- Login Meta no painel ou link compartilhável para o cliente
- Variante avançada BYOK se você já tem token e IDs da Page
- Janela de 24 horas após a última mensagem do cliente
Conexão não oficial
Funciona com usuário e senha (ou link para o cliente digitar). Rápida para MVP e testes, com mais liberdade para editar e unsend DM.Comparativo: o que cada modo faz
Detalhes e “qual escolher?”: Modos de conexão.
Como conectar sua conta
Em três passos:- Crie uma instância (sua conexão Instagram) no painel ou pela API
- Escolha oficial ou não oficial
- Complete a configuração até o status ficar ativo e pronto para enviar
Como configurar a conexão oficial
Como configurar a conexão oficial
- No painel, crie uma conexão e escolha Oficial
- Faça login com a Meta (Embedded) ou use link compartilhável
- Conta Instagram Professional vinculada a uma Facebook Page
- Configure webhook Meta em
{sua_base}/webhooks/meta/instagram
Como configurar a conexão oficial BYOK
Como configurar a conexão oficial BYOK
- Crie instância com
mode: "OFFICIAL_BYOK" - Informe token da Page, Page ID, IG Business Account ID e App Secret
- Reconnect futuro só com token manual (não vira Embedded)
Como configurar a conexão não oficial
Como configurar a conexão não oficial
- No painel ou API, escolha Não oficial
- Informe usuário e senha (ou gere link compartilhável)
- Aceite os termos (
acceptInstagramTerms: true) - Em conta nova, respeite warm-up da política anti-suspensão
Depois de conectar
- Status ativo → envie com
frome destinatário (IGSID no oficial, username no não oficial) - Configure webhooks do workspace (e callback Meta no oficial)
- Reconnect trava no método original (Embedded ≠ BYOK ≠ senha)
No oficial, editar e unsend não estão disponíveis (limitação da API Meta). Hide de comentário só no oficial.
Localização
O envio direto (POST /v1/instagram/messages) não aceita localization no body. Para multilíngue, use bloco instagram em templates (localeTranslations no CRUD) ou texto fixo por campanha.
Guia geral: Localização e i18n.

