FR
Guide d'intégration CRM

Intégration CRM Facebook Messenger : comment la développer dans votre produit

Pour les équipes qui développent un CRM ou un SaaS : connectez le compte Facebook et les Pages de chaque utilisateur, synchronisez les conversations, rattachez les contacts, répondez depuis la fiche.

Votre CRM · Messenger Synchronisé
Leo MartinVous livrez la veste en lin à Lyon ?Rattaché · LeadCoveton Apparel
Sara KimMerci Anna, je signe demain.Rattaché · OpportunitéPersonnel
Omar HaddadVous : votre commande a quitté l'entrepôt.Rattaché · ClientCoveton Apparel
Webhooks message.new message.receipt.read
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
Réponse courte

Une intégration CRM Facebook Messenger synchronise les conversations Messenger de chaque utilisateur sur les fiches contact du CRM et lui permet de répondre depuis le CRM. Ce guide s'adresse aux équipes qui intègrent cette fonctionnalité à leur propre CRM ou produit SaaS, pas aux entreprises qui choisissent un CRM.

Il faut quatre briques : une connexion par utilisateur, l'historique plus la synchro en temps réel, le rattachement aux contacts et des réponses envoyées sous la bonne identité.

Avec Unipile

Construisez-la avec Unipile en trois étapes

  1. 1

    Connectez le compte Facebook et les Pages de chaque utilisateur via Hosted Auth. Ni app Meta, ni App Review.

  2. 2

    Récupérez l'historique de leurs chats avec GET /v2/{account_id}/chats, en envoyant votre en-tête X-API-KEY.

  3. 3

    Recevez les nouveaux messages, modifications et réactions par webhook, à commencer par message.new.

Définition

Qu'est-ce qu'une intégration CRM Facebook Messenger ?

Une intégration CRM Facebook Messenger relie les conversations Messenger à un CRM : chaque message arrive sur la bonne fiche contact et les utilisateurs répondent sans quitter le CRM. Pour une entreprise, c'est un connecteur qu'elle active. Pour une équipe produit, c'est une fonctionnalité qu'elle développe dans son propre CRM ou SaaS : c'est le cas traité dans ce guide.

Dans les deux cas : lire, rattacher à un contact, répondre depuis le CRM, en temps réel, utilisateur par utilisateur. Notre vue d'ensemble de l'articulation des API Facebook présente les plateformes de Meta.

Votre CRM · Contact En direct
Leo MartinLead · Lyon
PropriétaireAnna Rossi
CanalMessenger · Page Coveton Apparel
ID Facebook{FACEBOOK_USER_ID}
ActivitéEmailMessenger 2Opportunités
FacebookInbox de la PageCoveton Apparel
Bonjour, vous livrez la veste en lin à Lyon ?10:40
Oui, la livraison prend 3 jours. Quelle taille vous faut-il ?Coveton Apparel · 10:41
01

Lire

Historique et nouveaux messages, par utilisateur.

02

Rattacher

Chaque conversation à un seul contact.

03

Répondre

Depuis la fiche, en tant qu'utilisateur ou en tant que Page.

04

Temps réel

Des webhooks, pas de polling.

Approches

Connecter Facebook Messenger à un CRM : trois méthodes

Un connecteur no-code est rapide mais surtout unidirectionnel. La Messenger Platform de Meta est bidirectionnelle mais limitée aux Pages, derrière l'App Review. Une API de connexion par utilisateur couvre les comptes personnels et les Pages, sans app Meta.

