> For the complete documentation index, see [llms.txt](https://docs.1millionbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1millionbot.com/es/chatbot/channels/instagram-messenger.md).

# Instagram Messenger

## Configuración

> Meta actualiza y rediseña con frecuencia su consola de desarrolladores, por lo que los pasos y nombres de menú de esta guía pueden quedar desactualizados. Si algo no coincide con lo que ves en pantalla, consulta la documentación oficial y siempre actualizada de Meta: [Instagram API with Instagram Login – Messaging](https://developers.facebook.com/documentation/instagram-platform/instagram-api-with-instagram-login/messaging-api).

Para configurar la integración de tu agente en Instagram Messenger, necesitarás lo siguiente:

* Una cuenta de Facebook registrada en la [consola para desarrolladores](https://developers.facebook.com/).
* Una página de Facebook conectada al Meta Business.
* Una cuenta de Instagram conectada al Meta Business.

### Crear una aplicación de Meta

> Meta asigna "casos de uso" al crear la aplicación: Instagram ya no se activa buscando el producto en el Panel, sino seleccionando un caso de uso dedicado durante la propia creación de la app.

1. Accede a la [consola para desarrolladores de Meta](https://developers.facebook.com/apps/).
2. Haz clic en 'Crear aplicación'.
3. Introduce el nombre de la aplicación y un correo de contacto.
4. En la selección de caso de uso, elige **'Manage messaging and content on Instagram'** (Gestionar mensajería y contenido en Instagram) y haz clic en 'Siguiente'.
5. Selecciona una cartera empresarial (Business Portfolio) existente vinculada a tu Meta Business, o crea una nueva.
6. Revisa los requisitos de publicación (pueden aparecer vacíos en este punto) y haz clic en 'Crear aplicación' para finalizar.

Al finalizar, ve a la sección **Panel** de la aplicación, selecciona ese caso de uso y haz clic en 'Personalizar' para configurarlo.

### Generar un Token de Acceso Permanente

1. Ve a **Instagram** > **Configuración del API con inicio de sesión de Instagram**.
2. En el primer paso, haz clic en 'Añadir cuenta'.\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2Fgit-blob-9bdab8e9ba4f533fa2eb8b2defeb0a88f40fe814%2FIG_17.png?alt=media)
3. Inicia sesión con la cuenta de Instagram que deseas conectar al agente.
4. Guarda y haz clic en 'Generar Token'.\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2Fgit-blob-34ec88d4e23716170c9c3a24708af979d4646399%2FIG_20.png?alt=media)
5. Copia el token generado para uso futuro.

### Obtener el ID de la página de Instagram

1. Ve a **Instagram** > **Configuración del API con inicio de sesión de Instagram**.
2. Copia el ID de la página que aparece debajo de la cuenta de Instagram.\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2Fgit-blob-34ec88d4e23716170c9c3a24708af979d4646399%2FIG_20.png?alt=media)

### Obtener la clave secreta de la aplicación

1. Ve a **Instagram** > **Configuración del API con inicio de sesión de Instagram**.
2. En el tercer paso, haz clic en 'Configurar' y añade la url de tu sitio web y guarda.
3. De nuevo, haz clic en 'Configuración de inicio de sesión de empresa' y copia la clave secreta de la aplicación de Instagram.\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2Fgit-blob-a84777ff3bbf1a2b5981d09017605d30dc66a38b%2FIG_22.png?alt=media)

### Conectar tu aplicación con tu agente

#### Activar la integración en la plataforma 1millionbot

1. Ve a la sección **Canales** en la plataforma.
2. Activa Instagram y haz clic en 'Configuración'.
3. Ingresa los datos obtenidos previamente: Clave secreta de la aplicación, Token de Acceso Permanente e ID de la página de Instagram.
4. Haz clic en 'Guardar'.\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2F8R9y1TN3m8ZL63XVtuRs%2FIG_7.png?alt=media\&token=3af8ae97-fc98-473b-9436-568c1c9e16e1)

#### Activar la integración en Meta

**Obtener Callback URL**

1. Ve a la plataforma 1millionbot y haz clic en el botón 'Info' en el canal Instagram para obtener la URL de callback.\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2F9rdOGLVpDKPsmTDqVXSM%2FIG_8.png?alt=media\&token=01624692-adc1-441f-a197-63326047c13b)

**Configurar el Webhook de Meta**

1. En la sección **Instagram** > **Configuración del API con inicio de sesión de Instagram**, haz clic en 'Editar' o 'Añadir' en la sección **Webhook** (segundo paso).\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2Fgit-blob-9bdab8e9ba4f533fa2eb8b2defeb0a88f40fe814%2FIG_17.png?alt=media)
2. Completa la URL de callback con la URL proporcionada por la plataforma 1millionbot y el token de acceso permanente generado anteriormente.\\
3. Haz clic en 'Guardar'.\\

### Configurar permisos

1. En la sección anterior, haz clic en 'Administrar'.
2. Configura los permisos de suscripción a mensajes.\
   ![](https://412644269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeKvXVjARdFac9a58oDAB%2Fuploads%2Fgit-blob-c5aa6aaa70fbaae5ab67916a7cb4aa1be61b6259%2FIG_19.png?alt=media)

### Publicar la aplicación Meta

1. Mientras tu aplicación esté en modo de desarrollo, solo podrás probar el funcionamiento del agente si eres el propietario o tienes acceso a la cuenta de Instagram conectada.
2. Como la aplicación solo envía y recibe mensajes en la cuenta de Instagram que tú mismo conectas —y no en cuentas de terceros—, Meta concede automáticamente **Standard Access** sobre el permiso `instagram_business_manage_messages`. Esto significa que **no es necesario enviar la aplicación a revisión (App Review) de Meta** para publicarla: la revisión completa (Advanced Access) solo es obligatoria cuando una misma app necesita gestionar cuentas de Instagram que no administras tú —por ejemplo, una plataforma que da servicio a las cuentas de muchos clientes distintos desde una única app—, que no es el caso de esta integración.
3. Para publicar el agente para interacción pública, completa la información restante que Meta solicite en el Panel de la aplicación y cambia el estado del caso de uso de "En desarrollo" a "Activo".
4. ¡Listo! Ahora puedes interactuar con tu agente en la cuenta de Instagram conectada. 🎉

## Limitaciones

* Se pueden enviar un máximo de (200 \* Número de Usuarios Comprometidos / Engaged Users) mensajes al día por bot.
* Solo puedes responder dentro de las 24 horas siguientes al último mensaje del usuario.
* Los botones tienen que tener un máximo de 20 caracteres.
* Máximo de 3 botones por mensaje.
