Meta Messenger

Descripción

Este modulo permite enviar y recibir mensajes a traves de Facebook Messenger e Instagram Direct utilizando la Meta Graph API v18.0. Soporta operaciones tanto para Facebook (envío de texto, imagenes, video, audio, archivos, quick replies, plantillas de botones, carruseles, recibos, indicadores de escritura) como para Instagram (envío de texto, imagenes, corazones, reacciones a mensajes).

También permite consultar conversaciones, mensajes, perfiles de usuario e información de páginas. La operación se determina por el campo operation o por el nombre del nodo.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales de Meta (Facebook/Instagram)
operation	select	Si	Operación: fbSendText, fbSendImage, fbSendVideo, fbSendFile, fbSendAudio, fbQuickReplies, fbButtonTemplate, fbGenericTemplate, fbReceiptTemplate, fbTyping, fbMarkSeen, fbGetConversations, fbGetMessages, fbGetUser, fbGetPage, getPages, igSendText, igSendImage, igSendHeart, igReact, igGetConversations, igGetUser
pageId	text	Condicional	ID de la página de Facebook (puede venir de credenciales)
igAccountId	text	Condicional	ID de la cuenta de Instagram (puede venir de credenciales)
recipientId	text	Si	ID del destinatario del mensaje
text / textKey	text	Condicional	Texto del mensaje o clave en data donde se encuentra
messagingType	select	No	Tipo de mensaje: RESPONSE (default), UPDATE, MESSAGE_TAG
quickReplies	json	Condicional	Array de respuestas rápidas (para fbQuickReplies)
buttons	json	Condicional	Array de botones (para fbButtonTemplate)
elements	json	Condicional	Array de elementos del carrusel (para fbGenericTemplate)

Credenciales

Tipo de servicio: meta_messenger. Se almacenan en la tabla servicecredentials.

Campos de configuración:

accessToken: Token de acceso de la página de Facebook (obligatorio)
pageId: ID de la página de Facebook
igAccountId: ID de la cuenta de Instagram Business

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "messageResult": {
      "recipient_id": "123456789",
      "message_id": "mid.xxxxx"
    }
  },
  "_meta_": {
    "operation": "fbSendText",
    "service": "meta_messenger",
    "platform": "facebook"
  }
}

Ejemplo de Uso

Caso básico - Enviar texto por Facebook

{
  "credentials_id": 1,
  "operation": "fbSendText",
  "recipientId": "123456789",
  "text": "Hola, gracias por contactarnos"
}

Caso básico - Enviar texto por Instagram

{
  "credentials_id": 1,
  "operation": "igSendText",
  "recipientId": "987654321",
  "text": "Gracias por tu mensaje en Instagram"
}

API Utilizada

Meta Graph API v18.0: https://graph.facebook.com/v18.0
Documentación: https://developers.facebook.com/docs/messenger-platform
Documentación Instagram: https://developers.facebook.com/docs/instagram-api/guides/messaging

Notas

Se requiere un Page Access Token con permisos de pages_messaging
Las respuestas rápidas (quick replies) estan limitadas a 13 opciones por mensaje
Los templates de botones estan limitados a 3 botones por mensaje
Los carruseles (generic template) soportan hasta 10 elementos
El recipientId generalmente viene del campo senderId en los datos del webhook entrante
Las operaciones de Instagram requieren el igAccountId de la cuenta Instagram Business vinculada a la página
El parámetro continueOnError permite que el workflow continue incluso si la operación falla
Los errores de la API de Meta incluyen código y subcodigo para diagnostico detallado

Nodos Relacionados

FB Send Text, FB Send Image, FB Send Video, FB Send File, FB Send Audio
FB Quick Replies, FB Button Template, FB Generic Template (Carousel), FB Receipt
FB Typing, FB Mark Seen, FB Get Conversations, FB Get Messages, FB Get User, FB Get Page
IG Send Text, IG Send Image, IG Send Heart, IG React, IG Get Conversations, IG Get User