FR
Comptes personnels

API Facebook Messenger et compte personnel : ce que Meta autorise et comment en connecter un

Vous cherchez une API Facebook Messenger pour compte personnel ? La Messenger Platform de Meta ne sert que les Pages Facebook. Voici pourquoi, et comment vos utilisateurs peuvent connecter leur propre compte à votre app.

Votre CRM Connecté
Tom ReyesFacebookAnna Lee, compte personnel
Bonjour Anna, on peut décaler notre appel à jeudi ?09:12
Webhook : message.new
Bien sûr, jeudi 10 h me va. Je vous envoie l'invitation.09:14 · Vu
POST api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send 200 OK
En bref

L'API Facebook Messenger officielle ne prend pas en charge les comptes personnels. La Messenger Platform de Meta permet à une Page Facebook ou à un compte Instagram professionnel de répondre aux gens, jamais à un profil personnel. Pour travailler avec un compte Facebook personnel, son propriétaire le connecte à votre app via une API tierce comme Unipile.

Les projets open source qui pilotent messenger.com depuis un navigateur sont non officiels, pour la plupart non maintenus, et cassent à chaque changement d'interface. Un compte connecté passe par une API maintenue, avec des webhooks.

Pour une vue d'ensemble des API de Meta, voyez comment les API Facebook s'articulent.

Avec Unipile

Les messages d'un compte Facebook personnel en trois étapes

  1. 1

    Connecter. Votre utilisateur connecte son propre compte Facebook via Hosted Auth. Ni app Meta, ni App Review.

  2. 2

    Envoyer. Appelez l'API V2 avec votre en-tête X-API-KEY :POST/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send

  3. 3

    Recevoir. Les messages entrants arrivent sur votre webhook sous forme d'événements message.new.

La réponse

L'API Facebook Messenger fonctionne-t-elle avec un compte personnel ?

Pas l'API officielle. Meta a conçu la Messenger Platform pour les entreprises : elle permet à une Page Facebook ou à un compte Instagram professionnel de répondre aux personnes qui lui écrivent. Un compte Facebook personnel ne peut rejoindre votre app que si son propriétaire le connecte, via une API tierce qui agit en son nom.

Messenger Platform de Meta
Facebook

Page Facebook

  • Votre app Meta agit pour une Page avec un Page access token.
  • La Page répond aux personnes qui lui écrivent en premier.
  • Fenêtre de messagerie standard de 24 heures après le dernier message de la personne.
  • App Review obligatoire pour servir des Pages qui ne vous appartiennent pas.
Compte connecté avec Unipile
Facebook

Compte Facebook personnel

  • Chaque utilisateur relie son propre compte via une authentification hébergée.
  • Votre app lit et envoie des messages depuis ce compte.
  • Une seule API REST et un seul format de webhook pour tous les canaux.
  • L'utilisateur reste soumis aux conditions de Meta.

Source : présentation de la Messenger Platform de Meta. Dernière vérification : novembre 2026.

Modèle officiel

Pourquoi la Messenger Platform de Meta s'arrête aux Pages Facebook

La Messenger Platform est pensée autour d'une Page, pas d'une personne. Chaque appel agit pour le compte d'une Page Facebook, avec un Page access token et la permission pages_messaging : aucun token ne représente une messagerie personnelle.

1

App Meta

Vous créez une app sur Meta for Developers avec le cas d'usage Messenger.

2

Facebook Login for Business

Un administrateur de Page accorde des permissions comme pages_messaging.

3

Page access token

Votre app appelle la Send API pour le compte de cette Page uniquement.

4

Webhook et fenêtre de 24 heures

La Page reçoit les messages et répond dans la fenêtre de messagerie standard.

Les permissions se demandent via Facebook Login for Business, et business_management est une dépendance de pages_messaging. L'App Review n'est pas nécessaire si vous envoyez et recevez des messages uniquement pour votre propre Page ; elle l'est pour servir les Pages d'autres entreprises. La plupart des réponses doivent partir dans les 24 heures suivant le dernier message de la personne ; le message tag HUMAN_AGENT étend les réponses manuelles à 7 jours, après App Review. Aucune de ces étapes de la Graph API ne peut cibler un profil personnel, c'est pourquoi les outils construits sur l'API officielle ne connectent que des Pages. Le coût de cette configuration est détaillé dans notre guide sur les prix de l'API Facebook Messenger.

