Oficial ou não oficial?
Cada conexão Instagram no Notifique usa um modo. Não dá para alternar na mesma instância: se precisar mudar, crie uma nova.Quando usar a oficial
- Produto no ar atendendo clientes de verdade
- Precisa de hide de comentários e eventos confiáveis via webhook
- Conta Instagram Professional já vinculada a uma Facebook Page
Quando usar a não oficial
- Validar ideia, montar protótipo ou integrar pela primeira vez
- Precisar de editar / unsend DM (limitação da API Meta no oficial)
- Ainda não está pronto para a burocracia do app Meta
Oficiais: Embedded vs BYOK
OFFICIAL (Embedded): Facebook Login ou link compartilhável. Indicado para onboarding no painel ou cliente remoto. Reconnect só com Meta. OFFICIAL_BYOK: você cola token da Page, Page ID, IG Business Account ID e App Secret. Indicado para times que já têm credenciais Meta. Reconnect só com token manual. Não dá para reconectar com o método “errado”: se nasceu Embedded, reconecta com Meta; se nasceu BYOK, só token.Comparativo: o que cada modo faz
Não dá para converter uma instância de um modo para o outro. Crie outra instância no modo certo.
Integrando só pela API? Use
mode: "OFFICIAL" com generateShareableLink: true em POST /v1/instagram/instances para receber shareableLink.hostedUrl. O cliente abre o link e conclui o login Meta (ou digita senha no modo não oficial). Detalhes no Quick Start.Resumo: qual escolher?
- Produção com clientes reais → Oficial
- Hide de comentários + webhook Meta → Oficial
- MVP, teste ou integração em desenvolvimento → Não oficial
- Editar / unsend DM → Não oficial
- Já tem token e IDs Meta → OFFICIAL_BYOK