CritèreConnecteur no-codeMessenger Platform de MetaConnexion par utilisateur (Unipile)
ComptesEn général une seule Page FacebookPages Facebook (Pages professionnelles) uniquementComptes personnels et les Pages qu'ils gèrent
SensSurtout unidirectionnel : message vers leadBidirectionnel, dans la fenêtre de 24 heuresSynchro bidirectionnelle : lire, répondre, réagir
Temps réelSouvent du polling, toutes les 15 minutes sur certains forfaitsWebhooks MetaWebhooks comme message.new
À votre chargeUn workflow par configurationApp Meta, App Review, un token par PageUn lien Hosted Auth, un account_id par utilisateur
HistoriqueVariable selon le connecteurConversations de PageChats personnels et inbox de chaque Page
Autres canauxUn connecteur par canalUne intégration par produit MetaMême API pour LinkedIn, WhatsApp, Instagram, email
Comptes
No-codeEn général une seule Page Facebook
MetaPages Facebook uniquement
UnipileComptes personnels et les Pages qu'ils gèrent
Sens
No-codeSurtout unidirectionnel : message vers lead
MetaBidirectionnel, dans la fenêtre de 24 heures
UnipileSynchro bidirectionnelle : lire, répondre, réagir
Temps réel
No-codeSouvent du polling, toutes les 15 minutes sur certains forfaits
MetaWebhooks Meta
UnipileWebhooks comme message.new
À votre charge
No-codeUn workflow par configuration
MetaApp Meta, App Review, un token par Page
UnipileUn lien Hosted Auth, un account_id par utilisateur
Historique
No-codeVariable selon le connecteur
MetaConversations de Page
UnipileChats personnels et inbox de chaque Page
Autres canaux
No-codeUn connecteur par canal
MetaUne intégration par produit Meta
UnipileMême API pour LinkedIn, WhatsApp, Instagram, email

Zapier ou Make conviennent à une entreprise et une Page, et Meta Business Suite donne à cette entreprise une inbox pour sa propre Page. Un produit multi-clients a besoin de l'intégration dans son propre code.

Côté Meta, chaque Page client exige un Page access token et des permissions validées par Meta, comme le montre notre guide de l'API Pages Facebook. Les réponses suivent la fenêtre de 24 heures et les message tags, dont Meta a retiré plusieurs en 2026. Et cette voie n'atteint jamais les comptes personnels que les commerciaux et les conseillers utilisent avec leurs clients.

Sources : la documentation Messenger Platform send messages de Meta et les fonctionnalités par provider d'Unipile. Dernière vérification : 17 novembre 2026.

Connexion

Connecter le compte Facebook et les Pages de chaque utilisateur

Chaque utilisateur du CRM ouvre un lien Hosted Auth et se connecte à Facebook, authentification à deux facteurs comprise. Votre CRM reçoit un seul account_id qui couvre son compte personnel et toutes les Pages qu'il administre, toutes activées par défaut.

1

Ouvrir un lien Hosted Auth

Votre backend le demande, l'utilisateur l'ouvre.

Hosted Auth
2

Se connecter et débloquer l'historique

Identifiants, 2FA, puis déblocage facultatif de l'historique.

ENCRYPTED_HISTORY
3

Stocker l'account_id

Enregistrez-le sur l'utilisateur CRM. Ses Pages viennent avec.

{ACCOUNT_ID}

Les Pages s'activent via le produit page à la connexion ou à la reconnexion ; une Page non activée renvoie 403 api/insufficient_permissions. La connexion est détaillée dans notre guide de l'API Facebook Messenger pour les comptes personnels.

Source : la documentation Facebook Pages d'Unipile. Dernière vérification : 17 novembre 2026.

Synchro

Synchroniser l'historique des conversations et les nouveaux messages en temps réel

Commencez par un backfill via l'API : les chats personnels, puis l'inbox de chaque Page. Passez ensuite aux webhooks pour que chaque nouveau message, modification, accusé de lecture ou réaction arrive dans votre CRM en temps réel, comme le détaille notre page API Facebook Messenger.

FacebookSourceCompte personnel + PagesUn par utilisateur CRM
ConnexionUnipileUn seul account_id
Entrée des donnéesBackfill, puis webhooksGET /chats une fois, message.new ensuite
Votre codeService de synchroRoute, rattache, dédoublonne
Vos donnéesBase du CRMContacts et messages

Backfill des chats personnels et des inbox de Page

La liste des chats du compte ne contient que les conversations personnelles ; chaque Page a sa propre inbox, PAGE_<page_id>_INBOX. Les listes renvoient jusqu'à 100 éléments par page, les messages les plus récents en premier : remontez aussi loin que votre CRM en a besoin.

URL de base https://api.unipile.com · en-tête X-API-KEY
GET/v2/{account_id}/chatsChats personnels du compte connecté
GET/v2/{account_id}/inboxes/{inbox_id}/chatsChats d'une inbox de Page
GET/v2/{account_id}/chats/{chat_id}/messagesMessages d'un chat, les plus récents d'abord

