> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Modos de conexão

> Entenda a diferença entre Instagram oficial (Meta) e não oficial: quando usar cada um, riscos e o que cada modo permite.

<Tip>
  Escolher o modo é como escolher **estrada ou atalho**: a oficial segue as regras da Meta com mais previsibilidade; a não oficial é mais rápida para testar, mas com mais risco de restrição.
</Tip>

## 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

<Warning>
  A conexão **não oficial** não substitui a oficial em produção. Use para aprender e testar; para clientes reais em escala, migre para a **oficial**.
</Warning>

Em ambos os modos, você precisa de **opt-in** do destinatário e respeito às políticas da Meta e aos [Termos](https://app.notifique.dev/terms) da Notifique.

## 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

| Funcionalidade                              |    Oficial    | Não oficial |
| ------------------------------------------- | :-----------: | :---------: |
| DM de texto                                 |       ✅       |      ✅      |
| DM com mídia (URL)                          |       ✅       |      ✅      |
| Receber DMs                                 |  ✅ (webhook)  | ✅ (polling) |
| Editar DM enviado                           |       ❌       |      ✅      |
| Unsend (apagar para todos)                  |       ❌       |      ✅      |
| Responder comentários                       |       ✅       |      ✅      |
| Ocultar (hide) comentário                   |       ✅       |      ❌      |
| Janela de 24h após última msg do cliente    |       ✅       |      ❌      |
| Destinatário por `@username`                | ❌ (use IGSID) |      ✅      |
| Link compartilhável para o cliente conectar |       ✅       |      ✅      |
| Login Meta no painel / página pública       |       ✅       |      ❌      |
| Usuário e senha                             |       ❌       |      ✅      |
| Warm-up / cooldown anti-suspensão           |       ❌       |      ✅      |
| Testar no sandbox                           |       ✅       |      ✅      |

<Note>
  Não dá para converter uma instância de um modo para o outro. Crie outra instância no modo certo.
</Note>

<Info>
  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](/instagram-api/como-funciona/quick-start).
</Info>

## 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**

## Próximos passos

* [Introdução](/instagram-api/como-funciona/introducao)
* [Quick Start](/instagram-api/como-funciona/quick-start)
* [Política anti-suspensão](/instagram-api/como-funciona/politica-anti-banimento)
* [Eventos de webhook](/instagram-api/como-funciona/eventos-do-webhooks)