Saltar al contenido principal

Integración Instagram Business + Webhooks

Esta guía muestra cómo conectar una cuenta de Instagram Business al sistema para habilitar:

⚠️ Algunas pantallas de Meta pueden cambiar visualmente con el tiempo, pero el flujo de integración sigue siendo el mismo.

  • Inicio de sesión con Instagram
  • Recepción de mensajes (DM)
  • Webhooks en tiempo real
  • Automatización de atención al cliente

Requisitos previos

Antes de comenzar, necesitas tener:

  • Cuenta de Instagram Profesional (Business o Creator)
  • Cuenta de Facebook conectada a Instagram
  • Cuenta de Meta Developers

1. Creando la App en Meta

Accede a:

https://developers.facebook.com/apps/

Haz clic en:

  • Create App

Elige el tipo de app​

Selecciona:

  • "Business"

Luego haz clic en:

  • Next

Imagen ilustrativa


Configura la aplicación​

Completa:

  • Nombre de la aplicación
  • Correo electrónico de contacto
  • Cuenta Business

Luego haz clic en:

  • Create App

Imagen ilustrativa


2. Agregando la API de Instagram

Dentro del panel de la app:

  • Ve a Add Product

Busca:

  • Instagram API

Haz clic en:

  • Set Up

Imagen ilustrativa


3. Abriendo la configuración de la API

  • Instagram
  • API Setup

Verás:

  • App ID
  • App Secret

Imagen ilustrativa


4. Agregando permisos

Haz clic en:

  • Add all permissions

Los permisos necesarios se agregarán automáticamente:

  • instagram_business_basic
  • instagram_business_manage_messages

Imagen ilustrativa


5. Agregando la cuenta de Instagram

En la sección:

  • Generate Access Tokens

Haz clic en:

  • Add Account

Imagen ilustrativa


6. Iniciando sesión en Instagram

Se abrirá una ventana.

Ahora:

  • Inicia sesión en la cuenta de Instagram
  • Haz clic en Permitir
  • Autoriza el acceso

⚠️ La cuenta debe ser:

  • Business
  • o Creator

7. Copiando el Access Token

Después de iniciar sesión:

  • Se generará un token
  • Copia el token

Ejemplo:

IGAAxxxxxxxxxxxxxxxxxxxx

Imagen ilustrativa


8. Configurando el Webhook

En la sección:

  • Configure Webhooks

Completa:

CampoValor
Callback URLURL enviada por el sistema
Verify TokenToken enviado por el sistema

Ejemplo:

Callback URL:
https://api.tusistema.com/webhook

Verify Token:
mi_token

Luego haz clic en:

  • Probar y Guardar

Si todo salió bien, el sistema mostrará una alerta confirmando que todo está correcto Imagen ilustrativa

Después de guardar, el sistema generará la URL del Webhook Imagen ilustrativa


9. Suscribiendo a los eventos

Después de validar el webhook:

¡Copia la URL del sistema como en el ejemplo anterior y el token de verificación!

Guárdalos.

Suscríbete a los eventos disponibles:

Estos eventos permiten recibir mensajes en tiempo real.

Imagen ilustrativa


Configurando el Instagram Business Login

En la sección:

  • Configure Instagram Business Login

Agrega:

  • Redirect URI

Ejemplo:

https://app.tusistema.com/auth/instagram/callback

Luego haz clic en:

  • Save

Imagen ilustrativa

13. Finalizado ✅

Después de completar:

  • Instagram estará conectado
  • Los mensajes se recibirán automáticamente
  • El sistema comenzará a recibir eventos vía webhook

¿Para qué sirve esta URL?​

En este paso, Meta genera una URL de inicio de sesión de Instagram para Empresas.

Esta URL se usa para iniciar la conexión entre la cuenta de Instagram y el sistema.

Imagen ilustrativa

Qué hacer en este paso​

  1. Ubica la sección Configurar el inicio de sesión empresarial de Instagram.
  2. Copia la URL que aparece en el campo URL incorporada.
  3. Envía esta URL al equipo responsable del sistema o regístrala en el lugar indicado.
  4. Esta URL se usará en un botón, como Conectar Instagram.

Cuando el usuario haga clic en esta URL, será llevado a la pantalla de inicio de sesión de Instagram.

Después de iniciar sesión y autorizar el acceso, Instagram redirige automáticamente a la URL configurada en el sistema.


Posibles errores

Cuenta personal​

Error:

Instagram account type not supported

Solución:

Convierte la cuenta a:

  • Business
  • o Creator

En Instagram:

  • Configuración
  • Cuenta
  • Cambiar a cuenta profesional

Instagram no conectado a Facebook​

Instagram debe estar vinculado a una página de Facebook.

En Instagram:

  • Configuración
  • Centro de cuentas
  • Vincular Facebook

Documentación oficial

Instagram API:

https://developers.facebook.com/docs/instagram-platform/

Webhooks:

https://developers.facebook.com/docs/instagram-platform/webhooks/

Instagram Login:

https://developers.facebook.com/docs/instagram-platform/instagram-api-with-instagram-login/