> ## 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 conexión

> Entiende la diferencia entre Instagram oficial (Meta) y no oficial: cuándo usar cada uno, riesgos y qué permite cada modo.

<Tip>
  Elegir el modo es como elegir **autopista o atajo**: la oficial sigue las reglas de Meta con más previsibilidad; la no oficial es más rápida para probar, pero con más riesgo de restricción.
</Tip>

## ¿Oficial o no oficial?

Cada conexión Instagram en Notifique usa **un** modo. No se puede alternar en la misma instancia: si necesitas cambiar, **crea una nueva**.

### Cuándo usar la oficial

* Producto en producción atendiendo clientes reales
* Necesitas **hide** de comentarios y eventos confiables por webhook
* Cuenta Instagram Professional ya vinculada a una Facebook Page

### Cuándo usar la no oficial

* Validar idea, montar prototipo o integrar por primera vez
* Necesitas **editar** / **unsend** DM (limitación de la API Meta en oficial)
* Aún no estás listo para la burocracia de la app Meta

<Warning>
  La conexión **no oficial** no sustituye a la oficial en producción. Úsala para aprender y probar; con clientes reales a escala, migra a la **oficial**.
</Warning>

En ambos modos necesitas **opt-in** del destinatario y respetar las políticas de Meta y los [Términos](https://app.notifique.dev/terms) de Notifique.

## Oficiales: Embedded vs BYOK

**OFFICIAL (Embedded):** Facebook Login o enlace compartible. Indicado para onboarding en el panel o cliente remoto. Reconexión **solo** con Meta.

**OFFICIAL\_BYOK:** pegas token de la Page, Page ID, IG Business Account ID y App Secret. Indicado para equipos que ya tienen credenciales Meta. Reconexión **solo** con token manual.

No puedes reconectar con el método "incorrecto": si nació Embedded, reconecta con Meta; si nació BYOK, solo token.

## Comparativo: qué hace cada modo

| Funcionalidad                                     |    Oficial    |  No oficial |
| ------------------------------------------------- | :-----------: | :---------: |
| DM de texto                                       |       ✅       |      ✅      |
| DM con media (URL)                                |       ✅       |      ✅      |
| Recibir DMs                                       |  ✅ (webhook)  | ✅ (polling) |
| Editar DM enviado                                 |       ❌       |      ✅      |
| Unsend (borrar para todos)                        |       ❌       |      ✅      |
| Responder comentarios                             |       ✅       |      ✅      |
| Ocultar (hide) comentario                         |       ✅       |      ❌      |
| Ventana de 24h tras el último mensaje del cliente |       ✅       |      ❌      |
| Destinatario por `@username`                      | ❌ (usa IGSID) |      ✅      |
| Enlace compartible para que el cliente conecte    |       ✅       |      ✅      |
| Login Meta en panel / página pública              |       ✅       |      ❌      |
| Usuario y contraseña                              |       ❌       |      ✅      |
| Warm-up / cooldown anti-suspensión                |       ❌       |      ✅      |
| Probar en sandbox                                 |       ✅       |      ✅      |

<Note>
  No se puede convertir una instancia de un modo a otro. Crea otra instancia en el modo correcto.
</Note>

<Info>
  ¿Integrando solo por API? Usa `mode: "OFFICIAL"` con `generateShareableLink: true` en `POST /v1/instagram/instances` para recibir `shareableLink.hostedUrl`. El cliente abre el enlace y concluye el login Meta (o introduce contraseña en modo no oficial). Detalles en el [Quick Start](/es/instagram-api/como-funciona/quick-start).
</Info>

## Resumen: ¿cuál elegir?

* **Producción con clientes reales** → **Oficial**
* **Hide de comentarios + webhook Meta** → **Oficial**
* **MVP, prueba o integración en desarrollo** → **No oficial**
* **Editar / unsend DM** → **No oficial**
* **Ya tienes token e IDs Meta** → **OFFICIAL\_BYOK**

## Próximos pasos

* [Introducción](/es/instagram-api/como-funciona/introducao)
* [Quick Start](/es/instagram-api/como-funciona/quick-start)
* [Política anti-suspensión](/es/instagram-api/como-funciona/politica-anti-banimento)
* [Eventos de webhook](/es/instagram-api/como-funciona/eventos-do-webhooks)