
Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
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.
api.unipile.com/v2/{ACCOUNT_ID}/chats
200 OK
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é.
Construisez-la avec Unipile en trois étapes
Connectez le compte Facebook et les Pages de chaque utilisateur via Hosted Auth. Ni app Meta, ni App Review.
Récupérez l'historique de leurs chats avec GET /v2/{account_id}/chats, en envoyant votre en-tête X-API-KEY.
Recevez les nouveaux messages, modifications et réactions par webhook, à commencer par message.new.
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.
{FACEBOOK_USER_ID}Historique et nouveaux messages, par utilisateur.
Chaque conversation à un seul contact.
Depuis la fiche, en tant qu'utilisateur ou en tant que Page.
Des webhooks, pas de polling.
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ère | Connecteur no-code | Messenger Platform de Meta | Connexion par utilisateur (Unipile) |
|---|---|---|---|
| Comptes | En général une seule Page Facebook | Pages Facebook (Pages professionnelles) uniquement | Comptes personnels et les Pages qu'ils gèrent |
| Sens | Surtout unidirectionnel : message vers lead | Bidirectionnel, dans la fenêtre de 24 heures | Synchro bidirectionnelle : lire, répondre, réagir |
| Temps réel | Souvent du polling, toutes les 15 minutes sur certains forfaits | Webhooks Meta | Webhooks comme message.new |
| À votre charge | Un workflow par configuration | App Meta, App Review, un token par Page | Un lien Hosted Auth, un account_id par utilisateur |
| Historique | Variable selon le connecteur | Conversations de Page | Chats personnels et inbox de chaque Page |
| Autres canaux | Un connecteur par canal | Une intégration par produit Meta | Même API pour LinkedIn, WhatsApp, Instagram, email |
message.newaccount_id par utilisateurZapier 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.
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.
Votre backend le demande, l'utilisateur l'ouvre.
Hosted AuthIdentifiants, 2FA, puis déblocage facultatif de l'historique.
ENCRYPTED_HISTORYEnregistrez-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.
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.
account_idGET /chats une fois, message.new ensuiteLa 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.
https://api.unipile.com · en-tête X-API-KEYLes 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.
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 :
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.
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.
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 sur | Attention |
|---|---|---|
| ID Facebook de l'interlocuteur | Le contact : votre clé de rattachement | Ne jamais rattacher sur le nom affiché |
account_id | L'utilisateur CRM qui a connecté Facebook | Couvre le compte personnel et les Pages |
| ID de chat personnel | La conversation | Pas une clé de contact |
ID de chat de Page PAGE_<page_id>_<thread_key> | La conversation et sa Page | Le préfixe fait agir Unipile en tant que Page |
| ID de Page et ID de profil de Page | L'ID de Page, sur l'inbox et le statut | Les auteurs côté Page utilisent l'ID de profil : ne jamais comparer les deux |
PAGE_<page_id>_<thread_key>)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.
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
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.
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.
Une Page ne répond qu'aux personnes qui lui ont écrit.
/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send
200 OK
501 api/not_implementedGrisez « Nouvelle conversation » pour une Page. Corps de la requête, pièces jointes et erreurs : voyez comment envoyer un message Messenger via l'API.
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.
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.
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.
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.
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.
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.
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