ES
Guía de integración CRM

Integración CRM con Facebook Messenger: cómo integrarla en su producto

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.

Su CRM · Messenger Sincronizado
Leo Martin¿Envían la chaqueta de lino a Lyon?Asociado · LeadCoveton Apparel
Sara KimGracias, Anna, firmo mañana.Asociado · OportunidadPersonal
Omar HaddadUsted: Su pedido ha salido del almacén.Asociado · ClienteCoveton Apparel
Webhooks message.new message.receipt.read
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
Respuesta corta

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.

Con Unipile

Créela con Unipile en tres pasos

  1. 1

    Conecte la cuenta de Facebook y las Páginas de cada usuario mediante Hosted Auth. Sin app de Meta ni App Review.

  2. 2

    Recupere su historial de chats con GET /v2/{account_id}/chats, enviando su encabezado X-API-KEY.

  3. 3

    Reciba por webhook los nuevos mensajes, las ediciones y las reacciones, empezando por message.new.

Definición

¿Qué es una integración CRM con Facebook Messenger?

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.

Su CRM · Contacto En vivo
Leo MartinLead · Lyon
ResponsableAnna Rossi
CanalMessenger · Página Coveton Apparel
ID de Facebook{FACEBOOK_USER_ID}
ActividadEmailMessenger 2Oportunidades
FacebookInbox de la PáginaCoveton Apparel
Hola, ¿envían la chaqueta de lino a Lyon?10:40
Sí, la entrega tarda 3 días. ¿Qué talla necesita?Coveton Apparel · 10:41
01

Leer

Historial y mensajes nuevos, por usuario.

02

Asociar

Cada conversación a un contacto.

03

Responder

Desde la ficha, como el usuario o como la Página.

04

En tiempo real

Webhooks, no polling.

Enfoques

Cómo conectar Facebook Messenger a un CRM: tres formas

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.

CriterioConector no-codeMeta Messenger PlatformConexión por usuario (Unipile)
CuentasNormalmente una Página de FacebookSolo Páginas de Facebook (Business Pages)Cuentas personales y las Páginas que gestionan
DirecciónCasi siempre unidireccional: de mensaje a leadBidireccional, dentro de la ventana de 24 horasSincronización bidireccional: leer, responder, reaccionar
Tiempo realA menudo polling, cada 15 minutos en algunos planesWebhooks de MetaWebhooks como message.new
Lo que usted gestionaUn flujo por configuraciónApp de Meta, App Review, un token por PáginaUn enlace de Hosted Auth, un account_id por usuario
HistorialDepende del conectorConversaciones de la PáginaChats personales y la inbox de cada Página
Otros canalesUn conector por canalUna integración por producto de MetaLa misma API para LinkedIn, WhatsApp, Instagram y email
Cuentas
No-codeNormalmente una Página de Facebook
MetaSolo Páginas de Facebook
UnipileCuentas personales y las Páginas que gestionan
Dirección
No-codeCasi siempre unidireccional: de mensaje a lead
MetaBidireccional, dentro de la ventana de 24 horas
UnipileSincronización bidireccional: leer, responder, reaccionar
Tiempo real
No-codeA menudo polling, cada 15 minutos en algunos planes
MetaWebhooks de Meta
UnipileWebhooks como message.new
Lo que usted gestiona
No-codeUn flujo por configuración
MetaApp de Meta, App Review, un token por Página
UnipileUn enlace de Hosted Auth, un account_id por usuario
Historial
No-codeDepende del conector
MetaConversaciones de la Página
UnipileChats personales y la inbox de cada Página
Otros canales
No-codeUn conector por canal
MetaUna integración por producto de Meta
UnipileLa misma API para LinkedIn, WhatsApp, Instagram y email

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

Conexión

Conecte la cuenta de Facebook y las Páginas de cada usuario

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.

1

Abrir un enlace de Hosted Auth

Su backend lo solicita; el usuario lo abre.

Hosted Auth
2

Iniciar sesión y desbloquear el historial

Credenciales, 2FA y, opcionalmente, desbloqueo del historial.

ENCRYPTED_HISTORY
3

Guardar el account_id

Guá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.

Sincronización

Sincronice el historial y los mensajes nuevos en tiempo real

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.

FacebookOrigenCuenta personal + PáginasUna por usuario del CRM
ConexiónUnipileUn account_id
Entrada de datosHistorial, luego webhooksGET /chats una vez, message.new después
Su códigoServicio de sincronizaciónEnruta, asocia, deduplica
Sus datosBase de datos del CRMContactos y mensajes

