Messenger Send API : envoyer des messages depuis une Page Facebook
Une Page Facebook envoie des messages Messenger avec POST /{page-id}/messages et un token d'accès de Page : le paramètre recipient contient l'identifiant propre à la Page de la personne (PSID), messaging_type vaut RESPONSE ou UPDATE dans la fenêtre de messagerie standard, ou MESSAGE_TAG après celle-ci, et message contient du texte ou une pièce jointe, comme une image, un audio, une vidéo ou un fichier. Meta répond avec le recipient_id et un message_id.
easyCoexistence répond aux DM sur Messenger avec send_social_dm, depuis Claude, ChatGPT ou votre propre code, dans la fenêtre de 24 heures, sous forme de texte ; les médias, quick_replies et templates ne sont pas couverts.
Appels Send API qu'une application peut effectuer par Page pour des messages avec texte, liens, réactions et autocollants.
Appels Send API qu'une application peut effectuer par Page pour des messages contenant de l'audio ou de la vidéo.
Plus grand fichier que la Messenger Platform enregistre pour le réutiliser ; une image importée depuis une URL est limitée à 8 Mo.
Nombre maximal d'images qu'un message peut porter dans son tableau attachments, seul type de média autorisé à cet endroit.
Durée de validité d'un attachment_id enregistré avant que le média doive être à nouveau importé.
Que contient une requête Send API ?
Meta liste six éléments qu'un envoi doit inclure : l'ID de la Page qui envoie, l'ID de la personne destinataire, un token d'accès de Page émis pour cette Page, l'autorisation de la personne, le type de message et le contenu. La requête est un POST en JSON vers /{page-id}/messages ; une réponse à une personne qui vient d'écrire ressemble à ceci :
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Quel ID mettre dans recipient ?
En général le PSID, l'identifiant propre à la Page que Meta attribue à une personne la première fois qu'elle écrit à la Page ; il arrive dans le webhook messages sous la forme sender.id. L'objet recipient accepte d'autres types d'ID dans des cas particuliers :
- id : le PSID, unique pour cette personne et cette Page.
user_ref: pour une personne qui a écrit à la Page via un plugin ou un bouton postback.comment_idoupost_id: pour une réponse privée à un commentaire ou à une publication d'un visiteur.- Les ID de Facebook Login sont propres à l'application et ne fonctionnent pas sur la Messenger Platform.
Quel messaging_type utiliser pour un message ?
Le type indique à Meta pourquoi le message est envoyé, et il détermine quand l'envoi est autorisé. La référence des messages de Page de Meta en liste quatre valeurs :
- RESPONSE : une réponse à un message reçu par la Page, promotionnel ou non, dans la fenêtre de messagerie standard.
- UPDATE : un message que la Page envoie de sa propre initiative, promotionnel ou non, également dans la fenêtre.
MESSAGE_TAG: un message non promotionnel envoyé après la fenêtre, avec une étiquette correspondant à un cas d'usage approuvé.- UTILITY : un message utilitaire construit à partir d'un template approuvé, comme une mise à jour de commande ou de rendez-vous.
Que peut contenir un message ?
Du texte, ou un objet attachment unique avec un type et un payload : les pièces jointes image, audio, vidéo et fichier pointent vers une URL ou un attachment_id enregistré, et les pièces jointes template transportent des messages structurés avec des boutons. Le même endpoint accepte aussi ces paramètres :
- attachments : un tableau d'au plus 30 images, envoyées dans un seul message.
reply_toavec un mid : une réponse à un message précis antérieur, celui de la personne ou de la Page.quick_replies: jusqu'à 13 boutons au-dessus du champ de saisie, chacun avec un titre de 20 caractères au plus.sender_action: un indicateur de saisie, une marque de lecture ou une réaction, envoyé dans une requête distincte du message lui-même.notification_type: REGULAR par défaut, ouSILENT_PUSHouNO_PUSH.
Quelle est la taille maximale des pièces jointes ?
Le guide de Meta sur l'enregistrement des fichiers fixe les limites des médias que la Messenger Platform récupère et conserve : fichiers de 25 Mo au maximum, images de 8 Mo au maximum lorsqu'elles sont importées depuis une URL, audio envoyé avec un Content-Type audio, et vidéo récupérée dans un délai de 75 secondes. Si is_reusable est défini à true, on obtient un attachment_id que seule la Page qui l'a envoyé peut réutiliser, pendant 90 jours ; POST /{page-id}/message_attachments permet d'importer les médias à l'avance.
Quelles sont les limites de débit de Send API ?
Meta les compte par Page et selon le contenu. La référence des messages de Page de Meta les classe sous le code 613 (appels au-delà de la limite de débit), parmi les erreurs d'envoi : ralentissez au lieu de réessayer aussitôt lorsqu'elle apparaît :
- 300 appels par seconde et par Page pour les messages avec texte, liens, réactions et autocollants.
- 10 appels par seconde et par Page pour les messages avec audio ou vidéo.
- Trop de messages dans un même fil peuvent être limités indépendamment.
- Appels à la Messenger API au total : 200 fois le nombre d'utilisateurs engagés, sur une période glissante de 24 heures.
- Au-delà de 40 messages par seconde, la boîte de réception de la Page cesse d'afficher les nouveaux messages et la Page ne peut plus envoyer tant que le volume ne baisse pas.
Quelles erreurs renvoie Send API ?
Le tableau des erreurs Messenger de Meta associe chaque code à un sous-code qui indique la cause. Voici celles que rencontre le plus souvent une Page lorsqu'elle envoie :
- 10 avec 2018278 ou 2534022 : le message est envoyé hors de la fenêtre autorisée.
- 10 avec 2018300 : une autre application contrôle la conversation.
- 100 : paramètre invalide, par exemple un mauvais ID de destinataire ; le sous-code 2018001 signifie qu'aucun utilisateur correspondant n'a été trouvé.
- 551 : la personne n'est pas disponible, par exemple parce qu'elle a bloqué la Page ou désactivé son compte ; 200 avec 1545041 signifie que cette personne n'est pas disponible pour le moment.
- 200 avec 2018028 : l'application ne peut pas écrire à des personnes hors de ses rôles tant que
pages_messagingn'a pas été validé et que l'application n'est pas publiée. - 10904 : les messages sont désactivés pour la Page dans les paramètres.
Comment easyCoexistence envoie-t-il via cette API ?
send_social_dm prend l'account_id, le recipient_id de la personne (c'est le sender.id d'un événement messages transmis) et le texte, puis les envoie vers /{page-id}/messages avec messaging_type RESPONSE. Le résultat est la réponse de Meta avec le message_id ; un envoi refusé renvoie le code d'erreur et le message de Meta. Les médias, les quick_replies, les templates et les sender_action ne font pas partie des outils : send_social_dm envoie du texte.
Erreurs courantes
- Envoyer un indicateur de saisie avec le message. Meta veut sender_action seul avec le destinataire, et le texte ou les templates dans une requête distincte.
- Envoyer une salve de messages à une même personne. Meta peut limiter un seul fil indépendamment des 300 appels par seconde de la Page.
- Envoyer de l'audio ou de la vidéo au rythme du texte. Les messages avec audio ou vidéo sont limités à 10 appels par seconde et par Page.
- Réutiliser un attachment_id vieux de plus de 90 jours. Les ID de pièces jointes enregistrés expirent : importez à nouveau le média pour en obtenir un nouveau.
Les automatisations répondent seules aux nouveaux messages avec un texte fixe ou une réponse IA. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
L'API Send de Messenger est-elle gratuite ?
Oui, pour les messages standard. La présentation de Meta indique que la Messenger Platform est gratuite, donc une Page qui répond aux personnes qui lui ont écrit ne paie rien par message ; les messages marketing sont facturés à l'unité.
Quelle tâche de Page est nécessaire pour envoyer un message ?
La présentation de Messenger par Meta demande un token de Page émis par une personne pouvant effectuer les tâches MESSAGING et MODERATE, avec l'autorisation pages_messaging accordée.
easyCoexistence peut-il répondre avec des images sur Messenger ?
Pas aujourd'hui. send_social_dm envoie du texte, et aucun outil n'envoie de pièce jointe.
Combien coûte easyCoexistence pour une Page Facebook ?
Chaque Page que vous connectez compte pour une connexion, facturée de US$ 9 à US$ 0,75 par connexion et par mois selon le nombre de connexions que vous avez, et les 3 premiers jours sont offerts.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le