Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Messenger Send API: mensajes desde una Página de Facebook

Una Página de Facebook envía mensajes de Messenger con POST /{page-id}/messages y un token de acceso de la Página: el objeto recipient contiene el ID con alcance de Página de la persona (PSID), messaging_type es RESPONSE o UPDATE dentro de la ventana de mensajería estándar, o MESSAGE_TAG después de ella, y message contiene texto o un adjunto como una imagen, audio, video o archivo. Meta responde con el recipient_id y un message_id.

easyCoexistence responde a los DM de Messenger con send_social_dm desde Claude, ChatGPT o tu propio código dentro de la ventana de 24 horas, como texto; los medios, las respuestas rápidas y las plantillas no están cubiertos.

300 per second

Llamadas de Send API que una app puede hacer por Página para mensajes con texto, enlaces, reacciones y stickers.

10 per second

Llamadas de Send API que una app puede hacer por Página para mensajes que contienen audio o video.

25 MB

Archivo más grande que Messenger Platform guarda para reutilizar; una imagen subida desde una URL tiene un límite de 8 MB.

30 images

Número máximo de imágenes que un mensaje puede llevar en su array attachments, el único tipo de multimedia permitido allí.

90 days

Tiempo que dura un attachment_id guardado antes de que el medio deba subirse de nuevo.

¿Qué contiene una petición de Send API?

Meta enumera seis componentes que un envío debe incluir: el ID de la Página que envía, el ID de la persona que recibe, un token de acceso de esa Página, el permiso de la persona, el tipo de mensaje y el contenido. La petición es un POST de JSON a /{page-id}/messages, y una respuesta a alguien que acaba de escribir se ve así:

A text reply, and Meta's answer
POST /{page-id}/messages
{
  "recipient": { "id": "<PSID>" },
  "messaging_type": "RESPONSE",
  "message": { "text": "Your order ships tomorrow." }
}

{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }

¿Qué ID va en recipient?

Normalmente el ID con alcance de Página, o PSID, que Meta asigna a una persona la primera vez que escribe a la Página; llega como sender.id en el webhook de mensajes. El objeto recipient acepta otros tipos de ID en casos particulares:

  • id: el PSID, único para esa persona y esa Página.
  • user_ref: para alguien que usó un plugin o un botón postback para escribir a la Página.
  • comment_id o post_id: para una respuesta privada a un comentario o a una publicación de un visitante.
  • Los IDs de Facebook Login tienen alcance de app y no funcionan en Messenger Platform.

¿Qué messaging_type debe usar un mensaje?

El tipo indica a Meta por qué se envía el mensaje y decide cuándo se permite el envío. La referencia de mensajes de Página de Meta enumera cuatro valores:

  • RESPONSE: una respuesta a un mensaje que la Página recibió, promocional o no, dentro de la ventana de mensajería estándar.
  • UPDATE: un mensaje que la Página envía por iniciativa propia, promocional o no, también dentro de la ventana.
  • MESSAGE_TAG: un mensaje no promocional enviado después de la ventana, con una etiqueta que corresponde a un caso de uso aprobado.
  • UTILITY: un mensaje de utilidad creado a partir de una plantilla aprobada, como una actualización de pedido o de cita.

¿Qué puede llevar un mensaje?

Texto, o un objeto attachment con un type y un payload: los adjuntos de imagen, audio, video y archivo apuntan a una URL o a un attachment_id guardado, y los adjuntos de plantilla llevan mensajes estructurados con botones. El mismo endpoint también acepta estos:

  • attachments: un array de hasta 30 imágenes enviadas como un solo mensaje.
  • reply_to con un mid: una respuesta a un mensaje anterior específico, de la persona o de la Página.
  • quick_replies: hasta 13 botones sobre el campo de escritura, cada título de hasta 20 caracteres.
  • sender_action: un indicador de escritura, una marca de visto o una reacción, enviado en una petición aparte del propio mensaje.
  • notification_type: REGULAR por defecto, o SILENT_PUSH o NO_PUSH.

¿Qué tamaño pueden tener los adjuntos?