Recuperar el historial de los chats personales y de las inbox de Página

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

URL base https://api.unipile.com · cabecera X-API-KEY
GET/v2/{account_id}/chatsChats personales de la cuenta conectada
GET/v2/{account_id}/inboxes/{inbox_id}/chatsChats de la inbox de una Página
GET/v2/{account_id}/chats/{chat_id}/messagesMensajes de un chat, los más recientes primero

Chats cifrados e historial

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

Webhooks

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:

message.new message.update message.delete message.receipt.read message.receipt.delivery message.reaction.new chat.update chat.delete

Fuentes: Unipile, recuperar chats y mensajes, chats cifrados, funcionalidades por proveedor y configurar un webhook. Última verificación: 17 de noviembre de 2026.

Pruébelo

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.

Construir ahora
Modelo de datos

Asocie las conversaciones de Messenger a los contactos del CRM

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.

IdentificadorDónde guardarloAtención
ID de Facebook de la otra personaEn el contacto: su clave de asociaciónNunca asociar por el nombre visible
account_idEn el usuario del CRM que conectó FacebookCubre la cuenta personal y las Páginas
ID de chat personalEn la conversaciónNo es una clave de contacto
ID de chat de Página PAGE_<page_id>_<thread_key>En la conversación y su PáginaEl prefijo hace que Unipile actúe como la Página
ID de Página e ID de perfil de PáginaEl ID de Página, en la inbox y el estadoLos autores de Página usan el ID de perfil: nunca compare ambos
ID de Facebook de la otra persona
Dónde guardarloEn el contacto: su clave de asociación
AtenciónNunca asociar por el nombre visible
account_id
Dónde guardarloEn el usuario del CRM que conectó Facebook
AtenciónCubre la cuenta personal y las Páginas
ID de chat personal
Dónde guardarloEn la conversación
ID de chat de Página
Dónde guardarloEn la conversación y su Página (PAGE_<page_id>_<thread_key>)
AtenciónEl prefijo hace que Unipile actúe como la Página
ID de Página e ID de perfil de Página
Dónde guardarloEl ID de Página, en la inbox y el estado
AtenciónLos autores de Página usan el ID de perfil: nunca compare ambos

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.

Un handler de message.new que escribe en la ficha del contacto

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
200 OK · un contacto por ID de Facebook, una fila por ID de mensaje
200 OK · un contacto por ID de Facebook, una fila por ID de mensaje

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.

Respuesta

Responda desde la ficha del contacto, como el usuario o como la Página

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.

Su CRM · Leo Martin Conversación de Página
Talla M, por favor. ¿Puede llegar el viernes?10:42
Sí, si hace el pedido antes de las 14:00 de hoy.Coveton Apparel · 10:44
Perfecto, hago el pedido ahora.10:46
Responder comoAnna RossiFacebookPágina Coveton Apparel
Gracias, Leo, su pedido está confirmado. Le enviaremos el enlace de seguimiento.
Nueva conversaciónEnviar

Una Página solo responde a quien le ha escrito.

POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Desde un chat de Página
  • Las respuestas salen como la Página
  • Sin nuevas conversaciones: 501 api/not_implemented
  • No se pueden eliminar sus mensajes: mismo error
Desde un chat personal
  • Las respuestas salen desde la cuenta del usuario
  • Puede iniciar una conversación cuando Facebook lo permite

Desactive «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.

Operaciones

Póngala en marcha para cada cliente: estado, permisos y reglas de Meta

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.

Admin · Cuentas conectadas Parcial
ConexiónEstado
FacebookAnna RossiMensajería · cuenta personalrunning
Página Coveton Apparelpage_<page_id>running
Página Coveton OutletRol de admin retiradodisconnectedReconectar
STATUS 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.

Decida quién ve qué conversaciones

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.

Cumplimiento

Cada usuario conecta su propia cuenta

Para CRM, soporte, asesores o un agente de IA cuyos borradores aprueba una persona. Sin envíos masivos.

¿App de Meta o App Review?No hacen falta: los usuarios se conectan a través de Hosted Auth.
¿Partner oficial de Meta?No. Unipile no es una app oficial de Meta ni Meta Partner.
¿Condiciones de Meta?Todos los usuarios siguen sujetos a ellas.
¿Digital Markets Act?Sin almacenamiento de perfiles. Consulte nuestra página sobre la Ley de Mercados Digitales.

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.

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

Preguntas frecuentes sobre la integración CRM con Facebook Messenger

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