Instagram Webhook

Instagram Webhook pone en marcha un flujo cada vez que tu cuenta de Instagram recibe un mensaje directo o un comentario en una publicación o en un directo. Entrega el texto, quién lo ha enviado y, si el mensaje trae una imagen, un audio, un vídeo o un documento, también el archivo.

Instagram avisa a NappAI en cuanto llega algo nuevo. Para eso tienes que pegar en tu aplicación de Meta la dirección del webhook de tu flujo, como se explica más abajo.

Cuándo usarlo

Quieres que un agente de IA lea los mensajes directos que recibe tu marca y avise al equipo de los urgentes.
Quieres registrar en una hoja de cálculo los comentarios de tus publicaciones.
Quieres avisar a tu equipo cuando alguien comenta en una publicación de una campaña.
Quieres guardar las fotos que te envían los clientes por mensaje directo.

Configuración

Necesitas una credencial Instagram con el identificador de tu cuenta de Instagram, un token de acceso de una aplicación de Meta y un token de verificación que tú eliges (Verification Token). Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Instagram de la cuenta que recibe los mensajes.
Data	Campo de prueba. Te permite probar el flujo con un evento de ejemplo sin esperar a uno real. Déjalo vacío en el uso normal.

Opciones avanzadas

Campo	Qué hace
Store Messages	Si el texto recibido se guarda en el historial de conversaciones del flujo. Por defecto, activado.

Conectar Instagram con el flujo

Guarda el flujo y publica una versión. Instagram envía los eventos a la versión publicada. Consulta Versiones y publicación.
En el editor pulsa Acceso a API y abre la pestaña Instagram Webhook. Copia la Webhook URL.
En la configuración de webhooks de tu aplicación de Meta, pega esa dirección y escribe como token de verificación el mismo Verification Token de tu credencial.
Suscríbete en Meta a los mensajes y a los comentarios.

Resultado

El componente tiene tres salidas:

Data: los datos del evento. En un mensaje directo, su identificador, quién lo envía, quién lo recibe, el texto, la fecha y, si trae un archivo, su dirección y su tipo (image, audio, video o document). En un comentario, su identificador, el nombre de usuario de quien comenta, el identificador de la publicación, el texto y la fecha.
Message: el texto recibido como mensaje de conversación, listo para conectarlo a un agente.
Media: el archivo que trae el mensaje, si lo hay, para guardarlo o analizarlo.

Cada persona que escribe tiene su propia conversación en el flujo, así que un agente conectado a Message recuerda lo que ha hablado con cada una.

Ejemplo

Una tienda de cosmética quiere que su equipo atienda primero los mensajes directos con quejas.

Añade Instagram Webhook y elige la credencial Instagram de la tienda.
Conecta la salida Message a un agente que decida si el mensaje es una queja y lo resuma.
Si es una queja, envía el resumen al canal del equipo de atención al cliente.
Publica el flujo, copia la Webhook URL en Acceso a API y pégala en tu aplicación de Meta.

Buenas prácticas

Si cambias el Verification Token de la credencial, cámbialo también en la aplicación de Meta.
Prueba el flujo con Data antes de conectarlo a Instagram, para no mezclar las pruebas con mensajes de clientes reales mientras lo montas.

Componentes relacionados

Publication: publicar en Instagram y consultar publicaciones y comentarios.