Instagram

Requisitos importantes:

• Debes tener una cuenta Instagram Business o Instagram Creator (no se admiten cuentas personales) *La cuenta de Instagram debe estar vinculada a una página de Facebook
• Su metaaplicación debe tener habilitado el producto de mensajería de Instagram

​

🔢 Tabla de contenidos

1. Convert to Instagram Business Account
2. Link Instagram to Facebook Page
3. Create a Meta App and Enable Instagram
4. Generate a Page Access Token
5. Get Your Instagram Account ID
6. Configure Webhooks
7. Connect to ZappWay
8. Final Checks and Monitoring

​

1. Convertir a una cuenta comercial de Instagram

​

1.1 Convertir cuenta personal en cuenta comercial

1. Open the Instagram mobile app.
2. Go to your profile and tap the menu (☰).
3. Tap Settings and privacy → Account type and tools → Switch to professional account.
4. Choose Business or Creator (Business is recommended for most use cases).
5. Select a category that best describes your account.
6. Add contact details (email, phone, address) as needed.
7. Complete the setup process.

Nota: También puedes realizar la conversión a través de Configuración → Cuenta → Cambiar a cuenta profesional en algunas versiones de Instagram.

​

2. Vincular Instagram a la página de Facebook

​

2.1 Conéctate a través de la aplicación Instagram

1. Go to your Instagram profile.
2. Tap the menu (☰) → Settings and privacy.
3. Tap Business (or Account Center).
4. Tap Page (or Connected accounts).
5. Tap Connect Facebook Page.
6. Select the Facebook Page you want to connect, or create a new one.
7. Confirm the connection.

​

2.2 Verificar conexión

1. In your Instagram profile, go to Settings → Account → Linked accounts.
2. You should see your Facebook Page listed.
3. Ensure the connection shows as “Active.”

Importante: La página de Facebook a la que te conectes se utilizará para generar el token de acceso en el Paso 4.

​

3. Cree una metaaplicación y habilite Instagram

​

3.1 Crear cuenta metaempresarial

1. Navigate to https://business.facebook.com.
2. Create or log in to your Business Manager account.
3. Complete business verification if required (submit documents like company registration).

​

3.2 Crear una metaaplicación

1. Go to https://developers.facebook.com/apps.
2. Click “Create App.”
3. Select “Other” when asked what your app should do.
4. Choose “Business” as your app type.
5. Fill in the app details:
   • App Name: “ZappWay Instagram Bot” (or similar)
   • Contact Email: Your business email
   • Business Account: Select your Business Manager
6. Click “Create App.”

​

3.3 Agregar producto de Instagram

1. In your App dashboard, go to “Products” in the left sidebar.
2. Find “Instagram” and click “Set Up.”
3. Wait for the Instagram product to be added (this may take a few moments).

Nota: Si el producto de Instagram no está disponible, asegúrese de:

• Tu Meta App está en tipo Business
• Has completado la verificación comercial
• La API de mensajería de Instagram está disponible en su región

​

4. Generar un token de acceso a la página

​

4.1 Generar token

1. In your Meta App, navigate to Instagram → Settings (or Instagram Basic Display → Settings).
2. Scroll to “Access Tokens” section.
3. You’ll see a list of Facebook Pages. Find the Page connected to your Instagram account.
4. Click “Generate Token” next to that Page.
5. Accept the permission requests.
6. Copy the generated Page Access Token and store it securely.

CRÍTICO: Vencimiento del token

• Los tokens de acceso a la página caducan después de 60 días de forma predeterminada.
• Para uso en producción, cree un Usuario del sistema en Business Manager:

1. Vaya a Business Manager → Configuración → Usuarios del sistema
2. Cree un nuevo usuario del sistema con rol de administrador
3. Asigne la aplicación al usuario del sistema con permiso “Administrar aplicación”
4. Genere un token desde la configuración del usuario del sistema con la opción “Nunca caducar”
5. Seleccione los permisos requeridos: pages_messaging, instagram_basic, instagram_manage_messages

​

4.2 Verificar permisos de tokens

• ✅ instagram_basic - Información básica de la cuenta de Instagram
• ✅ instagram_manage_messages - Enviar y recibir mensajes
• ✅ pages_messaging - Mensaje a través de la página de Facebook
• ✅ pages_show_list - Lista de acceso a páginas

​

5. Obtenga la identificación de su cuenta de Instagram

​

5.1 Buscar ID de cuenta de Instagram en Meta App

1. In your Meta App dashboard, go to Instagram → Settings.
2. Scroll to find your connected Instagram accounts.
3. You’ll see the Instagram Account ID displayed as a long numeric string (e.g., 17841401234567890).
4. Copy this ID - you’ll need it for ZappWay configuration.

​

5.2 Método alternativo a través de Graph API

curl -X GET "https://graph.facebook.com/v21.0/me/accounts?access_token=YOUR_PAGE_ACCESS_TOKEN"

curl -X GET "https://graph.facebook.com/v21.0/PAGE_ID?fields=instagram_business_account&access_token=YOUR_PAGE_ACCESS_TOKEN"

​

6. Configurar webhooks

​

6.1 Configurar la URL del webhook

1. In your Meta App, go to Instagram → Settings.
2. Locate the “Webhooks” section.
3. Click “Add Callback URL”.
4. You’ll configure this in Step 7 after creating the integration in ZappWay.

​

6.2 Campos de webhook para suscribirse

• ✅ mensajes - Recibir mensajes directos entrantes
• ✅ messaging_postbacks - Recibir clics en botones
• ✅ messaging_optins - Recibir eventos de suscripción
• ✅ message_deliveries - Seguimiento del estado de entrega
• ✅ message_reads - Seguimiento de recibos de lectura

