API du profil Messenger : message d'accueil, bouton Get Started, brise-glace et menu persistant
Le profil Messenger d'une Page Facebook se définit via /{page-id}/messenger_profile avec un token d'accès de la Page et la permission pages_messaging : POST écrit des propriétés comme get_started, greeting, ice_breakers, persistent_menu et commands, GET les lit avec fields, et DELETE supprime celles nommées dans un tableau fields. Meta autorise 10 appels toutes les 10 minutes par Page, et seules les propriétés envoyées sont écrasées.
easyCoexistence répond aux conversations Messenger d'une Page avec send_social_dm dans la fenêtre de 24 heures, depuis Claude, ChatGPT ou votre propre code, les nouveaux messages étant transmis à votre endpoint dès leur arrivée.
Nombre d'appels de l'API Messenger Profile autorisés par Page dans chaque intervalle de 10 minutes.
Nombre maximal de brise-glace définis par l'API ; si les deux sont définis, ceux de l'API ont la priorité sur le bouton Get Started.
Nombre maximal d'éléments de premier niveau dans un menu persistant ; le titre de chaque élément est limité à 30 caractères.
Durée maximale d'une mise à jour du menu persistant au niveau de la Page ; un menu défini pour une personne se met à jour en temps réel.
Texte d'accueil, dont la référence de Meta indique qu'il ne fonctionne plus sur Messenger pour Android et iOS.
Que contient le profil Messenger ?
Les paramètres dont part l'expérience Messenger d'une Page. L'API Messenger Profile de Meta liste ces propriétés, chacune définie et lue sur le même endpoint ; en mode Development, les paramètres ne sont visibles que pour les personnes ayant un rôle sur l'application :
Comment lire, définir et supprimer les propriétés ?
Avec trois méthodes sur un même endpoint, appelées avec le token de la Page. POST prend un corps JSON de propriétés et n'écrase que celles qu'il nomme, GET prend fields sous forme de liste séparée par des virgules, et DELETE prend un corps JSON dont le tableau fields désigne ce qu'il faut supprimer ; POST et DELETE renvoient result success. Définir un bouton Get Started et un menu en un seul appel :
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Comment fonctionne le bouton Get Started ?
Il se trouve sur l'écran d'accueil, qui affiche le nom de la Page, sa photo de profil, sa photo de couverture et le délai de réponse habituel de l'entreprise. Un appui envoie Get Started dans la conversation, transmet get_started.payload à l'application sous forme d'événement messaging_postbacks et ouvre la fenêtre de messagerie standard. Meta précise que le bouton n'est pas pris en charge lorsque Messenger s'exécute dans le navigateur intégré de l'application Facebook, et qu'un menu persistant nécessite qu'il soit défini au préalable.
Le message d'accueil fonctionne-t-il encore ?
Pas sur les téléphones. La référence de Meta est désormais intitulée « [Deprecated] Greeting Text » : la fonctionnalité ne fonctionne plus sur Messenger pour Android et iOS, et même si l'API peut encore accepter la propriété greeting, les clients ne la verront pas, c'est pourquoi Meta demande aux développeurs de l'éviter. Tel que documenté, greeting contient un texte par langue, avec default obligatoire, jusqu'à 160 caractères, personnalisable avec {{user_first_name}}, {{user_last_name}} ou {{user_full_name}}, et sa définition nécessite le rôle d'administrateur de la Page.
Comment fonctionnent les brise-glace ?
Ils proposent jusqu'à 4 questions qu'une personne peut toucher pour ouvrir une conversation ; la question est publiée dans le fil comme si la personne l'avait posée, et son payload revient sous forme d'événement postback. Depuis avril 2022, ils sont localisés : chaque objet de ice_breakers contient call_to_actions et une langue, une langue par défaut est obligatoire, et un DELETE de ice_breakers supprime tous les brise-glace. Meta classe les éléments qui se disputent une nouvelle conversation :
- Les brise-glace de l'API passent avant le bouton Get Started lorsque les deux sont définis.
- Les deux passent avant les questions personnalisées définies dans la boîte de réception de la Page, dont la modification est désactivée tant que des brise-glace API sont définis.
Comment le menu persistant est-il construit ?
Sous forme de tableau de menus, un par langue avec default obligatoire, contenant chacun jusqu'à 20 call_to_actions de type web_url ou postback. Un titre fait jusqu'à 30 caractères et un payload de postback jusqu'à 1,000, et composer_input_disabled réglé sur true ne laisse que le menu, les boutons et les webviews comme moyens d'interaction. Conditions de Meta avant son affichage :
- Un bouton Get Started déjà défini, et la permission
pages_messaging. - Une Page publiée, et l'application réglée sur public.
- Le rôle d'administrateur de la Page pour la personne qui le définit.
- Messenger v106 ou ultérieure sur iOS ou Android, hors du navigateur intégré de l'application Facebook.
- Les modifications au niveau de la Page peuvent prendre jusqu'à 24 heures ; un menu pour une seule personne, défini via
custom_user_settingsavec un PSID, se met à jour en temps réel.
Que sont les commandes ?
Des mots-clés qu'une personne peut déclencher à tout moment, depuis un menu de commandes à côté de la zone de saisie, en tapant une barre oblique ou un arobase, ou depuis une fenêtre contextuelle lorsqu'elle tape un mot correspondant. Chaque langue contient de 1 à 100 commandes, avec un name de 1 à 32 caractères sans barre oblique initiale et une description de 1 à 64 caractères ; lorsque des commandes sont définies, elles sont prioritaires sur le menu persistant. Les commandes déclenchées parviennent à l'application dans l'événement messages, dans message.commands.
À quoi servent whitelisted_domains et account_linking_url ?
Les deux servent des expériences en dehors de la conversation elle-même. whitelisted_domains liste jusqu'à 50 domaines que la webview de Messenger peut ouvrir pour le SDK Messenger Extensions et le plugin checkbox, chacun servi en HTTPS sous un nom de domaine complet, jamais une adresse IP ni localhost ; sa définition nécessite le rôle d'administrateur de la Page. account_linking_url est le callback HTTPS qui relie le compte Messenger d'une personne à son compte auprès de l'entreprise.
Comment easyCoexistence définit-il le profil Messenger d'une Page ?
Non : aucun outil n'appelle {page-id}/messenger_profile, et les tokens de Page ne sont pas communiqués, donc définir le profil sort du cadre de cette connexion. Les commandes déclenchées par les personnes arrivent dans l'événement messages qu'easyCoexistence transmet et que les automatisations lisent ; les appuis que Meta signale comme événements messaging_postbacks, depuis Get Started, les éléments de menu postback et les brise-glace, ne sont pas transmis, puisque les Pages sont abonnées à feed, messages et mention.
Erreurs courantes
- Définir un menu persistant avant Get Started. Les conditions de Meta incluent un bouton Get Started, donc définissez d'abord get_started.
- Oublier la langue par défaut. Les brise-glace, les menus et les commandes ont chacun besoin d'un objet avec locale réglé sur default comme repli.
- Appeler l'API de profil dans une boucle. Meta autorise 10 appels toutes les 10 minutes par Page, regroupez donc plusieurs propriétés dans un seul POST.
- Attendre qu'une modification de menu soit immédiate. Une mise à jour du menu au niveau de la Page peut prendre jusqu'à 24 heures pour atteindre les personnes.
Définir le profil Messenger ne fait pas partie de ses outils. De US$ 9 à US$ 0.75 par connexion et par mois, le prix baissant à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Un menu persistant peut-il varier d'une personne à l'autre ?
Oui. custom_user_settings avec le PSID de la personne remplace le menu de la Page pour cette personne, se met à jour en temps réel et autorise 10 appels par personne en 10 minutes.
Quelles langues le profil Messenger prend-il en charge ?
Celles de la liste des langues prises en charge par Meta, comme en_GB, pt_BR ou ja_JP, ainsi que default, le repli utilisé lorsqu'aucune langue ne correspond à celle de la personne.
Qui peut modifier le profil Messenger d'une Page ?
Une application disposant d'un token de Page avec la permission pages_messaging. Le menu persistant, le message d'accueil et la liste des domaines nécessitent aussi le rôle d'administrateur de la Page.
Combien coûte easyCoexistence pour une Page Facebook ?
Chaque Page correspond à une connexion : de US$ 9 à US$ 0.75 par connexion et par mois, le prix baissant à mesure que votre nombre de connexions augmente, et les 3 premiers jours sont un essai gratuit.
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