
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
Para equipos que crean un CRM o un SaaS: conecte la cuenta de Facebook y las Páginas de cada usuario, sincronice las conversaciones, asocie los contactos y responda desde la ficha.
api.unipile.com/v2/{ACCOUNT_ID}/chats
200 OK
Una integración CRM con Facebook Messenger sincroniza las conversaciones de Messenger de cada usuario en las fichas de contacto del CRM y le permite responder desde el CRM. Esta guía está dirigida a los equipos que integran esa función en su propio CRM o producto SaaS, no a las empresas que eligen un CRM.
Requiere cuatro componentes: una conexión por usuario, sincronización del historial y en tiempo real, asociación de contactos y respuestas con la identidad adecuada.
Créela con Unipile en tres pasos
Conecte la cuenta de Facebook y las Páginas de cada usuario mediante Hosted Auth. Sin app de Meta ni App Review.
Recupere su historial de chats con GET /v2/{account_id}/chats, enviando su encabezado X-API-KEY.
Reciba por webhook los nuevos mensajes, las ediciones y las reacciones, empezando por message.new.
Una integración CRM con Facebook Messenger vincula las conversaciones de Messenger a un CRM, de modo que cada mensaje llega a la ficha del contacto correcto y los usuarios responden sin salir del CRM. Para una empresa, es un conector que se activa. Para un equipo de producto, es una funcionalidad que integra en su propio CRM o SaaS: esta guía trata ese caso.
En ambos casos: leer, asociar a un contacto y responder desde el CRM, en tiempo real y por usuario. Nuestra visión general de cómo encajan las API de Facebook trata las plataformas de Meta.
{FACEBOOK_USER_ID}Historial y mensajes nuevos, por usuario.
Cada conversación a un contacto.
Desde la ficha, como el usuario o como la Página.
Webhooks, no polling.
Un conector no-code es rápido, pero casi siempre unidireccional. La Messenger Platform de Meta es bidireccional, pero solo para Páginas y tras el App Review. Una API de conexión por usuario cubre cuentas personales y Páginas, sin app de Meta.
| Criterio | Conector no-code | Meta Messenger Platform | Conexión por usuario (Unipile) |
|---|---|---|---|
| Cuentas | Normalmente una Página de Facebook | Solo Páginas de Facebook (Business Pages) | Cuentas personales y las Páginas que gestionan |
| Dirección | Casi siempre unidireccional: de mensaje a lead | Bidireccional, dentro de la ventana de 24 horas | Sincronización bidireccional: leer, responder, reaccionar |
| Tiempo real | A menudo polling, cada 15 minutos en algunos planes | Webhooks de Meta | Webhooks como message.new |
| Lo que usted gestiona | Un flujo por configuración | App de Meta, App Review, un token por Página | Un enlace de Hosted Auth, un account_id por usuario |
| Historial | Depende del conector | Conversaciones de la Página | Chats personales y la inbox de cada Página |
| Otros canales | Un conector por canal | Una integración por producto de Meta | La misma API para LinkedIn, WhatsApp, Instagram y email |
message.newaccount_id por usuarioZapier o Make sirven para una empresa y una Página, y Meta Business Suite ofrece a esa empresa una inbox para su propia Página. Un producto con muchos clientes necesita la integración en su propio código.
Por la vía de Meta, cada Página de cliente necesita un Page access token y permisos revisados por Meta, como muestra nuestra guía de la API de Páginas de Facebook. Las respuestas siguen la ventana de 24 horas y los message tags, varios de los cuales Meta retiró en 2026. Y nunca llega a las cuentas personales que los comerciales y asesores usan con sus clientes.
Fuentes: Messenger Platform send messages de Meta, funcionalidades por proveedor de Unipile. Última verificación: 17 de noviembre de 2026.
Cada usuario del CRM abre un enlace de Hosted Auth e inicia sesión en Facebook, autenticación de dos factores incluida. Su CRM recibe un único account_id que cubre su cuenta personal y todas las Páginas que administra, todas activadas por defecto.
Su backend lo solicita; el usuario lo abre.
Hosted AuthCredenciales, 2FA y, opcionalmente, desbloqueo del historial.
ENCRYPTED_HISTORYGuárdelo en el usuario del CRM. Sus Páginas vienen incluidas.
{ACCOUNT_ID}Las Páginas se activan mediante el producto page al vincular o reconectar la cuenta; una Página no activada devuelve 403 api/insufficient_permissions. El inicio de sesión se detalla en nuestra guía de la API de Facebook Messenger para cuentas personales.
Fuente: documentación de Páginas de Facebook de Unipile. Última verificación: 17 de noviembre de 2026.
Primero recupere el historial a través de la API: los chats personales y después la inbox de cada Página. Luego pase a los webhooks, para que cada mensaje nuevo, edición, confirmación o reacción llegue a su CRM en tiempo real, como se indica en nuestra página de la API de Facebook Messenger.
account_idGET /chats una vez, message.new despuésLa lista de chats de la cuenta solo contiene las conversaciones personales; cada Página tiene su propia inbox, PAGE_<page_id>_INBOX. Las listas devuelven hasta 100 elementos por página, con los mensajes más recientes primero: pagine hacia atrás tanto como necesite su CRM.
https://api.unipile.com · cabecera X-API-KEYLos chats personales 1:1 y de grupo están cifrados de extremo a extremo; las conversaciones de Página no. Los mensajes personales anteriores están en una copia de seguridad cifrada que el usuario desbloquea con su código de recuperación o su PIN de Messenger, en un paso que Hosted Auth muestra durante la conexión. Sin él, solo están disponibles los mensajes posteriores a la conexión.
Una sola URL de webhook sirve para todas las cuentas conectadas. Los eventos de Página llevan el ID de chat de la Página, así que enrútelos por el prefijo PAGE_<page_id>_. Eventos disponibles para Facebook:
Fuentes: Unipile, recuperar chats y mensajes, chats cifrados, funcionalidades por proveedor y configurar un webhook. Última verificación: 17 de noviembre de 2026.
Conecte una cuenta de Facebook en su espacio de prueba
Vincule una cuenta, liste sus chats y apunte un webhook a su servicio. Prueba gratuita de 7 días, sin tarjeta de crédito.
Asocie cada conversación a un contacto mediante el ID de Facebook de la otra persona, nunca mediante el nombre visible. Enrute las conversaciones de Página y personales por el prefijo PAGE_<page_id>_ del ID de chat.
| Identificador | Dónde guardarlo | Atención |
|---|---|---|
| ID de Facebook de la otra persona | En el contacto: su clave de asociación | Nunca asociar por el nombre visible |
account_id | En el usuario del CRM que conectó Facebook | Cubre la cuenta personal y las Páginas |
| ID de chat personal | En la conversación | No es una clave de contacto |
ID de chat de Página PAGE_<page_id>_<thread_key> | En la conversación y su Página | El prefijo hace que Unipile actúe como la Página |
| ID de Página e ID de perfil de Página | El ID de Página, en la inbox y el estado | Los autores de Página usan el ID de perfil: nunca compare ambos |
PAGE_<page_id>_<thread_key>)Una trampa: para una misma conversación, el ID de chat que devuelve la API puede diferir del de un evento de webhook. Guarde ambos en la conversación y concílielos en el CRM, tomando como referencia el ID de Facebook del contacto. «Find Chats by User» devuelve los chats existentes de un contacto, o una lista vacía.
readUnipileEvent representa su mapeo del payload.
// One URL for every connected account
app.post("/webhooks/unipile", express.json(), async (req, res) => {
res.sendStatus(200); // acknowledge first, process after
// Your mapping of the payload documented in the webhook reference
const evt = readUnipileEvent(req.body);
if (evt.type !== "message.new") return;
// 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
const page = evt.chatId.match(/^PAGE_([^_]+)_/);
const inbox = page ? { kind: "page", pageId: page[1] } : { kind: "personal" };
// 2. Owner: the CRM user who connected this account_id
const owner = await crm.users.findByAccountId(evt.accountId);
// 3. Contact: the other person's Facebook ID, never the name
const contact =
(await crm.contacts.findByFacebookId(owner.tenantId, evt.counterpartId)) ??
(await crm.contacts.createForReview({ facebookId: evt.counterpartId, owner }));
// 4. Keep the webhook chat ID next to the one from the backfill
await crm.conversations.addChatId(contact.id, inbox, evt.chatId, "webhook");
// 5. Write the message once, keyed by its message ID
await crm.messages.upsert({
contactId: contact.id, inbox, messageId: evt.messageId,
direction: evt.fromOwner ? "out" : "in", text: evt.text,
});
});
import re
from flask import request
PAGE_PREFIX = re.compile(r"^PAGE_([^_]+)_")
# One URL for every connected account
@app.post("/webhooks/unipile")
def unipile_webhook():
# Your mapping of the payload documented in the webhook reference
evt = read_unipile_event(request.get_json())
if evt.type != "message.new":
return "", 200
# 1. Route: a PAGE_<page_id>_ prefix means a Page conversation
page = PAGE_PREFIX.match(evt.chat_id)
inbox = {"kind": "page", "page_id": page.group(1)} if page else {"kind": "personal"}
# 2. Owner: the CRM user who connected this account_id
owner = crm.users.find_by_account_id(evt.account_id)
# 3. Contact: the other person's Facebook ID, never the name
contact = crm.contacts.find_by_facebook_id(owner.tenant_id, evt.counterpart_id) \
or crm.contacts.create_for_review(facebook_id=evt.counterpart_id, owner=owner)
# 4. Keep the webhook chat ID next to the one from the backfill
crm.conversations.add_chat_id(contact.id, inbox, evt.chat_id, source="webhook")
# 5. Write the message once, keyed by its message ID
crm.messages.upsert(
contact_id=contact.id, inbox=inbox, message_id=evt.message_id,
direction="out" if evt.from_owner else "in", text=evt.text,
)
return "", 200
Formatos de ID de chat según la documentación de Páginas de Facebook; búsqueda de chats según recuperar chats y mensajes.
Envíe la respuesta al ID de chat de la conversación. Un ID de chat de Página responde como la Página; un ID de chat personal envía desde la propia cuenta del usuario. El editor indica qué identidad se aplica.
Una Página solo responde a quien le ha escrito.
/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
501 api/not_implementedDesactive «Nueva conversación» para una Página. Cuerpo de la solicitud, archivos adjuntos y errores: vea cómo enviar un mensaje de Messenger por API.
Muestre el estado de cada conexión. Cada Página informa de su propio estado, así que una Página caída no detiene los mensajes personales ni las demás Páginas.
metadata.products_connection_status
por Página
Cada Página tiene su propia clave en metadata.products_connection_status, llamada page_<page_id>. Cuando una Página cae, la cuenta pasa a partial o degraded. Una Página cuyo rol de administrador se ha perdido permanece en disconnected hasta la reconexión: muéstrelo y ofrezca reconectarla.
Muestre las conversaciones personales a su propietario y a los responsables que elija, y las conversaciones de Página al equipo de la Página, en una inbox unificada con asignación y etiquetas. Es el mismo modelo que una API de mensajería para software CRM que cubre LinkedIn, WhatsApp y email, y la razón por la que una API de mensajería unificada le permite añadir Messenger sin un nuevo conector.
Cada usuario conecta su propia cuenta
Para CRM, soporte, asesores o un agente de IA cuyos borradores aprueba una persona. Sin envíos masivos.
Empiece a construir su integración con Messenger
Una integración CRM con Facebook Messenger consiste en una conexión por usuario, una recuperación del historial seguida de webhooks, contactos asociados por ID de Facebook y respuestas con la identidad adecuada. El mismo código sirve para LinkedIn, WhatsApp y email. Prueba gratuita de 7 días, sin tarjeta de crédito.
Cada usuario conecta su propia cuenta, sin almacenamiento de perfiles. Unipile no es Meta Partner. Unipile y la DMA
Todos los endpoints de la API de Facebook en un solo lugar
Messenger es solo una parte. Consulte todos los endpoints de Facebook disponibles con Unipile, de las publicaciones y los comentarios a los perfiles, o empiece por nuestra guía completa de la API de Facebook.
Mensajería en el CRM, respuestas automatizadas y varias Páginas.
Para que las conversaciones dejen de vivir en el teléfono de una sola persona. Cada mensaje llega a la ficha del contacto, el equipo ve todo el historial y el seguimiento, la asignación y los informes funcionan en Messenger igual que en el email.
Enviar y recibir mensajes de Messenger, WhatsApp, LinkedIn o email desde el propio CRM, con cada conversación asociada a un contacto. Una integración CRM con Facebook Messenger cubre un canal; una API de mensajería unificada añade los demás con el mismo modelo de datos.
Mantenga a una persona en el circuito: un agente de IA redacta una respuesta a partir del historial del contacto y un usuario la aprueba antes de enviarla. Los usuarios siguen sujetos a las condiciones de Meta: nada de mensajes no solicitados ni masivos.
Sí. Cada Página que administra el usuario se activa por defecto en el mismo account_id, cada una con su propia inbox (PAGE_<page_id>_INBOX) y su propio estado. Muestre cada Página como una inbox independiente en su CRM.
¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.
Hable con un experto