Trigger Receive Instagram

Descripción

El modulo instagramReceive es un trigger que inicia el workflow cuando la cuenta de Instagram del negocio recibe un mensaje directo (DM), a través de la Messenger Platform de Meta. Extrae el remitente y el texto y los deja en una forma uniforme (igSenderId, content, message_id) para que los nodos siguientes —por ejemplo el Equipo de agentes (router)— identifiquen el canal como instagram y respondan al usuario correcto.

Requisitos

• Una cuenta de Instagram Business o Creator vinculada a una página de Facebook.
• Una App de Meta (developers.facebook.com) con el producto Instagram / Messenger.
• Un access token con el permiso instagram_manage_messages y el ID de la cuenta de Instagram (IG user id).

Cómo configurar (paso a paso)

1. Preparate la cuenta. Pasá tu Instagram a Business/Creator y vinculalo a una página de Facebook.

2. Creá la App de Meta. En developers.facebook.com creá una App, agregá el producto Instagram (o Messenger) y obtené un access token con instagram_manage_messages. Anotá también el IG user id.

3. Creá la credencial en Floogos. En Credenciales → Nueva, guardá { accessToken, igId }.

4. Cargá la credencial en el nodo. En Trigger Receive Instagram, seleccioná esa Credencial de Instagram.

5. Generá la URL del webhook. En el nodo, generá la URL Webhook (el endpoint público de Floogos).

6. Registrá el webhook en Meta. En tu App → Webhooks → Instagram, pegá la URL, definí el verify token y suscribí el campo messages. Suscribí también la página/cuenta a la App.

7. Verificá y activá. Enviá un DM a la cuenta: el workflow se dispara. Poné el workflow en Activo.

El nodo avisa si falta configuración

Si no cargás la credencial o no generás la URL del webhook, el nodo muestra una advertencia en el editor: sin ambos, el disparador no puede recibir DMs.

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "channel": "instagram",
    "type": "text",
    "igSenderId": "17841400000000000",
    "igRecipientId": "17841499999999999",
    "content": "Hola, quiero una factura",
    "message_id": "aWdfZG1f...",
    "metadata": { "message_id": "aWdfZG1f...", "is_echo": false }
  }
}

Responder al usuario

Para contestarle, agregá después un nodo Instagram: por defecto responde a data.igSenderId (el usuario que escribió). Para un asistente conversacional, poné en el medio el nodo Equipo de agentes (router) y enviá {{reply}}.

Notas

• La identidad de la sesión se aísla por igSenderId, así cada usuario tiene su propia memoria.
• Instagram solo permite responder dentro de la ventana de mensajería estándar de Meta.

Nodos Relacionados

• Instagram (enviar DM)
• Equipo de agentes (router) (equipo de agentes por canal)