FR
Tutoriel

Envoyer un message avec l'API Facebook Messenger : tutoriel Node.js, Python et PHP

Les règles de la Send API de Meta en 2026, puis un seul appel REST pour envoyer depuis les comptes de vos utilisateurs.

Votre app En ligne
FacebookAnna LeePersonnel FacebookNorthwind BakeryPage
Chat personnel
Tom BeckerDe Anna Lee
On peut décaler la démo ?
Jeudi 10 h, ça me va.
Vu
Chat de Page
Maya RossÀ Northwind Bakery
Vous livrez le dimanche ?
Oui, de 9 h à midi.
Distribué
GETchats POSTmessages/send POSTchats/send 200 OK
Réponse courte

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.

POST/{PAGE-ID}/messagesMeta : répondre en tant que Page
POST/v2/{account_id}/chats/{chat_id}/messages/sendUnipile : répondre dans un chat existant
POST/v2/{account_id}/chats/sendUnipile : écrire en premier
Avec Unipile

Envoyer un message Messenger en trois étapes

  1. 1

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

  2. 2

    Envoyer. Appelez POST /v2/{account_id}/chats/{chat_id}/messages/send avec votre X-API-KEY et un text.

  3. 3

    Écouter. Le webhook message.new confirme l'envoi et remonte les réponses.

Choisir une voie

Deux façons d'envoyer un message Messenger par API

La 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èreSend API de MetaAPI Unipile
ExpéditeurUne Page FacebookLe compte personnel de l'utilisateur, ou une Page qu'il gère
Mise en placeApp Meta, Page token avec pages_messaging, App Review pour servir les Pages d'autres entreprisesClé API et un account_id issu de Hosted Auth, sans app Meta
Qui écrit en premierToujours la personneUn compte personnel peut le faire ; une Page ne fait que répondre
Fenêtre24 heures, jusqu'à 7 jours après une publicité Click-to-MessengerPas de fenêtre Send API ; Facebook peut refuser un destinataire
Expéditeur
Send API de MetaUne Page Facebook
API UnipileLe compte personnel de l'utilisateur, ou une Page qu'il gère
Mise en place
Send API de MetaApp Meta, Page token avec pages_messaging, App Review pour servir les Pages d'autres entreprises
API UnipileClé API et un account_id issu de Hosted Auth, sans app Meta
Qui écrit en premier
Send API de MetaToujours la personne
API UnipileUn compte personnel peut le faire ; une Page ne fait que répondre
Fenêtre
Send API de Meta24 heures, jusqu'à 7 jours après une publicité Click-to-Messenger
API UnipilePas de fenêtre Send API ; Facebook peut refuser un destinataire

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

Send API de Meta

Comment envoyer un message avec la Graph API de Facebook (Send API)

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.

1

Créer une app Meta et lier une Page

Ajoutez Messenger, connectez la Page.

2

Obtenir un Page access token

Avec pages_messaging ; l'App Review pour servir d'autres entreprises. Voir notre guide token d'accès de l'API Facebook.

3

Envoyer la requête

Adressez-vous à la personne par son PSID (ID propre à la Page), lu dans le webhook messages.

Facebook Requête Send API
access_tokenPage access token
recipient.idLe PSID de la personne
messaging_typeRESPONSE, UPDATE ou MESSAGE_TAG
message.text"Hello, world!"
responserecipient_id, message_id
POST 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

1Entrant

Une personne écrit à votre Page

Messenger
2POST

Meta appelle votre webhook

événement messages
3PSID

Lisez l'ID de l'expéditeur

messaging[0].sender.id
4POST

Répondez avec la Send API

recipient.id = 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.

Règles

La fenêtre de 24 heures de Messenger et les message tags en 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.

Début

La personne écrit

Cela ouvre la fenêtre standard.

0 à 24 h

Fenêtre ouverte

Envoyez avec RESPONSE ou UPDATE.

Jusqu'à 7 jours

Agent humain

Tag HUMAN_AGENT, pour une réponse rédigée par une personne.

Ensuite

Fenêtre fermée

Attendez un nouveau message.

Retirés le 27 avril 2026

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.

Tutoriel

Envoyer un message Facebook Messenger depuis un compte connecté (Node.js, Python, PHP, cURL)

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.

1

Connecter le compte

L'utilisateur se connecte sur une page Hosted Auth. Détails dans notre guide de l'API Messenger pour les comptes personnels.

2

Lister les chats

GET /v2/{account_id}/chats renvoie jusqu'à 100 chats par page.

3

Envoyer le message

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);
200 OK · { "object": "MessageSent", "message_id": "..." }
200 OK · { "recipient_id": "PAGE-SCOPED-ID", "message_id": "AG5Hz2U..." }

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

Premier message

Comment démarrer une nouvelle conversation Messenger par API

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.