Chats chiffrés et historique

Les chats personnels 1:1 et de groupe sont chiffrés de bout en bout ; les conversations de Page ne le sont pas. Les anciens messages personnels se trouvent dans une sauvegarde chiffrée que l'utilisateur déverrouille avec son code de récupération ou son code PIN Messenger, lors d'une étape que Hosted Auth affiche à la connexion. Sans elle, seuls les messages postérieurs à la connexion sont disponibles.

Webhooks

Une seule URL de webhook sert tous les comptes connectés. Les événements de Page portent l'ID de chat propre à la Page : routez-les donc grâce au préfixe PAGE_<page_id>_. Événements disponibles pour Facebook :

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

Sources : documentation Unipile récupérer les chats et les messages, chats chiffrés, fonctionnalités par provider et configurer un webhook. Dernière vérification : 17 novembre 2026.

Essayer

Connectez un compte Facebook dans votre espace d'essai

Liez un compte, listez ses chats et pointez un webhook vers votre service. Essai gratuit de 7 jours, sans carte bancaire.

Démarrer
Modèle de données

Rattacher les conversations Messenger aux contacts du CRM

Rattachez chaque conversation à un contact via l'ID Facebook de l'interlocuteur, jamais via son nom affiché. Routez les conversations de Page et les conversations personnelles grâce au préfixe PAGE_<page_id>_ de l'ID de chat.

IdentifiantÀ stocker surAttention
ID Facebook de l'interlocuteurLe contact : votre clé de rattachementNe jamais rattacher sur le nom affiché
account_idL'utilisateur CRM qui a connecté FacebookCouvre le compte personnel et les Pages
ID de chat personnelLa conversationPas une clé de contact
ID de chat de Page PAGE_<page_id>_<thread_key>La conversation et sa PageLe préfixe fait agir Unipile en tant que Page
ID de Page et ID de profil de PageL'ID de Page, sur l'inbox et le statutLes auteurs côté Page utilisent l'ID de profil : ne jamais comparer les deux
ID Facebook de l'interlocuteur
À stocker surLe contact : votre clé de rattachement
AttentionNe jamais rattacher sur le nom affiché
account_id
À stocker surL'utilisateur CRM qui a connecté Facebook
AttentionCouvre le compte personnel et les Pages
ID de chat personnel
À stocker surLa conversation
ID de chat de Page
À stocker surLa conversation et sa Page (PAGE_<page_id>_<thread_key>)
AttentionLe préfixe fait agir Unipile en tant que Page
ID de Page et ID de profil de Page
À stocker surL'ID de Page, sur l'inbox et le statut
AttentionLes auteurs côté Page utilisent l'ID de profil : ne jamais comparer les deux

Un piège : pour une même conversation, l'ID de chat renvoyé par l'API peut différer de celui d'un événement webhook. Stockez les deux sur la conversation et réconciliez-les côté CRM, en vous appuyant sur l'ID Facebook du contact. « Find Chats by User » renvoie les chats existants d'un contact, ou une liste vide.

Un handler message.new qui écrit dans la fiche contact

readUnipileEvent représente votre mapping du 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 contact par ID Facebook, une ligne par ID de message
200 OK · un contact par ID Facebook, une ligne par ID de message

Formats d'ID de chat tirés de la documentation Facebook Pages, recherche de chats tirée de récupérer les chats et les messages.

Réponse

Répondre depuis la fiche contact, en tant qu'utilisateur ou en tant que Page

Envoyez la réponse dans l'ID de chat de la conversation. Un ID de chat de Page répond au nom de la Page ; un ID de chat personnel envoie depuis le compte de l'utilisateur. L'éditeur indique quelle identité s'applique.

Votre CRM · Leo Martin Conversation de Page
Taille M, s'il vous plaît. Elle peut arriver d'ici vendredi ?10:42
Oui, si vous commandez avant 14 h aujourd'hui.Coveton Apparel · 10:44
Parfait, je commande.10:46
Répondre en tant queAnna RossiFacebookPage Coveton Apparel
Merci Leo, votre commande est confirmée. Le lien de suivi arrive.
Nouvelle conversationEnvoyer

Une Page ne répond qu'aux personnes qui lui ont écrit.

