
Guides d'intégration
Guide de l'API LinkedIn
Guide de l'API Email
Guide de l'API WhatsApp
Contacter l'équipe commerciale
Les règles de la Send API de Meta en 2026, puis un seul appel REST pour envoyer depuis les comptes de vos utilisateurs.
chats
POSTmessages/send
POSTchats/send
200 OK
Il existe deux façons d'envoyer un message Facebook Messenger par API. La Send API de Meta envoie depuis une Page Facebook, avec un Page access token, uniquement aux personnes qui ont écrit à la Page au cours des dernières 24 heures. Une API unifiée comme Unipile envoie depuis le compte connecté de votre utilisateur (un compte personnel ou une Page qu'il gère) avec un seul appel REST : POST /v2/{account_id}/chats/{chat_id}/messages/send.
Envoyer un message Messenger en trois étapes
Connecter. Votre utilisateur connecte son compte Facebook ou sa Page via Hosted Auth. Ni app Meta, ni App Review.
Envoyer. Appelez POST /v2/{account_id}/chats/{chat_id}/messages/send avec votre X-API-KEY et un text.
Écouter. Le webhook message.new confirme l'envoi et remonte les réponses.
Code en quatre langages : envoyer depuis un compte connecté. Référence : doc Unipile V2 Send messages.
DémarrerLa Send API de Meta agit pour une Page que gère votre app. Unipile agit pour le compte que votre utilisateur final a connecté.
| Critère | Send API de Meta | API Unipile |
|---|---|---|
| Expéditeur | Une Page Facebook | Le compte personnel de l'utilisateur, ou une Page qu'il gère |
| Mise en place | App Meta, Page token avec pages_messaging, App Review pour servir les Pages d'autres entreprises | Clé API et un account_id issu de Hosted Auth, sans app Meta |
| Qui écrit en premier | Toujours la personne | Un compte personnel peut le faire ; une Page ne fait que répondre |
| Fenêtre | 24 heures, jusqu'à 7 jours après une publicité Click-to-Messenger | Pas de fenêtre Send API ; Facebook peut refuser un destinataire |
pages_messaging, App Review pour servir les Pages d'autres entreprisesaccount_id issu de Hosted Auth, sans app MetaUn bot pour votre propre Page relève de la voie Meta ; un CRM, un helpdesk ou un agent IA dans les conversations de vos clients a besoin d'un compte connecté. Pour la carte complète, voyez comment les API Facebook s'articulent.
La voie officielle de Meta est la Send API de la Messenger Platform : POST https://graph.facebook.com/v27.0/{PAGE-ID}/messages avec un Page access token qui détient pages_messaging, un recipient.id, un messaging_type et un objet message. Elle ne répond qu'aux personnes qui ont écrit à votre Page.
Ajoutez Messenger, connectez la Page.
Avec pages_messaging ; l'App Review pour servir d'autres entreprises. Voir notre guide token d'accès de l'API Facebook.
Adressez-vous à la personne par son PSID (ID propre à la Page), lu dans le webhook messages.
graph.facebook.com/v27.0/{PAGE-ID}/messages
200 OK
RESPONSE : une réponse, dans la fenêtre.UPDATE : un message que vous initiez, dans la fenêtre.MESSAGE_TAG : hors fenêtre, avec un tag et un contenu non promotionnel.D'où vient le PSID
Dans l'événement messages, sender.id est le PSID de la personne et recipient.id l'ID de votre Page. Copiez la requête depuis les onglets Meta cURL, Node.js, Python et PHP du bloc de code ci-dessous.
Sources : la documentation Send a Message et événement de webhook messages de Meta. Dernière vérification : 17 novembre 2026.
La Send API n'écrit qu'aux personnes qui ont écrit à la Page, pendant 24 heures après leur dernier message, ou jusqu'à 7 jours après une publicité Click-to-Messenger. Au-delà, HUMAN_AGENT couvre une réponse humaine sous 7 jours, et trois tags de mise à jour échouent avec l'erreur 100 depuis le 27 avril 2026.
Cela ouvre la fenêtre standard.
Envoyez avec RESPONSE ou UPDATE.
Tag HUMAN_AGENT, pour une réponse rédigée par une personne.
Attendez un nouveau message.
Les requêtes avec les tags CONFIRMED_EVENT_UPDATE, ACCOUNT_UPDATE ou POST_PURCHASE_UPDATE échouent désormais avec le code d'erreur 100.
Sources : la référence de la Send API et Send a Message de Meta. Dernière vérification : novembre 2026.
Votre utilisateur connecte son compte Facebook une seule fois et vous obtenez un account_id. Listez ses chats, puis envoyez dans un chat_id. Les requêtes partent vers https://api.unipile.com avec votre clé dans l'en-tête X-API-KEY, via l'API Facebook Messenger d'Unipile. Les onglets Meta envoient la même réponse avec la Send API de Meta, depuis une Page que vous gérez.
L'utilisateur se connecte sur une page Hosted Auth. Détails dans notre guide de l'API Messenger pour les comptes personnels.
GET /v2/{account_id}/chats renvoie jusqu'à 100 chats par page.
Un seul POST avec un champ text.
# 1. List chats
curl --request GET \
--url 'https://api.unipile.com/v2/acc_123456789/chats?limit=20' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json'
# 2. Send a message
curl --request POST \
--url https://api.unipile.com/v2/acc_123456789/chats/CHAT_ID/messages/send \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{ "text": "Thanks, your order ships today." }'
// npm i @unipile/sdk
import { UnipileMessaging } from '@unipile/sdk';
const request_options = {
baseUrl: 'https://api.unipile.com',
headers: { 'X-API-KEY': 'YOUR_API_KEY' },
throwOnError: true,
};
const messagingApi = new UnipileMessaging();
// 1. List chats
const chats = await messagingApi.getChatsList({
...request_options,
path: { account_id: 'acc_123456789' },
query: { limit: 20 },
});
// 2. Send a message
await messagingApi.sendMessage({
...request_options,
path: { account_id: 'acc_123456789', chat_id: 'CHAT_ID' },
body: { text: 'Thanks, your order ships today.' },
});
import unipile
configuration = unipile.Configuration()
configuration.api_key["apiKey"] = "YOUR_API_KEY"
api_client = unipile.ApiClient(configuration)
messaging_api = unipile.MessagingApi(api_client)
# 1. List chats
chats = messaging_api.get_chats_list("acc_123456789", limit=20)
# 2. Send a message
messaging_api.send_message(
"CHAT_ID",
"acc_123456789",
{"text": "Thanks, your order ships today."},
)
<?php
$base = 'https://api.unipile.com/v2/acc_123456789';
$headers = ['X-API-KEY: YOUR_API_KEY', 'accept: application/json'];
// 1. List chats
$ch = curl_init("$base/chats?limit=20");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => true,
]);
$chats = json_decode(curl_exec($ch), true);
curl_close($ch);
// 2. Send a message
$ch = curl_init("$base/chats/CHAT_ID/messages/send");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array_merge($headers, ['content-type: application/json']),
CURLOPT_POSTFIELDS => json_encode(['text' => 'Thanks, your order ships today.']),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true);
curl_close($ch);
# Meta Send API: reply to a person who messaged your Page
curl -X POST \
"https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"recipient": { "id": "PSID" },
"messaging_type": "RESPONSE",
"message": { "text": "Thanks, your order ships today." }
}'
// Node.js 18+: built-in fetch, no SDK
const url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages'
+ '?access_token=' + process.env.PAGE_ACCESS_TOKEN;
const res = await fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
recipient: { id: 'PSID' },
messaging_type: 'RESPONSE',
message: { text: 'Thanks, your order ships today.' },
}),
});
const data = await res.json(); // { recipient_id, message_id }
# pip install requests
import requests
resp = requests.post(
"https://graph.facebook.com/v27.0/PAGE_ID/messages",
params={"access_token": "PAGE_ACCESS_TOKEN"},
json={
"recipient": {"id": "PSID"},
"messaging_type": "RESPONSE",
"message": {"text": "Thanks, your order ships today."},
},
)
print(resp.json()) # {"recipient_id": "...", "message_id": "..."}
<?php
$url = 'https://graph.facebook.com/v27.0/PAGE_ID/messages?access_token=PAGE_ACCESS_TOKEN';
$payload = [
'recipient' => ['id' => 'PSID'],
'messaging_type' => 'RESPONSE',
'message' => ['text' => 'Thanks, your order ships today.'],
];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
]);
$sent = json_decode(curl_exec($ch), true); // recipient_id, message_id
curl_close($ch);
Les quatre premiers onglets appellent Unipile pour un compte connecté ; la même requête fonctionne pour LinkedIn, WhatsApp, Instagram et Telegram. Les onglets Meta appellent la Send API de Meta pour votre propre Page, avec un Page access token et le PSID de la personne (comment obtenir le PSID). Références : Unipile Facebook, Send messages et Meta Send a Message (v27.0, vérifié le 17 novembre 2026).
Quand il n'existe pas encore de chat, appelez POST /v2/{account_id}/chats/send avec l'ID de la personne dans users_ids et votre text. La Send API de Meta ne permet pas de le faire.
https://api.unipile.comSDK : startChat (Node.js), start_chat (Python)
200 OK
La réponse renvoie le nouveau chat_id et le message_id.
Si Facebook n'autorise pas le compte à écrire à cette personne, la requête échoue avec provider/access_restricted.
Une Page ne peut ni démarrer de conversation (501 api/not_implemented) ni supprimer ses messages.
Une Page que gère l'utilisateur répond via le même account_id : listez les inbox, ouvrez l'inbox de la Page, puis envoyez avec un ID de chat de Page. Le fonctionnement des Pages et de leurs tokens côté Meta est décrit dans notre guide de l'API Pages Facebook.
{chat_id}PAGE_<page_id>_<thread_key>La liste générale des chats ne renvoie que les chats personnels. Le préfixe PAGE_ fait agir Unipile en tant que Page. Détails dans la documentation Facebook Pages.
Ajoutez un tableau attachments au même endpoint d'envoi. Pour les gros fichiers, utilisez le multipart.
Gros fichier : multipart/form-data
200 OK
Chats chiffrés. Dans les chats personnels chiffrés de bout en bout, chaque fichier est envoyé dans un message distinct.
Équivalent chez Meta. La Send API accepte un objet attachment avec un type et une url, jusqu'à 30 images par envoi.
Un 200 signifie que Facebook a accepté le message, pas qu'il a été remis. La remise est confirmée par l'événement webhook message.new, qui apporte aussi les réponses.
Il se déclenche pour les messages envoyés et reçus ; voir is_sender.
Routez les événements de Page grâce au préfixe PAGE_<page_id>_ de leur chat_id, qui peut différer de celui de l'API. Configuration dans Configure a webhook.
Côté Meta, un bot de Page construit sur la Send API a besoin de son propre webhook Messenger. C'est aussi là que vous lisez le PSID avant de répondre.
Source : Messenger webhooks de Meta. Dernière vérification : 17 novembre 2026.
La plupart des erreurs d'envoi viennent d'une règle : une nouvelle tentative échoue de nouveau. Un token sans pages_messaging bloque tous les appels à la Send API.
| Erreur | Signification | Solution |
|---|---|---|
| Meta 100 | Paramètre invalide, ou tag retiré le 27 avril 2026 | Vérifiez le PSID, retirez le tag |
| Meta 10 / 2018278 | Message envoyé en dehors de la fenêtre autorisée | Attendez un nouveau message, ou envoyez une réponse HUMAN_AGENT |
| Meta 200 / 2018028 | Impossible d'écrire à des personnes qui ne sont ni admins, ni développeurs, ni testeurs de l'app : pages_messaging pas encore approuvée | Terminez l'App Review, testez avec les rôles de l'app en attendant |
| Meta 551 | Cette personne ne reçoit pas vos messages pour le moment | Ne réessayez pas |
| Meta 613 | Rate limit dépassé | Espacez les envois |
Unipile provider/access_restricted | Facebook refuse ce destinataire pour ce compte | Ne pas réessayer |
Unipile 403 api/insufficient_permissions | Page non activée sur le compte | Activez-la lors de la reconnexion |
Unipile 501 api/not_implemented | Une Page a démarré un chat ou supprimé un message | Répondez dans un chat existant |
HUMAN_AGENTpages_messaging pas encore approuvéeSources : les codes d'erreur Messenger de Meta et les réponses d'erreur d'Unipile. Dernière vérification : 17 novembre 2026.
Chaque utilisateur envoie depuis son propre compte
Unipile est une entreprise indépendante : ce n'est ni une app officielle de Meta, ni un Meta Partner. Unipile agit pour le compte d'utilisateurs authentifiés, qui restent soumis aux conditions de Meta. Réservez son usage au support client, au CRM et aux conversations directes.
Envoyez votre premier message
La Send API de Meta convient à un bot sur votre propre Page. Pour envoyer des messages avec l'API Facebook Messenger depuis les comptes de vos utilisateurs, connectez-les via Unipile.
Chaque utilisateur connecte son propre compte, sans stockage de profils. Unipile n'est pas partenaire Meta. Notre approche du Digital Markets Act
Tous les endpoints de l'API Facebook au même endroit
Les messages n'en sont qu'une partie. Consultez tous les endpoints Facebook disponibles avec Unipile, des posts et commentaires aux profils et webhooks, ou lisez le guide complet de l'API Facebook.
Réponses rapides sur l'envoi de messages Messenger par API.
Non. La Send API n'atteint que les personnes qui ont écrit à votre Page, dans la fenêtre de messagerie, et une Page n'écrit jamais en premier. Une nouvelle conversation doit partir d'un compte personnel connecté, par exemple avec POST /v2/{account_id}/chats/send d'Unipile.
Meta ne propose aucun SDK Python officiel pour la Send API : faites un POST vers /{PAGE-ID}/messages avec requests, comme dans l'onglet Meta Python ci-dessus. Unipile fournit un SDK Python, importé sous le nom unipile, avec get_chats_list et send_message.
Envoyez un POST HTTP avec cURL ou Guzzle : vers /{PAGE-ID}/messages sur la Graph API avec un Page access token (onglet Meta PHP), ou vers /v2/{account_id}/chats/{chat_id}/messages/send chez Unipile avec votre X-API-KEY (onglet PHP).
Installez @unipile/sdk et appelez sendMessage avec l'account_id, le chat_id et le text, comme dans l'onglet Node.js ci-dessus. Pour la Send API de Meta, faites un POST vers /{PAGE-ID}/messages avec fetch, comme dans l'onglet Meta Node.js.
Avec la Send API : une fenêtre fermée (erreur 10, sous-code 2018278), un tag retiré le 27 avril 2026 (erreur 100), un token sans pages_messaging approuvée (erreur 200, sous-code 2018028) ou une personne qui bloque vos messages (erreur 551). Avec Unipile : provider/access_restricted quand Facebook refuse le destinataire, ou une Page qui tente de démarrer une conversation.
Pour un bot de Page sur la plateforme de Meta, votre endpoint répond à la vérification GET en renvoyant hub.challenge, contrôle la signature X-Hub-Signature-256 avec votre App Secret et s'abonne à messages ; le sender.id de chaque événement est le PSID auquel vous répondez. Avec Unipile, vous enregistrez une seule URL et recevez les événements message.new de tous les comptes connectés.
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. Les onglets Meta de cette page appellent la Send API publique de Meta ; les autres onglets appellent l'API d'Unipile. Facebook et Messenger sont des marques de Meta Platforms, Inc.
Non. L'app Meta, le Page token et l'App Review ne concernent que la voie Send API. Avec Unipile, vos utilisateurs connectent leur propre compte Facebook, ou les Pages qu'ils gèrent, via l'authentification hébergée, et vous envoyez avec un account_id et votre clé API.
Unipile est conçu dans l'esprit du Digital Markets Act : chaque utilisateur connecte son propre compte et les messages partent en son nom, dans ses propres conversations, sans qu'Unipile stocke de profils utilisateurs. Tous les détails sur notre page Digital Markets Act.
Oui. Chaque compte connecté reste soumis aux conditions d'utilisation de Meta. Envoyez des messages pour des besoins légitimes comme les réponses au support, les relances CRM et les conversations attendues ; les envois massifs non sollicités et le spam peuvent entraîner la restriction du compte.
Encore des questions ? Notre équipe est là pour vous aider.
Parler à un expert