La guía de Meta para guardar recursos fija los límites de los medios que Messenger Platform obtiene y guarda: recursos de hasta 25 MB, imágenes de hasta 8 MB cuando se suben desde una URL, audio enviado con un Content-Type de audio y video obtenido en 75 segundos. Al establecer is_reusable en true se devuelve un attachment_id que solo la Página que lo envió puede reutilizar, durante 90 días, y POST /{page-id}/message_attachments sube los medios con antelación.

¿Cuáles son los límites de tasa de Send API?

Meta los cuenta por Página y por tipo de contenido. Su referencia de mensajes de Página incluye el 613, Calls to this api have exceeded the rate limit, entre los errores de envío, así que hay que bajar el ritmo en lugar de reintentar de inmediato cuando aparece:

  • 300 llamadas por segundo por Página para mensajes con texto, enlaces, reacciones y stickers.
  • 10 llamadas por segundo por Página para mensajes con audio o video.
  • Demasiados mensajes a un solo hilo pueden limitarse por tasa por sí mismos.
  • Llamadas a la API de Messenger en total: 200 veces el número de usuarios con interacción, en un periodo móvil de 24 horas.
  • Por encima de 40 mensajes por segundo, la bandeja de entrada de la Página deja de mostrar mensajes nuevos y la Página no puede enviar hasta que el volumen baje.

¿Qué errores devuelve Send API?

La tabla de errores de Messenger de Meta asocia cada código con un subcódigo que nombra la causa. Estos son los que una Página encuentra con más frecuencia al enviar:

  • 10 con 2018278 o 2534022: el mensaje se envía fuera de la ventana permitida.
  • 10 con 2018300: otra app controla la conversación.
  • 100: parámetro no válido, como un ID de destinatario incorrecto; el subcódigo 2018001 dice No matching user found.
  • 551: la persona no está disponible, quizá porque bloqueó la Página o desactivó su cuenta; 200 con 1545041 dice This person isn't available right now.
  • 200 con 2018028: la app no puede escribir a personas fuera de sus roles hasta que pages_messaging sea revisado y la app esté activa.
  • 10904: la Página tiene los mensajes desactivados en la configuración.

¿Cómo envía easyCoexistence a través de ella?

send_social_dm toma el account_id, el recipient_id de la persona, que es sender.id en un evento de mensajes reenviado, y el texto, y los envía a /{page-id}/messages con messaging_type RESPONSE. El resultado es la respuesta de Meta con el message_id, y un envío rechazado devuelve el código de error y el mensaje de Meta. Los medios, las respuestas rápidas, las plantillas y las acciones del remitente no están entre las herramientas: send_social_dm envía texto.

Errores comunes

  • Enviar un indicador de escritura junto con el mensaje. Meta quiere sender_action solo con el destinatario, y el texto o las plantillas en una petición aparte.
  • Lanzar una ráfaga a una misma persona. Meta puede limitar la tasa de un solo hilo por sí mismo, aparte de las 300 llamadas por segundo de la Página.
  • Enviar audio o video al ritmo del texto. Los mensajes con audio o video están limitados a 10 llamadas por segundo por Página.
  • Reutilizar un attachment_id de más de 90 días. Los IDs de adjuntos guardados caducan, así que hay que subir el medio de nuevo para obtener uno nuevo.
Hacerlo con EasyCoexistence

Las automatizaciones responden solas a los mensajes nuevos con un texto fijo o una respuesta de IA. De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿La Messenger Send API es gratuita?

Sí, para los mensajes estándar. La visión general de Meta describe Messenger Platform como gratuita, así que una Página que responde a personas que le escribieron no paga nada por mensaje; los mensajes de marketing se cobran por mensaje.

¿Qué tarea de Página necesita un envío de mensajes?

La visión general de Messenger de Meta pide un token de Página de alguien que pueda realizar las tareas MESSAGING y MODERATE, con el permiso pages_messaging concedido.

¿easyCoexistence puede responder con imágenes en Messenger?

Hoy no. send_social_dm envía texto, y ninguna herramienta envía un adjunto.

¿Cuánto cuesta easyCoexistence para una Página de Facebook?

Cada Página que conectas es una conexión, facturada de US$ 9 a US$ 0.75 por conexión al mes según cuántas tengas, y los primeros 3 días son gratis.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el