Plateforme Messenger

Modèle générique

Le modèle générique est un message simple structuré incluant un titre, un sous-titre, une image et jusqu’à trois boutons. Vous pouvez également spécifier un objet default_action afin de définir une URL qui s’ouvrira dans le webview Messenger lorsqu’un utilisateur ou une utilisatrice appuiera sur le modèle.

Table des matières

Charge utile du modèle

Pour une liste complète des propriétés du modèle, reportez-vous à la référence sur le modèle générique.

"payload": {
  "template_type":"generic",
  "elements":[
     {
      "title":"

La plateforme Messenger permet l’envoi d’un carrousel horizontal de modèles génériques à faire défiler.

Pour créer un carrousel avec défilement, incluez jusqu’à 10 modèles génériques dans l’ensemble elements du champ payload.

"payload": {
  "template_type":"generic",
  "elements":[

Exemple de requête

Pour les propriétés et les détails complets de la requête, reportez-vous à la référence sur les modèles génériques.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://petersfancybrownhats.com/company_image.png",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://petersfancybrownhats.com/view?item=103",
              "messenger_extensions": false,
              "webview_height_ratio": "tall",
              "fallback_url": "https://petersfancybrownhats.com/"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://petersfancybrownhats.com",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"DEVELOPER_DEFINED_PAYLOAD"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Exemple de réponse

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

Recommandations

À utiliser pour les messages dotés d’une hiérarchisation cohérente des informations (par exemple, l’aperçu d’un produit ou d’un article, des prévisions météorologiques).

Utilisez des proportions correctes pour votre image. Les photos du modèle générique qui ne présentent pas les proportions 1,91:1 sont mises à l’échelle ou rognées.

À ne pas utiliser si les informations de votre message ne sont pas structurées ou si elles requièrent d’être hiérarchisées.

À ne pas utiliser si votre image doit pouvoir être affichée en plein écran.

N’utilisez pas de GIF dans le modèle s’ils doivent être animés. Bien que gérés, les GIF ne peuvent pas être animés.

Utilisez un carrousel lorsqu’un ordre de priorité est associé à votre contenu, par exemple, lorsque le premier élément est probablement le plus intéressant.

Respectez une certaine cohérence. Si une bulle inclut une photo, ajoutez une photo dans toutes les bulles.

Réduisez le nombre de modèles génériques dans votre carrousel. S’il y en a trop, il devient difficile de se souvenir de toutes les options.

Ne mélangez pas les types de contenus. Si vous incluez un article à côté d’une liste de produits, votre expérience pourrait prêter à confusion.

N’utilisez pas de carrousel s’il est important que les personnes puissent voir tous les éléments de la liste. Elles pourraient ne pas le faire défiler jusqu’en bas. Utilisez plutôt un modèle de liste.