Sources : présentation de la Messenger Platform et référence de la Send API de Meta. Dernière vérification : novembre 2026.

Qu'est devenue l'API Facebook Chat ?

Meta a fermé l'ancienne API Facebook Chat (XMPP, chat.facebook.com) en 2015, avec la fin de la Graph API v1.0 et de la permission xmpp_login. Il n'existe aucune API officielle pour la messagerie d'un compte Facebook personnel : la Messenger Platform qui l'a remplacée pour la messagerie professionnelle n'agit que pour des Pages. Les bibliothèques non officielles publiées sur npm depuis se connectent à messenger.com avec la session de l'utilisateur. Elles ne sont pas prises en charge par Meta, et le projet open source d'origine se déclare en mode maintenance.

  • Aucun calendrier de mises à jour. Elles cessent de fonctionner dès que Facebook modifie son interface.
  • Des identifiants dans votre app. Votre app stocke et réutilise la session ou le mot de passe de l'utilisateur.
  • Un risque pour le compte. Facebook peut restreindre un compte dont l'usage enfreint ses conditions, et ce risque retombe sur l'utilisateur final.

Pour écrire depuis une Page que vous gérez, utilisez la Messenger Platform et envoyez un message Messenger via l'API. Pour le compte de l'utilisateur lui-même, utilisez une API maintenue : l'utilisateur se connecte via Hosted Auth, votre app ne manipule donc jamais son mot de passe, et vous obtenez un account_id, des webhooks et une équipe support (voir comment un compte personnel se connecte). Les conditions de Meta s'appliquent toujours à ce compte.

Connexion

Comment un compte Facebook personnel se connecte à votre app

C'est le propriétaire du compte qui le connecte lui-même. Votre app ouvre une page Hosted Auth d'Unipile (ou votre propre écran avec Custom Auth), l'utilisateur se connecte à Facebook et valide l'authentification à deux facteurs, puis votre app reçoit un account_id pour appeler l'API.

1Votre app

Ouvrir Hosted Auth

L'utilisateur clique sur « Connecter Facebook » et arrive sur Hosted Auth.

2L'utilisateur

Se connecter et confirmer

Identifiant, email ou téléphone avec mot de passe, cookies du navigateur ou extension UniLogin, puis 2FA par SMS, application d'authentification, WhatsApp, validation dans l'app ou code à usage unique.

3Unipile

Obtenir un account_id

Le compte connecté apparaît dans votre dashboard et chaque appel utilise son account_id.

Ce parcours ne comporte ni écran OAuth de Meta ni QR code, et vous n'avez ni app Meta à créer ni App Review à passer de votre côté. Les méthodes par provider figurent dans le tableau des fonctionnalités par provider, et la présentation du produit se trouve sur la page API Facebook Messenger.

Conformité

Chaque utilisateur connecte son propre compte

Unipile n'est pas un produit Meta. Ce n'est pas un Meta Partner et Unipile n'est pas approuvée par Meta. Chaque utilisateur connecte son propre compte, Unipile agit pour le compte de cet utilisateur authentifié, et l'utilisateur reste soumis aux conditions de Meta.

Périmètre

API pour compte Facebook personnel : ce que permet un compte connecté

Concrètement, une intégration de l'API Facebook Messenger pour compte personnel expose la messagerie Messenger de l'utilisateur via l'API Unipile : chats, messages, pièces jointes, réactions et accusés, plus des webhooks en temps réel, comparés ci-dessous au modèle officiel des Pages.

