La plupart des modèles de message, ainsi que le menu fixe, prennent en charge des boutons permettant d’effectuer différents types d’actions. Ces boutons vous permettent de facilement proposer au destinataire du message différentes actions qu’il peut effectuer en réponse au modèle, comme ouvrir une webview Messenger, démarrer un processus de paiement, envoyer un message de renvoi à votre webhook et plus encore.
Pour les modèles de message, les boutons sont définis par les objets dans la grille buttons
. Pour le menu fixe, ils sont définis par les objets dans la grille call_to_actions
.
Le bouton URL ouvre une page web dans la webview Messenger. Cela vous permet d’enrichir la conversation avec une expérience web, où vous pourrez profiter de toute la flexibilité de développement du web. Vous pourriez, par exemple, afficher la description d’un produit dans la conversation, puis utiliser le bouton URL pour ouvrir la page du produit sur votre site web.
Si le site contient des App Links, le bouton lance l’application native spécifiée.
Le robot d’indexation Facebook doit lire les métatags des App Links pour que la redirection fonctionne. Notez que si vous avez uniquement implémenté les tags dans votre site web, vous pouvez demander une nouvelle récupération avec l’Outil de débug du partage. Une fois que le robot d’indexation a récupéré le site, les nouveaux boutons URL envoyés doivent suivre le comportement associé à la redirection.
Le bouton URL est pris en charge pour une utilisation avec les éléments suivants :
Pour afficher une page web avec le SDK Messenger Extensions activé dans la webview Messenger, vous devez mettre le domaine sur liste blanche, sous-domaine inclus, dans la propriété whitelisted_domains
du profil Messenger de votre bot. Ainsi, seuls les domaines de confiance auront accès aux informations utilisateur disponibles via les fonctions du SDK.
Pour en savoir plus sur les domaines en liste blanche, consultez la référence whitelisted_domains
.
Pour une liste complète des propriétés du bouton, reportez-vous à la Référence sur le bouton URL.
{
"type": "web_url",
"url": "
Le bouton de renvoi envoie un évènement messaging_postbacks
à votre webhook avec la chaîne définie dans la propriété payload
. Cela vous permet d’effectuer des actions arbitraires lorsque l’on appuie sur le bouton. Par exemple, vous pourriez afficher une liste de produits, puis envoyer l’ID du produit dans le renvoi à votre webhook, où il pourra être utilisé pour interroger votre base de données et renvoyer les détails du produit sous la forme d’un message structuré.
Le bouton de renvoi est pris en charge pour une utilisation avec les éléments suivants :
Pour une liste complète des propriétés du bouton, reportez-vous à la Référence sur le bouton de renvoi.
{
"type": "postback",
"title": "
Le bouton d’appel compose un numéro de téléphone lorsque vous appuyez dessus. Le numéro de téléphone doit être au format +<COUNTRY_CODE><PHONE_NUMBER>
, (par exemple +15105559999
).
Le bouton d’appel est pris en charge pour une utilisation avec les éléments suivants :
Pour une liste complète des propriétés du bouton, reportez-vous à la Référence sur le bouton d’appel.
{
"type":"phone_number",
"title":"
Le bouton de connexion est utilisé dans le flux d’association de comptes qui vous permet d’associer l’identité du destinataire du message sur Messenger à son compte sur votre site en le renvoyant vers votre flux de connexion web pour authentification.
Pour en savoir plus sur l’utilisation du bouton de connexion pour l’association de comptes, consultez la section Association de comptes.
Le bouton de connexion est pris en charge pour une utilisation avec les éléments suivants :
Pour une liste complète des propriétés du bouton, reportez-vous à la Référence sur le bouton de connexion.
{
"type": "account_link",
"url": "
Le bouton de déconnexion est utilisé dans le flux d’association de comptes afin de dissocier l’identité du destinataire du message sur Messenger de son compte sur votre site.
Pour en savoir plus sur l’utilisation du bouton de déconnexion pour la dissociation de comptes, consultez la section Association de comptes.
Le bouton de déconnexion est pris en charge pour une utilisation avec les éléments suivants :
Pour une liste complète des propriétés du bouton, reportez-vous à la Référence sur le bouton de déconnexion.
{
"type": "account_unlink"
}
Le bouton Jouer lance un jeu instantané associé à votre Page Facebook. Pour personnaliser la manière dont votre jeu s’ouvre, vous pouvez définir une propriété payload
dans la demande qui sera envoyée au jeu à son lancement, ainsi qu’une propriété game_metadata.player_id
ou game_metadata.context_id
facultative, qui permet à votre bot de démarrer le jeu dans un contexte spécifique contre un·e seul·e joueur·euse ou un groupe existant.
La propriété payload
doit être un objet JSON sérialisé. Il est désérialisé par le SDK Instant Games.
Pour une liste complète des propriétés du bouton, reportez-vous à la Référence sur le bouton Jouer.
{
"type":"game_play",
"title":"Play",
"payload":"{<SERIALIZED_JSON_PAYLOAD>}",
"game_metadata": { // Only one of the below
"player_id": "<PLAYER_ID>",
"context_id": "<CONTEXT_ID>"
}
}
Reportez-vous à l’évènement webhook Jouer pour définir l’évènement qui sera envoyé au bot lorsqu’un·e utilisateur·ice terminera une manche.
Utilisez les boutons pour inviter à effectuer un suivi ou une interaction supplémentaire grâce à un message particulier.
Commencez avec un verbe pour permettre à la personne de comprendre l’action qu’elle va effectuer.
Utilisez les boutons d’URL pour des actions à effectuer sur votre site web (par exemple, les achats, l’association d’un compte, etc.). Ne dissimulez pas le fait que la personne sera redirigée en dehors de Messenger.
Envoyez une réponse lorsque quelqu’un appuie sur un bouton de rappel. La personne reçoit ainsi la confirmation que vous vous occupez de l’action demandée ou l’avez effectuée (par exemple, l’annulation d’une réservation, la réponse à une question).
N’utilisez pas les boutons lorsque son action dépend de l’état actuel du bot, étant donné qu’ils seront toujours disponibles dans la discussion.
N’utilisez pas plus de trois mots, ni de ponctuation. Essayez de maintenir votre texte en dessous de 20 caractères, espaces compris.
N’utilisez pas des URL pour tous vos boutons. Plus vous pouvez créer d’interactions au sein même de Messenger, plus votre expérience sera fluide.
N’utilisez pas qu’un seul bouton de rappel. S’il n’y a qu’un seul bouton sur lequel appuyer, la personne risque de penser que c’est une continuation de votre message et ne comprendra pas que c’est une action qu’elle doit effectuer.