Der Begrüßungsbildschirm

In diesem Dokument wird erklärt, wie du einen Begrüßungsbildschirm für dein Messenger-Erlebnis erstellst. Auf dem Begrüßungsbildschirm werden der Name der Facebook-Seite deines Unternehmens, das Profilbild und das Titelbild deiner Facebook-Seite, die Zeit, die dein Unternehmen normalerweise braucht, um auf Nachrichten zu antworten, eine optionale Begrüßungsnachricht und der Button Los geht's angezeigt. Wenn eine Person auf den „Los geht‘s“-Button klickt, wird die Nachricht „Los geht‘s“ in der Unterhaltung gepostet. Deine App darf nun Nachrichten an die Person senden.

So funktioniert’s

Wenn eine Person in deinem Messenger-Erlebnis auf den „Los geht‘s“-Button klickt, wird an dich eine Webhook-Benachrichtigung gesendet. Du kannst diese Benachrichtigung verwenden, um eine erste Begrüßungsnachricht zu senden, z. B. einen kurzen Text oder eine Reihe von Kurzantworten.

Bevor du beginnst

In diesem Leitfaden gehen wir davon aus, dass du die Übersicht zur Messenger-Plattform gelesen, die benötigten Komponenten wie eine Facebook-Seite für dein Unternehmen (oder eine Test-Seite) implementiert, dich als Meta-Entwickler*in registriert und eine Meta-Business-App-ID mit dem Messenger-Produkt erstellt hast.

Was du benötigst:

Einen von einer Person angeforderten Seiten-Zugriffsschlüssel, welche auf der Seite die Aufgabe MESSAGING ausführen kann
Die Berechtigung pages_messaging
Abonnement des messaging_postbacks-Webhook-Events

Einschränkungen

Bei Apps mit Standardzugriff wird der Begrüßungsbildschirm nur Personen angezeigt, die eine Rolle in der App besitzen.

Befehle

Wenn deine Seite Befehle verwendet, zeigt der Begrüßungsbildschirm die Liste der Befehle, die vom Messaging-Erlebnis unterstützt werden. So können Personen einfach nachvollziehen, welche Handlungen die KI ausführen kann.

Den „Los geht‘s“-Button implementieren

Um den Postback-Payload einzurichten, sendest du eine POST-Anfrage an die Messenger Profile API:

curl -X POST -H "Content-Type: application/json" -d '{
  "get_started": {"payload": "

Alle Details dazu findest du in der Referenz zur get_started-Eigenschaft.

Best Practices

Gib weitere Schritte an, um Personen zu ermutigen, eine Antwort auf deine Begrüßungsnachricht zu senden. Du kannst deine Nachricht über Buttons besser strukturieren und bestimmte Handlungen nennen, die Personen ausführen können.
Teile grundlegende Befehle in deiner Begrüßungsnachricht. Teile den Nutzer*innen mit, welche Keywords oder Begriffe sie verwenden können, um Hilfe anzufordern, Updates zu erhalten usw., um ihnen den Einstieg zu erleichtern.
Ändere das Onboarding, wenn sich etwas in deinem Bot-Erlebnis ändert. Überarbeite deinen Begrüßungstext und deine Begrüßungsnachricht, wenn du Funktionen aktualisierst, damit sie weiterhin relevant bleiben.
Vergiss nicht, dass alle Bildschirmelemente zusammenhängen. Der Kontext deiner Messenger-Begrüßung sollte den Button „Los geht‘s“ ergänzen.
Deine Nachricht sollte nicht zu allgemein gehalten sein. Sprich Personen nach Möglichkeit mit ihrem Namen an. Damit wirkt die Nachricht persönlicher. Betrachte die Nachricht als Chance, ihnen die Nutzung und Steuerung des Erlebnisses näher zu bringen.

Begrüßungstext festlegen

Mit dem Begrüßungstext auf deiner Startseite kannst du Nutzer*innen direkt mitteilen, warum sie eine Unterhaltung mit deinem Messenger-Bot beginnen sollten. In deinen Begrüßungstext kannst du beispielsweise eine kurze Beschreibung zur Funktionsweise deines Bots einbinden, z. B. die wichtigsten Funktionen oder eine Tagline. So kannst du auch einen Stil oder den Tonfall deines Bots festlegen.

Verwende entweder einen Standardbegrüßungstext oder eine lokalisierte Begrüßung.

Um den Begrüßungstext einzurichten, sende eine POST-Anfrage an die Messenger Profile API:

curl -X POST -H "Content-Type: application/json" -d '{
  "greeting": [
    {
      "locale":"default",
      "text":"Hello!" 
    }, {
      "locale":"en_US",
      "text":"Timeless apparel for the masses."
    }
  ]
}' "https://graph.facebook.com/v2.6/me/messenger_profile?access_token=

Alle Details dazu findest du in der greeting property-Referenz.

Personalisierung

Du kannst den Begrüßungstext mit dem Namen des Gesprächspartners personalisieren. Dabei kannst du die folgenden Vorlagen-Strings verwenden:

{{user_first_name}}
{{user_last_name}}
{{user_full_name}}

Beispiel

"greeting":[
  {
    "locale":"default",
    "text":"Hello {{user_first_name}}!"
  }
]

Best Practices

Betrachte deine Begrüßung als Vorstellung und Zusammenfassung deines Erlebnisses. Begrüßungen dürfen höchstens 160 Zeichen umfassen. Fasse dich also kurz.
Vermittle deine Hauptfunktionalität. Anhand von Kontext können Personen besser verstehen, wie sie mit dir interagieren sollten, und wissen, was sie von deinen Funktionen erwarten können.
Verwende deine Begrüßung nicht als Bedienungsanleitung. Da deine Begrüßung wieder verschwindet, musst du die eigentlichen Nachrichten verwenden, um bestimmte Funktionen und Befehle vorzustellen.
Verwende nicht zu viel Textformatierung (wie Abstand, Interpunktion, Zeilenumbrüche) in deiner Begrüßung, damit das Zeichenlimit nicht zu schnell erreicht wird.

Siehe auch

https://developers.facebook.com/docs/graph-api/reference/v14.0/page/messenger_profile