SujetPage via la Messenger PlatformCompte personnel via Unipile
CompteUne Page Facebook ou un compte Instagram professionnelLe compte Facebook personnel de l'utilisateur
Qui connecteUn administrateur de Page, via Facebook Login for BusinessLe propriétaire du compte, via Hosted Auth ou Custom Auth
Ce que détient votre appUn Page access tokenVotre clé API Unipile et l'account_id de l'utilisateur
App Meta et App ReviewUne app Meta, plus l'App Review pour servir des Pages qui ne vous appartiennent pasNi app Meta ni App Review de votre côté
Qui écrit en premierLa personne écrit à la PageL'utilisateur peut répondre ou démarrer une nouvelle conversation
Événements en temps réelWebhooks Messenger sur votre app MetaMessages nouveaux, modifiés et supprimés, accusés de lecture et de remise, réactions, mises à jour des chats
Compte
PageUne Page Facebook ou un compte Instagram professionnel
Compte personnelLe compte Facebook personnel de l'utilisateur
Qui connecte
PageUn administrateur de Page, via Facebook Login for Business
Compte personnelLe propriétaire du compte, via Hosted Auth ou Custom Auth
Ce que détient votre app
PageUn Page access token
Compte personnelVotre clé API Unipile et l'account_id de l'utilisateur
App Meta et App Review
PageUne app Meta, plus l'App Review pour servir des Pages qui ne vous appartiennent pas
Compte personnelNi app Meta ni App Review de votre côté
Qui écrit en premier
PageLa personne écrit à la Page
Compte personnelL'utilisateur peut répondre ou démarrer une nouvelle conversation
Événements en temps réel
PageWebhooks Messenger sur votre app Meta
Compte personnelMessages nouveaux, modifiés et supprimés, accusés de lecture et de remise, réactions, mises à jour des chats

Endpoints de messagerie

  • Lister les chats et les messages, discussions de groupe comprises
  • Démarrer une conversation, envoyer des messages et des pièces jointes
  • Modifier, supprimer et transférer des messages
  • Ajouter et retirer des réactions, marquer comme lu, accusés de lecture
  • Mettre en sourdine et archiver des chats

Non pris en charge

  • Épingler un message
  • Stories

Le même compte connecté expose aussi ses posts, commentaires et réactions. Ces endpoints sont résumés dans le guide de l'API Facebook.

Code

Lire les chats et envoyer un message depuis un compte personnel

Deux appels couvrent la boucle de base : lister les chats du compte connecté, puis envoyer un message dans l'un d'eux. Les requêtes partent vers https://api.unipile.com avec votre clé API dans l'en-tête 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 · message envoyé depuis le compte de l'utilisateur

Les messages entrants arrivent sur votre webhook sous forme d'événements message.new, sans polling. Le SDK Node.js expose les mêmes appels sous les noms getChatsList et sendMessage. Configuration complète dans le quickstart Facebook. Autres langages, pièces jointes et réponses de Page dans envoyer un message avec l'API Facebook Messenger.

À quoi ressemblent les deux appels dans votre app

1Lister les chatsGET/chats
Votre app Connecté
FacebookAnna Lee, compte personnel
Tom ReyesBonjour Anna, on peut décaler notre appel à jeudi ?
Maya ChenOn se voit au marché samedi
Sam PatelMerci pour les photos
Chat sélectionné
chat_id
{CHAT_ID}
name
Tom Reyes
last message
Bonjour Anna, on peut décaler…
timestamp
09:12
2Envoyer la réponsePOST/messages/send
Votre app Connecté
Tom ReyesFacebookAnna Lee, compte personnel
Bonjour Anna, on peut décaler notre appel à jeudi ?09:12
Jeudi 10 h, ça me va.09:14 · Vu
Requête
chat_id
{CHAT_ID}
text
Jeudi 10 h, ça me va…
response
200 OK
Cas d'usage

Cas d'usage légitimes et règles de Meta que vos utilisateurs respectent toujours

Un compte personnel connecté convient aux produits où un professionnel échange avec ses propres contacts depuis son propre compte : CRM, helpdesks, assistants IA qui rédigent des réponses validées par l'utilisateur et outils de conseillers. Il n'est pas fait pour la prospection à froid ni les bots entièrement automatisés.

CRM

Un commercial retrouve ses conversations Messenger sur la bonne fiche contact, à côté des emails et des appels. Voir l'intégration CRM.

Helpdesk et inbox multicanale

