ES
Cuentas personales

API de Facebook Messenger para cuentas personales: lo que Meta permite y cómo conectar una

¿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.

Su CRM Conectada
Tom ReyesFacebookAnna Lee, cuenta personal
Hola Anna, ¿podemos pasar nuestra llamada al jueves?09:12
Webhook: message.new
Claro, el jueves a las 10:00 me va bien. Te envío la invitación.09:14 · Visto
POST api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Respuesta corta

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.

Con Unipile

Mensajes desde una cuenta personal de Facebook en tres pasos

  1. 1

    Conectar. Su usuario vincula su propia cuenta de Facebook mediante Hosted Auth. Sin app de Meta ni App Review.

  2. 2

    Enviar. Llame a la API V2 con su encabezado X-API-KEY:POST/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send

  3. 3

    Recibir. Los mensajes entrantes llegan a su webhook como eventos message.new.

La respuesta

¿Funciona la API de Facebook Messenger con una cuenta personal?

La 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.

Messenger Platform de Meta
Facebook

Página de Facebook

  • Su app de Meta actúa en nombre de una Página con un Page access token.
  • La Página responde a las personas que le escriben primero.
  • Ventana de mensajería estándar de 24 horas tras el último mensaje de la persona.
  • App Review antes de dar servicio a Páginas que no son suyas.
Cuenta conectada con Unipile
Facebook

Cuenta personal de Facebook

  • Cada usuario vincula su propia cuenta mediante autenticación alojada.
  • Su app lee y envía mensajes desde esa cuenta.
  • Una sola REST API y un solo formato de webhook para todos los canales.
  • El usuario sigue sujeto a las condiciones de Meta.

Fuente: la presentación de la Messenger Platform de Meta. Última verificación: noviembre de 2026.

Modelo oficial

Por qué la Messenger Platform de Meta se limita a las Páginas de Facebook

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.

1

App de Meta

Registra una app en Meta for Developers con el caso de uso Messenger.

2

Facebook Login for Business

Un administrador de la Página concede permisos como pages_messaging.

3

Page access token

Su app llama a la Send API solo en nombre de esa Página.

4

Webhook y ventana de 24 horas

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.

¿Qué pasó con la Facebook Chat API?

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.

  • Sin calendario de versiones. Dejan de funcionar cuando Facebook cambia su interfaz.
  • Credenciales en su aplicación. Su aplicación almacena y reutiliza la sesión o la contraseña del usuario.
  • Riesgo para la cuenta. Facebook puede restringir una cuenta cuyo uso infrinja sus Condiciones, y ese riesgo recae en el usuario final.

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.

Conexión

Cómo se conecta una cuenta personal de Facebook a su app

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.

1Su app

Abrir Hosted Auth

El usuario hace clic en «Conectar Facebook» y llega a Hosted Auth.

2El usuario

Iniciar sesión y confirmar

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.

3Unipile

Obtener un account_id

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.

Cumplimiento

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.

Alcance

API de Facebook para cuentas personales: lo que puede hacer una cuenta conectada

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.

TemaPágina con la Messenger PlatformCuenta personal con Unipile
CuentaUna Página de Facebook o una cuenta profesional de InstagramLa propia cuenta personal de Facebook del usuario
Quién conectaUn administrador de la Página, a través de Facebook Login for BusinessEl titular de la cuenta, a través de Hosted Auth o Custom Auth
Lo que guarda su appUn Page access tokenSu clave de API de Unipile y el account_id del usuario
App de Meta y App ReviewUna app de Meta, más el App Review para dar servicio a Páginas que no son suyasSin app de Meta ni App Review por su parte
Quién escribe primeroLa persona escribe a la PáginaEl usuario puede responder o iniciar una conversación nueva
Eventos en tiempo realWebhooks de Messenger en su app de MetaMensajes nuevos, editados y eliminados, confirmaciones de lectura y entrega, reacciones, cambios en los chats
Cuenta
PáginaUna Página de Facebook o una cuenta profesional de Instagram
Cuenta personalLa propia cuenta personal de Facebook del usuario
Quién conecta
PáginaUn administrador de la Página, a través de Facebook Login for Business
Cuenta personalEl titular de la cuenta, a través de Hosted Auth o Custom Auth
Lo que guarda su app
PáginaUn Page access token
Cuenta personalSu clave de API de Unipile y el account_id del usuario
App de Meta y App Review
PáginaUna app de Meta, más el App Review para dar servicio a Páginas que no son suyas
Cuenta personalSin app de Meta ni App Review por su parte
Quién escribe primero
PáginaLa persona escribe a la Página
Cuenta personalEl usuario puede responder o iniciar una conversación nueva
Eventos en tiempo real
PáginaWebhooks de Messenger en su app de Meta
Cuenta personalMensajes nuevos, editados y eliminados, confirmaciones de lectura y entrega, reacciones, cambios en los chats

