
Guías de integración
Guía de la API de LinkedIn
Guía de la API de email
Guía de la API de WhatsApp
Contactar con ventas
¿Busca una API de Facebook Messenger para una cuenta personal? La Messenger Platform de Meta solo da servicio a Páginas de Facebook. Le explicamos por qué y cómo sus usuarios pueden conectar su propia cuenta a su app.
api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
La API oficial de Facebook Messenger no admite cuentas personales. La Messenger Platform de Meta permite que una Página de Facebook o una cuenta profesional de Instagram responda a las personas, nunca un perfil personal. Para trabajar con una cuenta personal de Facebook, su titular la conecta a su app a través de una API de terceros como Unipile.
Los proyectos open source que controlan messenger.com desde un navegador no son oficiales, en su mayoría no se mantienen y fallan cada vez que cambia la interfaz. Una cuenta conectada pasa por una API mantenida, con webhooks.
Para una visión de conjunto de las API de Meta, consulte cómo encajan las API de Facebook.
Mensajes desde una cuenta personal de Facebook en tres pasos
Conectar. Su usuario vincula su propia cuenta de Facebook mediante Hosted Auth. Sin app de Meta ni App Review.
Enviar. Llame a la API V2 con su encabezado X-API-KEY:POST/v2/
Recibir. Los mensajes entrantes llegan a su webhook como eventos message.new.
Detalles en el flujo de conexión y los ejemplos de código más abajo, o en el quickstart de Facebook.
Empiece su prueba gratuita de 7 díasLa oficial, no. Meta creó la Messenger Platform para empresas: permite que una Página de Facebook o una cuenta profesional de Instagram responda a las personas que le escriben. Una cuenta personal de Facebook solo llega a su app cuando su titular la conecta, a través de una API de terceros que actúa en su nombre.
Fuente: la presentación de la Messenger Platform de Meta. Última verificación: noviembre de 2026.
La Messenger Platform está diseñada en torno a una Página, no a una persona. Cada llamada actúa en nombre de una Página de Facebook, con un Page access token y el permiso pages_messaging, así que no existe ningún token que represente una bandeja de entrada personal.
Registra una app en Meta for Developers con el caso de uso Messenger.
Un administrador de la Página concede permisos como pages_messaging.
Su app llama a la Send API solo en nombre de esa Página.
La Página recibe los mensajes y responde dentro de la ventana de mensajería estándar.
Los permisos se solicitan a través de Facebook Login for Business, y business_management es una dependencia de pages_messaging. El App Review no es necesario si solo envía y recibe mensajes para su propia Página; dar servicio a Páginas de otras empresas sí lo requiere. La mayoría de las respuestas deben enviarse en las 24 horas siguientes al último mensaje de la persona; la etiqueta de mensaje HUMAN_AGENT amplía las respuestas manuales a 7 días, tras el App Review. Ninguno de estos pasos de la Graph API puede dirigirse a un perfil personal, por eso las herramientas basadas en la API oficial solo conectan Páginas. Lo que cuesta esta configuración se detalla en nuestra guía de precios de la API de Facebook Messenger.
Fuentes: la presentación de la Messenger Platform y la referencia de la Send API de Meta. Última verificación: noviembre de 2026.
Meta cerró la antigua Facebook Chat API (XMPP, chat.facebook.com) en 2015, con el fin de la Graph API v1.0 y del permiso xmpp_login. No existe ninguna API oficial para la bandeja de entrada de un perfil personal de Facebook: la Messenger Platform que la sustituyó para la mensajería empresarial solo actúa en nombre de Páginas. Las bibliotecas no oficiales publicadas en npm desde entonces inician sesión en messenger.com con la propia sesión del usuario. Meta no las respalda, y el proyecto de código abierto original indica que está en modo de mantenimiento.
Para enviar mensajes desde una Página que gestiona, use la Messenger Platform y envíe un mensaje de Messenger por API. Para la propia cuenta del usuario, use una API mantenida: el usuario se conecta mediante Hosted Auth, de modo que su aplicación nunca maneja su contraseña, y usted obtiene un account_id, webhooks y un equipo de soporte (vea cómo se conecta una cuenta personal). Las Condiciones de Meta siguen aplicándose a esa cuenta.
La conecta su propio titular. Su app abre una página de Hosted Auth de Unipile (o su propia pantalla con Custom Auth), el usuario inicia sesión en Facebook y valida la autenticación de dos factores, y su app recibe un account_id con el que llamar a la API.
El usuario hace clic en «Conectar Facebook» y llega a Hosted Auth.
Nombre de usuario, email o teléfono con contraseña, cookies del navegador o la extensión UniLogin, y después 2FA por SMS, app de autenticación, WhatsApp, aprobación en la app o código de un solo uso.
La cuenta conectada aparece en su dashboard y cada llamada usa su account_id.
En este flujo no hay pantalla OAuth de Meta ni código QR, y usted no crea ninguna app de Meta ni pasa por el App Review. Los métodos por proveedor figuran en la tabla de funciones por proveedor, y la presentación del producto está en la página de la API de Facebook Messenger.
Cada usuario conecta su propia cuenta
Unipile no es un producto de Meta. No es un Meta Partner y no cuenta con el respaldo de Meta. Cada usuario conecta su propia cuenta, Unipile actúa en nombre de ese usuario autenticado y el usuario sigue sujeto a las condiciones de Meta.
En la práctica, una integración de la API de Facebook Messenger con una cuenta personal expone la bandeja de Messenger del propio usuario a través de la API de Unipile: chats, mensajes, archivos adjuntos, reacciones y confirmaciones, además de webhooks en tiempo real, comparado a continuación con el modelo oficial de Páginas.
| Tema | Página con la Messenger Platform | Cuenta personal con Unipile |
|---|---|---|
| Cuenta | Una Página de Facebook o una cuenta profesional de Instagram | La propia cuenta personal de Facebook del usuario |
| Quién conecta | Un administrador de la Página, a través de Facebook Login for Business | El titular de la cuenta, a través de Hosted Auth o Custom Auth |
| Lo que guarda su app | Un Page access token | Su clave de API de Unipile y el account_id del usuario |
| App de Meta y App Review | Una app de Meta, más el App Review para dar servicio a Páginas que no son suyas | Sin app de Meta ni App Review por su parte |
| Quién escribe primero | La persona escribe a la Página | El usuario puede responder o iniciar una conversación nueva |
| Eventos en tiempo real | Webhooks de Messenger en su app de Meta | Mensajes nuevos, editados y eliminados, confirmaciones de lectura y entrega, reacciones, cambios en los chats |
account_id del usuarioLa misma cuenta conectada también expone sus publicaciones, comentarios y reacciones. Esos endpoints se resumen en la guía de la API de Facebook.
Dos llamadas cubren el ciclo básico: listar los chats de la cuenta conectada y después enviar un mensaje en uno de ellos. Las solicitudes van a https://api.unipile.com con su clave de API en el encabezado X-API-KEY.
# 1. List the chats of the connected personal account
curl --request GET \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
--header "X-API-KEY: {YOUR_API_KEY}"
# 2. Send a message in one of those chats
curl --request POST \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Thursday 10am works for me." }'
const base = "https://api.unipile.com/v2/{ACCOUNT_ID}";
const headers = { "X-API-KEY": process.env.UNIPILE_API_KEY };
// 1. List the chats of the connected personal account
const chats = await (await fetch(`${base}/chats`, { headers })).json();
// 2. Send a message in one of those chats
await fetch(`${base}/chats/{CHAT_ID}/messages/send`, {
method: "POST",
headers: { ...headers, "content-type": "application/json" },
body: JSON.stringify({ text: "Thursday 10am works for me." }),
});
import os, requests
base = "https://api.unipile.com/v2/{ACCOUNT_ID}"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. List the chats of the connected personal account
chats = requests.get(f"{base}/chats", headers=headers).json()
# 2. Send a message in one of those chats
requests.post(
f"{base}/chats/{{CHAT_ID}}/messages/send",
headers=headers,
json={"text": "Thursday 10am works for me."},
)
Los mensajes entrantes llegan a su webhook como eventos message.new, así que no necesita hacer polling. El SDK de Node.js encapsula las mismas llamadas como getChatsList y sendMessage. Configuración completa en el quickstart de Facebook. Más lenguajes, archivos adjuntos y respuestas de Páginas en enviar un mensaje con la API de Facebook Messenger.
Una cuenta personal conectada encaja en productos donde un profesional conversa con sus propios contactos desde su propia cuenta: CRM, helpdesks, asistentes de IA que redactan respuestas que el usuario aprueba y herramientas para asesores. No está pensada para la prospección en frío ni para bots totalmente automatizados.
Un comercial encuentra sus conversaciones de Messenger en la ficha del contacto correcto, junto a los emails y las llamadas. Vea la integración con un CRM.
Messenger convive en la misma inbox que LinkedIn, WhatsApp, Instagram y Telegram, con un único modelo de datos.
Un agente redacta una respuesta a partir del historial de la conversación y el usuario la revisa antes de enviarla.
Un consultor o agente hace el seguimiento de los clientes con los que ya habla en Messenger.
Una cuenta conectada sigue sujeta a las Condiciones del servicio de Meta. Diseñe su producto para las conversaciones que el usuario tendría de todos modos: los mensajes no solicitados y la automatización no autorizada pueden llevar a Meta a restringir la cuenta.
¿Está creando una inbox única para varias redes? Descubra cómo funciona una API de mensajería unificada.
Una integración de la API de Facebook con una cuenta personal a través de la Graph API de Meta es limitada. Puede identificar a la persona y leer algunos campos del perfil, pero no puede abrir su bandeja de entrada de Messenger ni publicar en su nombre.
La identidad sigue funcionando. Con Facebook Login, la persona concede a su app un user access token. El permiso public_profile lee los campos públicos predeterminados del perfil y email lee su dirección de email principal. Meta limita los demás permisos de usuario, como user_posts para las publicaciones que un usuario hizo en su biografía, a una lista corta de usos aprobados. Ningún permiso de usuario da acceso a las conversaciones de Messenger de la persona. Cómo se emiten estos tokens se explica en nuestra guía del token de acceso de la API de Facebook.
La publicación en un perfil terminó en 2018. Meta eliminó el permiso publish_actions el 24 de abril de 2018, y las apps ya aprobadas pudieron seguir usándolo hasta el 1 de agosto de 2018. Desde entonces, las apps creadas sobre la Graph API solo publican en Páginas, por eso las herramientas de programación dejaron de ofrecer los perfiles personales.
Una cuenta conectada cubre ambos lados. Cuando el titular conecta su cuenta personal a través de Unipile, su app lee y envía sus mensajes de Messenger, y crea, edita y elimina sus publicaciones, comentarios y reacciones. La parte de publicación se detalla en nuestra guía de la API de publicaciones de Facebook.
| Acción | Graph API con un user access token | Cuenta personal conectada mediante Unipile |
|---|---|---|
| Leer los mensajes de Messenger del usuario | No, ningún permiso de usuario cubre la bandeja de entrada | Sí, chats, mensajes y archivos adjuntos |
| Publicar en el perfil del usuario | No, publish_actions se eliminó en 2018 | Sí, crear, editar y eliminar publicaciones |
| Responder a mensajes | No, la Messenger Platform da servicio a Páginas | Sí, responder o iniciar una conversación |
publish_actions se eliminó en 2018Fuentes: la referencia de permisos de Meta y el changelog de la Graph API del 24 de abril de 2018. Última verificación: 17 de noviembre de 2026.
Conecte cuentas personales de Facebook a su producto
La Messenger Platform de Meta sigue siendo la herramienta adecuada para una empresa que responde a las personas en su propia Página. Cuando su producto necesita una API de Facebook Messenger que incluya cuentas personales, deje que sus usuarios conecten su propia cuenta de Facebook y use una sola API para Facebook y sus demás canales.
Cada usuario conecta su propia cuenta, sin almacenamiento de perfiles. Unipile no es Meta Partner. Lea nuestra página sobre la Ley de Mercados Digitales
Todos los endpoints de la API de Facebook en un solo lugar
Los mensajes son solo una parte. Explore todos los endpoints de Facebook disponibles con Unipile, de los chats a las publicaciones, o lea la guía completa de la API de Facebook para comparar las API oficiales de Meta con las cuentas conectadas.
Respuestas rápidas sobre perfiles, historial de mensajes, primeros mensajes, reacciones, Páginas, chatbots, la Graph API y las bibliotecas no oficiales.
La Messenger Platform de Meta no: da servicio a Páginas de Facebook y cuentas profesionales de Instagram. Un perfil personal puede usarse cuando su titular lo conecta a su app mediante la autenticación alojada de Unipile, y el titular sigue sujeto a las condiciones de Meta.
Sí, una vez conectada la cuenta. La API lista los chats y mensajes de la cuenta personal conectada, incluidas las conversaciones de grupo y los archivos adjuntos, y los webhooks envían a su app los mensajes nuevos, editados y eliminados.
Sí. Una cuenta personal conectada puede iniciar una conversación nueva además de responder. Limítelo a personas que el usuario conoce o con las que trabaja: los mensajes no solicitados van en contra de las condiciones de Meta y pueden provocar la restricción de la cuenta.
Sí. Puede listar, añadir y quitar reacciones en los mensajes, y las reacciones nuevas llegan a su app a través del evento de webhook message.reaction.new.
Sí, para las Páginas que gestiona el usuario conectado. Su app puede leer y responder a los mensajes de la Página y publicar como la Página. Una Página no puede iniciar una conversación ni eliminar sus mensajes, así que sus conversaciones siempre empiezan con un mensaje de la persona.
La Messenger Platform de Meta, y los creadores de chatbots que se basan en ella, solo funcionan con Páginas. Con una cuenta personal conectada, mantenga a una persona en el circuito: una IA redacta una respuesta y el usuario la aprueba. La mensajería totalmente automatizada o no solicitada puede provocar la restricción de la cuenta.
En parte. La Graph API de Meta sigue aceptando un perfil personal para Facebook Login y algunos permisos de lectura, pero no puede abrir la bandeja de entrada de Messenger de la persona, y no publica en perfiles desde que se eliminó publish_actions en 2018. Para una integración de la API de Facebook con una cuenta personal que cubra mensajes y publicaciones, el titular conecta la cuenta a través de Unipile y su app trabaja con una sola API REST.
Sí. Existen bibliotecas de código abierto que inician sesión en messenger.com con la propia sesión del usuario, pero son no oficiales y Meta no las respalda. Pueden dejar de funcionar cuando Facebook cambia su interfaz, y la cuenta que las usa puede ser restringida en virtud de las Condiciones de Meta. Para una aplicación en producción, use la Messenger Platform para las Páginas que gestiona, o una API mantenida en la que el usuario conecta su propia cuenta y sigue sujeto a las Condiciones de Meta.
No a través de sus integraciones de Facebook Messenger: se basan en la Messenger Platform de Meta, que solo da servicio a Páginas. Con una cuenta personal conectada a través de Unipile, el mensaje se envía desde su propio flujo de trabajo, por ejemplo un paso HTTP que llama al endpoint de envío de mensajes para esa cuenta.
No. Unipile es una empresa independiente: no es un Meta Partner y no cuenta con el respaldo, el patrocinio ni la aprobación de Meta. Conectar una cuenta personal de Messenger a través de Unipile no es una integración oficial de la Messenger Platform. Facebook y Messenger son marcas comerciales de Meta Platforms, Inc.
No. El titular de la cuenta inicia sesión mediante la autenticación alojada de Unipile, así que usted no registra ninguna app de Meta, no solicita pages_messaging ni pasa por el App Review. Lo mismo ocurre con las Páginas que gestiona ese usuario.
Unipile está diseñada en el espíritu de la Digital Markets Act (Ley de Mercados Digitales). Cada persona conecta su propia cuenta de Facebook, los mensajes se leen y envían en su nombre, y Unipile no almacena perfiles de usuario. Detalles en nuestra página sobre la Digital Markets Act.
Sí. Una cuenta personal conectada sigue siendo una cuenta de Facebook sujeta a las Condiciones de Meta. Limítese a usos legítimos como responder a clientes, sincronizar conversaciones con un CRM o ayudar a un usuario a gestionar su propia bandeja de entrada; los envíos masivos o no solicitados pueden provocar la restricción de la cuenta.
¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.
Hable con un experto