Messenger rejoint la même inbox que LinkedIn, WhatsApp, Instagram et Telegram, avec un seul modèle de données.

Assistant IA

Un agent rédige une réponse à partir de l'historique de la conversation, et l'utilisateur la relit avant l'envoi.

Suivi client des conseillers

Un consultant ou un agent suit les clients avec qui il échange déjà sur Messenger.

Les conditions de Meta s'appliquent toujours

Un compte connecté reste soumis aux conditions d'utilisation de Meta. Concevez votre produit pour des conversations que l'utilisateur aurait de toute façon : les messages non sollicités et l'automatisation non autorisée peuvent conduire Meta à restreindre le compte.

Vous construisez une inbox unique pour plusieurs réseaux ? Découvrez comment fonctionne une API de messagerie unifiée.

Graph API

API Facebook pour comptes personnels : ce que la Graph API permet encore

Une intégration de compte personnel via la Graph API de Meta reste limitée. Elle peut identifier la personne et lire quelques champs de profil, mais elle ne peut ni ouvrir sa boîte Messenger, ni publier en son nom.

L'identification fonctionne toujours. Avec Facebook Login, la personne accorde à votre app un user access token. La permission public_profile lit les champs du profil public par défaut et email lit son adresse email principale. Les autres permissions utilisateur, comme user_posts pour les posts publiés par un utilisateur sur son journal, sont réservées par Meta à une courte liste d'usages approuvés. Aucune permission utilisateur ne donne accès aux conversations Messenger de la personne. La délivrance de ces tokens est détaillée dans notre guide sur l'access token de l'API Facebook.

La publication sur un profil a pris fin en 2018. Meta a supprimé la permission publish_actions le 24 avril 2018, et les apps déjà approuvées ont pu continuer à l'utiliser jusqu'au 1er août 2018. Depuis, les apps construites sur la Graph API ne publient que sur des Pages, ce qui explique pourquoi les outils de planification ont cessé de proposer les profils personnels.

Un compte connecté couvre les deux côtés. Quand le propriétaire connecte son compte personnel via Unipile, votre app lit et envoie ses messages Messenger, et crée, modifie et supprime ses posts, commentaires et réactions. Le volet publication est détaillé dans notre guide de l'API Facebook post.

ActionGraph API avec un user access tokenCompte personnel connecté via Unipile
Lire les messages Messenger de l'utilisateurNon, aucune permission utilisateur ne couvre la boîte de réceptionOui, chats, messages et pièces jointes
Publier sur le profil de l'utilisateurNon, publish_actions a été supprimée en 2018Oui, créer, modifier et supprimer des posts
Répondre aux messagesNon, la Messenger Platform sert les PagesOui, répondre ou lancer une conversation
Lire les messages Messenger de l'utilisateur
Graph APINon, aucune permission utilisateur ne couvre la boîte de réception
Compte connectéOui, chats, messages et pièces jointes
Publier sur le profil de l'utilisateur
Graph APINon, publish_actions a été supprimée en 2018
Compte connectéOui, créer, modifier et supprimer des posts
Répondre aux messages
Graph APINon, la Messenger Platform sert les Pages
Compte connectéOui, répondre ou lancer une conversation

Sources : la référence des permissions de Meta et le changelog de la Graph API du 24 avril 2018. Dernière vérification : 17 novembre 2026.

Connectez des comptes Facebook personnels à votre produit

La Messenger Platform de Meta reste le bon outil pour une entreprise qui répond aux gens sur sa propre Page. Quand votre produit a besoin d'une API Facebook Messenger, compte personnel compris, laissez vos utilisateurs connecter leur propre compte Facebook et utilisez une seule API pour Facebook et vos autres canaux.

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. Lire notre page Digital Markets Act

Référence des endpoints

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

Les messages ne sont qu'une partie du tableau. Parcourez tous les endpoints Facebook disponibles avec Unipile, des chats aux posts, ou lisez le guide complet de l'API Facebook pour comparer les API officielles de Meta et les comptes connectés.

FAQ sur l'API pour compte Facebook personnel

