Messenger-Plattform

Generische Vorlage

Die generische Vorlage ist eine einfache strukturierte Nachricht, die einen Titel, einen Untertitel, ein Bild und bis zu drei Buttons umfasst. Du kannst auch ein default_action-Objekt angeben, das eine URL festlegt, die beim Tippen auf die Vorlage in der Messenger-Webansicht geöffnet wird.

Inhalt

Vorlagen-Payload

Eine vollständige Liste der Vorlageneigenschaften findest du unter Referenz zur generischen Vorlage.

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

Die Messenger-Plattform unterstützt das Senden eines horizontal scrollbaren Carousels mit generischen Vorlagen.

Zum Erstellen eines scrollbaren Carousels gib bis zu 10 generische Vorlagen im elements-Array der payload an.

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

Beispielanfrage

Alle Anfragedetails und -eigenschaften findest du in der Referenz zur generischen Vorlage.

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

Beispielantwort

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

Best Practices

Verwende diese Vorlage für Nachrichten mit einer konsistenten Informationshierarchie (beispielsweise Produkt- oder Artikelvorschau, Wettervorhersagen).

Verwende das richtige Seitenverhältnis für dein Bild. Fotos in der generischen Vorlage, die nicht 1,91:1 nutzen, werden skaliert oder zugeschnitten.

Verwende diese Vorlage nicht, wenn deine Nachricht keine strukturierten Informationen aufweist oder keine Hierarchie erfordert.

Verwende die Vorlage nicht, wenn eine Vergrößerung deines Bilds als Vollbildanzeige möglich sein soll.

Verwende keine GIFs in der Vorlage, wenn diese animiert sein sollen. GIFs werden zwar unterstützt, können aber nicht animiert werden.

Verwende ein Carousel, wenn dein Inhalt ist einer bestimmten Prioritätsfolge angezeigt werden soll. Das heißt, das erste Element ist wahrscheinlich am interessantesten.

Bemühe dich um Konsistenz. Wenn ein Bubble ein Foto enthält, sollten alle ein Foto aufweisen.

Minimiere die Anzahl generischer Vorlagen in deinem Carousel. Wenn es zu viele Optionen gibt, können die Menschen sich nicht alle merken.

Mische keine Content-Arten. Wenn du einen Artikel neben einer Produktliste einfügst, kann dein Erlebnis verwirrend werden.

Verwende kein Carousel, wenn es wichtig ist, dass die ganze Liste betrachtet wird. Möglicher scrollen manche Menschen nicht bis zum Ende. Verwende in diesem Fall lieber eine Listenvorlage.