URL de base https://api.unipile.com
POST/v2/{account_id}/chats/sendStart a Chat
users_idsID d'une personne ou d'une Page
text"Bonjour Tom, petite question"
attachmentsFichiers facultatifs
SDK : 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.

Limites de l'inbox d'une Page

Une Page ne peut ni démarrer de conversation (501 api/not_implemented) ni supprimer ses messages.

Pages

Comment répondre en tant que Page Facebook par API

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.

Facebook Inbox personnelle · INBOX
Tom BeckerJeudi 10 h, ça me va.Personnel
chat_id: {chat_id}
Facebook Inbox de Page · PAGE_<page_id>_INBOX
Maya RossVous livrez le dimanche ?Page
chat_id: PAGE_<page_id>_<thread_key>
GET/v2/{account_id}/inboxesListe les inbox de Page
GET/v2/{account_id}/inboxes/{inbox_id}/chatsListe les chats de la Page
POST/v2/{account_id}/chats/PAGE_1357020157484056_100001234567890/messages/sendRépond en tant que Page

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.

Pièces jointes

Envoyer des images et des fichiers dans un chat Messenger

Ajoutez un tableau attachments au même endpoint d'envoi. Pour les gros fichiers, utilisez le multipart.

POST/v2/{account_id}/chats/{chat_id}/messages/sendSend a Message
textLégende facultative, peut valoir ""
contentLe fichier encodé en base64
content_type"image/png"
filename"image.png"
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.

Temps réel

Confirmer la remise et recevoir les réponses avec les webhooks

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.

1POST

Votre app envoie

messages/send
2Accepté

Unipile répond

200 MessageSent
3Confirmé

Webhook : envoyé

message.new
4Accusés

Remis, puis lu

message.receipt.delivery message.receipt.read
Facebook Événement message.new
type"message.new"
account_idLe compte connecté
payloadUn objet Message : id, chat_id, sender_id, text, timestamp, is_sender

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.

Facebook Webhook Messenger de Meta
VérificationGET avec hub.mode=subscribe et votre hub.verify_token : renvoyez hub.challenge
SignatureX-Hub-Signature-256 : SHA256 du payload avec votre App Secret
Champsmessages, message_deliveries
Réponse200 OK en moins de 5 secondes
Erreurs

Erreurs à l'envoi de messages Messenger

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.

ErreurSignificationSolution
Meta 100Paramètre invalide, ou tag retiré le 27 avril 2026Vérifiez le PSID, retirez le tag
Meta 10 / 2018278Message envoyé en dehors de la fenêtre autoriséeAttendez un nouveau message, ou envoyez une réponse HUMAN_AGENT
Meta 200 / 2018028Impossible d'écrire à des personnes qui ne sont ni admins, ni développeurs, ni testeurs de l'app : pages_messaging pas encore approuvéeTerminez l'App Review, testez avec les rôles de l'app en attendant
Meta 551Cette personne ne reçoit pas vos messages pour le momentNe réessayez pas
Meta 613Rate limit dépasséEspacez les envois
Unipile provider/access_restrictedFacebook refuse ce destinataire pour ce compteNe pas réessayer
Unipile 403 api/insufficient_permissionsPage non activée sur le compteActivez-la lors de la reconnexion
Unipile 501 api/not_implementedUne Page a démarré un chat ou supprimé un messageRépondez dans un chat existant
Meta 100
SignificationParamètre invalide, ou tag retiré le 27 avril 2026
SolutionVérifiez le PSID, retirez le tag
Meta 10 / 2018278
SignificationMessage envoyé en dehors de la fenêtre autorisée
SolutionAttendez un nouveau message, ou envoyez une réponse HUMAN_AGENT
Meta 200 / 2018028
SignificationImpossible d'écrire à des personnes qui ne sont ni admins, ni développeurs, ni testeurs de l'app : pages_messaging pas encore approuvée
SolutionTerminez l'App Review, testez avec les rôles de l'app en attendant
Meta 551
SignificationCette personne ne reçoit pas vos messages pour le moment
SolutionNe réessayez pas
Meta 613
SignificationRate limit dépassé
SolutionEspacez les envois
Unipile provider/access_restricted
SignificationFacebook refuse ce destinataire pour ce compte
SolutionNe pas réessayer
Unipile 403 api/insufficient_permissions
SignificationPage non activée sur le compte
SolutionActivez-la lors de la reconnexion
Unipile 501 api/not_implemented
SignificationUne Page a démarré un chat ou supprimé un message
SolutionRépondez dans un chat existant

Sources : les codes d'erreur Messenger de Meta et les réponses d'erreur d'Unipile. Dernière vérification : 17 novembre 2026.

Conformité

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.

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

FAQ : envoyer un message avec l'API Facebook Messenger

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