​

7. Conéctese a ZappWay

​

Paso 1: Requisitos

1. Log in to your ZappWay dashboard.
2. Navigate to Integrations → Instagram.
3. Click “Add Instagram Integration.”
4. Review the requirements and click “Continue.”

​

Paso 2: Token de acceso a la página

1. Paste the Page Access Token you generated in Step 4.
2. Click “Continue.”
   • ZappWay will validate the token and retrieve your connected Facebook Page.
   • The system will verify that an Instagram Business account is linked to this Page.

​

Paso 3: ID de cuenta de Instagram

1. Paste the Instagram Account ID you obtained in Step 5.
2. Click “Continue.”
   • ZappWay will validate the account ID using your token.
   • The system will retrieve your Instagram username and profile information.
   • If validation succeeds, ZappWay will create the integration.

​

Paso 4: Configuración del webhook

1. Copie ambos valores.
2. Regrese a su Meta App → Instagram → Configuración → Webhooks.
3. Pegue la URL de devolución de llamada.
4. Pegue el Verificar token.
5. Haga clic en “Verificar y guardar”.
6. Suscríbase a los campos de webhook: mensajes, mensajes_postbacks, mensajes_optins, mensajes_deliveries, mensajes_lecturas.
7. Regrese a ZappWay y haga clic en “Finalizar”.

​

8. Controles finales y seguimiento

​

8.1 Verificar el estado de la conexión

• En la página Integraciones de ZappWay, verifique que la integración de Instagram muestre “Conectado”.
• Debe aparecer su nombre de usuario de Instagram.

​

8.2 Flujo de mensajes de prueba

1. Send a Direct Message to your Instagram Business account from another account.
2. Verify the message appears in ZappWay’s Inbox.
3. Check that your AI Employee responds according to configured rules.

Si los mensajes no llegan:

• Verificar que la URL de devolución de llamada del webhook coincida exactamente en la metaaplicación
• Verifique que las suscripciones a webhooks estén activas para “mensajes”
• Revisar los registros de entrega de webhooks en el panel de Meta App
• Asegúrese de que su token de acceso a la página sea válido y no haya caducado
• Confirma que la cuenta de Instagram esté correctamente vinculada a la página de Facebook.

​

8.3 Problemas comunes y soluciones

• Verifique que la cuenta de Instagram esté configurada como tipo Empresa o Creador
• Asegúrese de que Instagram esté vinculado a la página de Facebook correcta *Compruebe que el token de acceso a la página tenga el permiso instagram_basic

• Vuelva a verificar la URL de devolución de llamada y verifique que el token coincida exactamente
• Asegúrese de que los servidores ZappWay sean accesibles desde las IP de Meta
• Revise los registros del webhook de la meta aplicación para detectar mensajes de error específicos

• Verificar que el token tenga permiso instagram_manage_messages
• Verifique que la mensajería de Instagram esté habilitada en la configuración de la aplicación de Instagram
• Revisar los límites de tasa en el panel de Meta App

• Regenerar el token de acceso a la página con todos los permisos necesarios
• Verificar que el token se genere para la página de Facebook correcta
• Verifique que el usuario del sistema (si se usa) tenga los permisos de aplicación adecuados

​

8.4 Límites y restricciones de tarifas

• Límite de tarifa estándar: 200 llamadas API por hora
• Destinatarios de mensajes limitados por el nivel de verificación de tu aplicación
• Límites más altos disponibles después de la revisión y verificación de la aplicación

• Solo puedes responder a los usuarios dentro de las 24 horas posteriores a su último mensaje.
• Después de 24 horas, necesita el consentimiento del usuario para enviar un mensaje nuevo
• Utilice etiquetas de mensajes para casos de uso específicos fuera del período de 24 horas

• Siga las Normas de la comunidad de Instagram
• Evite spam, contenido promocional o mensajes engañosos
• No envíes mensajes no solicitados

​

✅ Mejores prácticas

​

Seguridad

• Almacenar tokens de acceso a la página de forma segura (variables de entorno, administrador de secretos)
• Utilice tokens de usuario del sistema para la producción (nunca caducan)
• Rotar tokens regularmente (al menos cada 60 días)
• Monitorear el uso del token y las fechas de vencimiento

​

Cumplimiento

• Siga la Política de la plataforma de Instagram y los Términos de la metaplataforma
• Obtener el consentimiento del usuario antes de enviar mensajes
• Proporcionar instrucciones claras para darse de baja
• Respetar la privacidad del usuario y las leyes de protección de datos.

​

Experiencia de usuario

• Responda rápidamente (menos de 3 segundos cuando sea posible)
• Utilice medios enriquecidos (imágenes, respuestas rápidas) para generar participación.
• Implementar indicadores de mecanografía para respuestas más largas.
• Proporcionar información útil y contextual.

​

Monitoreo

• Configurar alertas para fallas en la entrega de webhooks
• Seguimiento de la entrega de mensajes y tasas de lectura
• Monitorear las tasas de error de API
• Revisar las métricas de participación del usuario.

​

🔗 Enlaces útiles

• API de mensajería de Instagram: https://developers.facebook.com/docs/messenger-platform/instagram
• API de Instagram Graph: https://developers.facebook.com/docs/instagram-api
• Webhooks para Instagram: https://developers.facebook.com/docs/messenger-platform/instagram/features/webhook
• Política de plataforma: https://developers.facebook.com/docs/instagram-platform/instagram-graph-api/overview#instagram-platform-policy
• Pautas de la comunidad: https://help.instagram.com/477434105621119