Meta Messenger

Descripcion

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 (envio de texto, imagenes, video, audio, archivos, quick replies, plantillas de botones, carruseles, recibos, indicadores de escritura) como para Instagram (envio de texto, imagenes, corazones, reacciones a mensajes).

Tambien permite consultar conversaciones, mensajes, perfiles de usuario e informacion de paginas. La operacion se determina por el campo operation o por el nombre del nodo.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credenciales de Meta (Facebook/Instagram)
operation	select	Si	Operacion: 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 pagina 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 rapidas (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 configuracion:

accessToken: Token de acceso de la pagina de Facebook (obligatorio)
pageId: ID de la pagina 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 basico - Enviar texto por Facebook

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

Caso basico - 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
Documentacion: https://developers.facebook.com/docs/messenger-platform
Documentacion Instagram: https://developers.facebook.com/docs/instagram-api/guides/messaging

Notas

Se requiere un Page Access Token con permisos de pages_messaging
Las respuestas rapidas (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 pagina
El parametro continueOnError permite que el workflow continue incluso si la operacion falla
Los errores de la API de Meta incluyen codigo 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