POST /v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
Depuis un chat de Page
  • Les réponses partent au nom de la Page
  • Pas de nouvelle conversation : 501 api/not_implemented
  • Pas de suppression de ses messages : même erreur
Depuis un chat personnel
  • Les réponses partent du compte de l'utilisateur
  • Peut lancer une conversation quand Facebook le permet

Grisez « Nouvelle conversation » pour une Page. Corps de la requête, pièces jointes et erreurs : voyez comment envoyer un message Messenger via l'API.

Exploitation

Le faire tourner pour chaque client : statut, permissions et règles de Meta

Affichez l'état de chaque connexion. Chaque Page remonte son propre statut : une Page en panne n'interrompt ni les messages personnels ni les autres Pages.

Admin · Comptes connectés Partiel
ConnexionStatut
FacebookAnna RossiMessagerie · compte personnelrunning
Page Coveton Apparelpage_<page_id>running
Page Coveton OutletRôle d'admin retirédisconnectedReconnecter
STATUS metadata.products_connection_status par Page

Chaque Page a sa propre clé dans metadata.products_connection_status, nommée page_<page_id>. Quand une Page tombe, le compte passe en partial ou degraded. Une Page dont le rôle d'admin a été perdu reste disconnected jusqu'à la reconnexion : affichez-la et proposez de la reconnecter.

Décider qui voit quelles conversations

Montrez les conversations personnelles à leur propriétaire et aux managers choisis, les conversations de Page à l'équipe de la Page, dans une inbox unifiée avec attribution et tags. C'est le même modèle qu'une API de messagerie pour logiciels CRM couvrant LinkedIn, WhatsApp et l'email, et la raison pour laquelle une API de messagerie unifiée permet d'ajouter Messenger sans nouveau connecteur.

Conformité

Chaque utilisateur connecte son propre compte

Pour le CRM, le support, les conseillers ou un agent IA dont une personne valide les brouillons. Pas d'envoi en masse.

App Meta ou App Review ?Inutile : les utilisateurs se connectent via Hosted Auth.
Partenaire officiel de Meta ?Non. Unipile n'est ni une app Meta officielle ni un Meta Partner.
Conditions de Meta ?Chaque utilisateur reste tenu de les respecter.
Digital Markets Act ?Aucun stockage de profils. Consultez notre page Digital Markets Act.

Commencez à développer votre intégration Messenger

Une intégration CRM Facebook Messenger, c'est une connexion par utilisateur, un backfill puis des webhooks, des contacts rattachés par ID Facebook et des réponses sous la bonne identité. Le même code sert LinkedIn, WhatsApp et l'email. Essai gratuit de 7 jours, sans carte bancaire.

Commission européenne
Réglementé par l'UE Digital Markets Act (DMA)

Chaque utilisateur connecte son propre compte, sans stockage de profils. Unipile n'est pas partenaire Meta. Unipile et le DMA

Tous les endpoints de l'API Facebook au même endroit

Messenger n'est qu'une partie du tableau. Consultez tous les endpoints Facebook disponibles avec Unipile, des posts et commentaires aux profils, ou partez de notre guide complet de l'API Facebook.

FAQ sur l'intégration CRM Facebook Messenger

Messagerie CRM, réponses automatisées et Pages multiples.

Pour que les conversations ne vivent plus dans le téléphone d'une seule personne. Chaque message arrive sur la fiche contact, l'équipe voit tout l'historique, et relances, attribution et reporting fonctionnent sur Messenger comme sur l'email.

Envoyer et recevoir des messages sur Messenger, WhatsApp, LinkedIn ou par email depuis un CRM, chaque conversation étant rattachée à un contact. Une intégration CRM Facebook Messenger couvre un canal ; une API de messagerie unifiée apporte les autres avec le même modèle de données.

Gardez un humain dans la boucle : un agent IA rédige une réponse à partir de l'historique du contact et un utilisateur la valide avant l'envoi. Les utilisateurs restent tenus par les conditions de Meta : pas de messages non sollicités ni d'envois en masse.

Oui. Chaque Page administrée par l'utilisateur est activée par défaut sur le même account_id, avec sa propre inbox (PAGE_<page_id>_INBOX) et son propre statut. Affichez chaque Page comme une inbox distincte dans votre CRM.

Encore des questions ? Notre équipe est là pour vous aider.

Parler à un expert