Endpoints de mensajería

  • Listar chats y mensajes, incluidas las conversaciones de grupo
  • Iniciar una conversación, enviar mensajes y archivos adjuntos
  • Editar, eliminar y reenviar mensajes
  • Añadir y quitar reacciones, marcar como leído, confirmaciones de lectura
  • Silenciar y archivar chats

No compatible

  • Fijar un mensaje
  • Stories

La misma cuenta conectada también expone sus publicaciones, comentarios y reacciones. Esos endpoints se resumen en la guía de la API de Facebook.

Código

Leer los chats y enviar un mensaje desde una cuenta personal

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."},
)
200 OK · mensaje enviado desde la propia cuenta del usuario

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.

Cómo se ven las dos llamadas en su app

1Listar los chatsGET/chats
Su app Conectada
FacebookAnna Lee, cuenta personal
Tom ReyesHola Anna, ¿podemos pasar nuestra llamada al jueves?
Maya ChenNos vemos en el mercado el sábado
Sam PatelGracias por las fotos
Chat seleccionado
chat_id
{CHAT_ID}
name
Tom Reyes
last message
Hola Anna, ¿podemos pasar…
timestamp
09:12
2Enviar la respuestaPOST/messages/send
Su app Conectada
Tom ReyesFacebookAnna Lee, cuenta personal
Hola Anna, ¿podemos pasar nuestra llamada al jueves?09:12
El jueves a las 10:00 me va bien.09:14 · Visto
Solicitud
chat_id
{CHAT_ID}
text
El jueves a las 10:00 me va…
response
200 OK
Casos de uso

Casos de uso legítimos y las reglas de Meta que sus usuarios siguen respetando

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.

CRM

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.

Helpdesk e inbox multicanal

Messenger convive en la misma inbox que LinkedIn, WhatsApp, Instagram y Telegram, con un único modelo de datos.

Asistente de IA

Un agente redacta una respuesta a partir del historial de la conversación y el usuario la revisa antes de enviarla.

Seguimiento de asesores

Un consultor o agente hace el seguimiento de los clientes con los que ya habla en Messenger.

Las condiciones de Meta siguen aplicándose

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.

Graph API

API de Facebook para cuentas personales: lo que la Graph API todavía permite

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ónGraph API con un user access tokenCuenta personal conectada mediante Unipile
Leer los mensajes de Messenger del usuarioNo, ningún permiso de usuario cubre la bandeja de entradaSí, chats, mensajes y archivos adjuntos
Publicar en el perfil del usuarioNo, publish_actions se eliminó en 2018Sí, crear, editar y eliminar publicaciones
Responder a mensajesNo, la Messenger Platform da servicio a PáginasSí, responder o iniciar una conversación
Leer los mensajes de Messenger del usuario
Graph APINo, ningún permiso de usuario cubre la bandeja de entrada
Cuenta conectadaSí, chats, mensajes y archivos adjuntos
Publicar en el perfil del usuario
Graph APINo, publish_actions se eliminó en 2018
Cuenta conectadaSí, crear, editar y eliminar publicaciones
Responder a mensajes
Graph APINo, la Messenger Platform da servicio a Páginas
Cuenta conectadaSí, responder o iniciar una conversación

Fuentes: 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.

Comisión Europea
Regulado por la UE Digital Markets Act (DMA)

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

Referencia de endpoints

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.

Preguntas frecuentes sobre la API para cuentas personales de Facebook

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