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

# Introdução

> Envie e receba DMs no Instagram pelo painel ou API, com conexão oficial Meta ou não oficial, rastreamento e moderação de comentários.

<Tip>
  Instagram Direct é a **caixa de entrada do perfil**: atendimento, notificações e automação em DM, sem depender só de WhatsApp ou Telegram.
</Tip>

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

Pense no atendimento do perfil: o cliente já está no Instagram; você responde na DM sem sair do seu sistema.

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

<Warning>
  No modo **não oficial**, conectar conta Instagram envolve risco de restrição. É obrigatório `acceptInstagramTerms: true`. Use conta **dedicada** e leia a [Política anti-suspensão](/instagram-api/como-funciona/politica-anti-banimento).
</Warning>

## Comparativo: o que cada modo faz

| Funcionalidade                              |      Oficial     | Não oficial |
| ------------------------------------------- | :--------------: | :---------: |
| DM de texto                                 |         ✅        |      ✅      |
| DM com mídia (URL)                          |         ✅        |      ✅      |
| Receber DMs                                 | ✅ (webhook Meta) | ✅ (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                           |         ✅        |      ✅      |

Detalhes e “qual escolher?”: [Modos de conexão](/instagram-api/como-funciona/modos-de-conexao).

## Como conectar sua conta

Em três passos:

1. **Crie uma instância** (sua conexão Instagram) no painel ou pela API
2. **Escolha** oficial ou não oficial
3. **Complete a configuração** até o status ficar **ativo** e pronto para enviar

<AccordionGroup>
  <Accordion title="Como configurar a conexão oficial">
    1) No painel, crie uma conexão e escolha **Oficial**
    2) Faça login com a Meta (Embedded) ou use link compartilhável
    3) Conta **Instagram Professional** vinculada a uma **Facebook Page**
    4) Configure webhook Meta em `{sua_base}/webhooks/meta/instagram`

    Guia passo a passo: [Quick Start](/instagram-api/como-funciona/quick-start) (aba **Conexão oficial**)
  </Accordion>

  <Accordion title="Como configurar a conexão oficial BYOK">
    1. Crie instância com `mode: "OFFICIAL_BYOK"`
    2. Informe token da Page, Page ID, IG Business Account ID e App Secret
    3. Reconnect futuro **só** com token manual (não vira Embedded)

    Detalhes: [Modos de conexão](/instagram-api/como-funciona/modos-de-conexao)
  </Accordion>

  <Accordion title="Como configurar a conexão não oficial">
    1. No painel ou API, escolha **Não oficial**
    2. Informe usuário e senha (ou gere link compartilhável)
    3. Aceite os termos (`acceptInstagramTerms: true`)
    4. Em conta nova, respeite warm-up da [política anti-suspensão](/instagram-api/como-funciona/politica-anti-banimento)

    Guia passo a passo: [Quick Start](/instagram-api/como-funciona/quick-start) (aba **Conexão não oficial**)
  </Accordion>
</AccordionGroup>

## Depois de conectar

* Status **ativo** → envie com `instanceId` e destinatário (IGSID no oficial, username no não oficial)
* Configure [webhooks](/instagram-api/como-funciona/eventos-do-webhooks) do workspace (e callback Meta no oficial)
* Reconnect **trava** no método original (Embedded ≠ BYOK ≠ senha)

<Info>
  No oficial, editar e unsend **não** estão disponíveis (limitação da API Meta). Hide de comentário **só** no oficial.
</Info>

## Próximos passos

* [Modos de conexão](/instagram-api/como-funciona/modos-de-conexao)
* [Quick Start](/instagram-api/como-funciona/quick-start)
* [Política anti-suspensão](/instagram-api/como-funciona/politica-anti-banimento)
* [Escopos da API Key](/instagram-api/como-funciona/escopos-api-key)
* [Eventos de webhook](/instagram-api/como-funciona/eventos-do-webhooks)
* [Referência da API](/instagram-api/api-reference/api-reference)