Réponses rapides sur les profils, l'historique des messages, les premiers messages, les réactions, les Pages, les chatbots, la Graph API et les bibliothèques non officielles.

Pas la Messenger Platform de Meta : elle sert les Pages Facebook et les comptes Instagram professionnels. Un profil personnel peut être utilisé quand son propriétaire le connecte à votre app via l'authentification hébergée d'Unipile, et le propriétaire reste soumis aux conditions de Meta.

Oui, une fois le compte connecté. L'API liste les chats et les messages du compte personnel connecté, discussions de groupe et pièces jointes comprises, et les webhooks envoient à votre app les messages nouveaux, modifiés et supprimés.

Oui. Un compte personnel connecté peut démarrer une nouvelle conversation comme répondre. Limitez-vous aux personnes que l'utilisateur connaît ou avec qui il travaille : les messages non sollicités vont à l'encontre des conditions de Meta et peuvent entraîner la restriction du compte.

Oui. Vous pouvez lister, ajouter et retirer des réactions sur les messages, et les nouvelles réactions arrivent dans votre app via l'événement webhook message.reaction.new.

Oui, pour les Pages que gère l'utilisateur connecté. Votre app peut lire les messages de la Page, y répondre et publier en tant que Page. Une Page ne peut ni démarrer de conversation ni supprimer ses messages : ses conversations commencent donc toujours par un message de la personne.

La Messenger Platform de Meta, et les outils de chatbot qui s'appuient sur elle, ne fonctionnent qu'avec des Pages. Avec un compte personnel connecté, gardez un humain dans la boucle : une IA rédige une réponse et l'utilisateur la valide. Des messages entièrement automatisés ou non sollicités peuvent entraîner la restriction du compte.

En partie. La Graph API de Meta accepte encore un profil personnel pour Facebook Login et quelques permissions de lecture, mais elle ne peut pas ouvrir la boîte Messenger de la personne et ne publie plus sur les profils depuis la suppression de publish_actions en 2018. Pour une intégration de compte personnel Facebook qui couvre messages et posts, le propriétaire connecte le compte via Unipile et votre app travaille avec une seule API REST.

Oui. Des bibliothèques open source qui se connectent à messenger.com avec la session de l'utilisateur existent, mais elles sont non officielles et ne sont pas prises en charge par Meta. Elles peuvent cesser de fonctionner dès que Facebook modifie son interface, et le compte qui les utilise peut être restreint au titre des conditions de Meta. Pour une app en production, utilisez la Messenger Platform pour les Pages que vous gérez, ou une API maintenue où l'utilisateur connecte son propre compte et reste soumis aux conditions de Meta.

Pas via leurs intégrations Facebook Messenger : elles reposent sur la Messenger Platform de Meta, qui ne sert que les Pages. Avec un compte personnel connecté via Unipile, le message part de votre propre workflow, par exemple une étape HTTP qui appelle l'endpoint d'envoi de message pour ce compte.

Non. Unipile est une entreprise indépendante : ce n'est pas un Meta Partner, et Unipile n'est ni soutenu, ni sponsorisé, ni approuvé par Meta. Connecter un compte Messenger personnel via Unipile n'est pas une intégration officielle de la Messenger Platform. Facebook et Messenger sont des marques de Meta Platforms, Inc.

Non. Le propriétaire du compte se connecte via l'authentification hébergée d'Unipile : vous n'avez donc ni app Meta à enregistrer, ni pages_messaging à demander, ni App Review à passer de votre côté. Il en va de même pour les Pages que gère cet utilisateur.

Unipile est conçu dans l'esprit du Digital Markets Act. Chaque personne connecte son propre compte Facebook, les messages sont lus et envoyés en son nom, et Unipile ne stocke pas de profils utilisateurs. Tous les détails sur notre page Digital Markets Act.

Oui. Un compte personnel connecté reste un compte Facebook soumis aux conditions de Meta. Tenez-vous-en à des usages légitimes comme répondre à des clients, synchroniser des conversations dans un CRM ou aider un utilisateur à gérer sa propre boîte de réception ; les envois en masse ou non sollicités peuvent entraîner la restriction du compte.

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

Parler à un expert