Handlungen des*der Sender*in

In diesem Leitfaden erfährst du, wie du deine Handlungen in einer Unterhaltung anzeigst, um Nachrichtenempfänger*innen wissen zu lassen, dass du die Nachricht gelesen hast und daran arbeitest.

Eine Handlungen des*der Sender*in anzeigen

Um die Handlung eines*einer Sender*in in einer Unterhaltung anzuzeigen, sende eine POST-Anfrage an den /PAGE-ID/messages-Endpunkt und setze den sender_action-Parameter auf typing_on.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"

Einschränkungen

  • Anfragen zum Anzeigen der Handlung eines*einer Sender*in sollten nur den sender_action-Parameter und das recipient-Objekt enthalten. Alle anderen Send API-Eigenschaften wie Text und Vorlagen sollten in einer separaten Anfrage gesendet werden.
  • Der*die Empfänger*in muss für das Anzeigen von Handlungen des*der Sender*in angemeldet sein.
  • Die Anzeige der Texteingabe wird nach 20 Sekunden automatisch ausgeschaltet oder wenn der Bot eine Nachricht sendet.

Eine vollständige Liste der Handlungen des*der Sender*in findest du unter Referenz zu Seitennachrichten.

Best Practices

  • Sende die mark_seen-Anzeige, wenn dein Bot eine Nachricht empfängt, damit sich der*die Nutzer*in nicht ignoriert fühlt.

  • Wenn dein Bot eine Nachricht empfängt, auf die er antwortet, sende die typing_on-Anzeige. Dies trägt dazu bei, ein Unterhaltungserlebnis zu schaffen.

  • Sende typing_on- und typing_off-Handlungen in den separaten Batch-Anfragen. Batch-Anfragen werden sehr schnell der Reihe nach ausgeführt. Diese schnelle Ausführung kann dazu führen, dass die typing_on-Anzeige nur für einen Bruchteil einer Sekunde angezeigt wird, wenn beide Handlungen im selben Batch gesendet werden.

  • Achte darauf, dass zwischen den Handlungen des*der Sender*in typing_on und typing_off kein unnatürlicher Zeitabstand liegt (zu lang oder zu kurz). Im Idealfall soll der*die Nutzer*in das Gefühl haben, dass eine reale Person die Nachricht in der verstrichenen Zeit getippt hat.

Siehe auch

Unterstützung für Entwickler*innen