Ausgehende WhatsApp-Antwortnachrichten

Mit WhatsApp Outbound Replies können Unternehmen eine bestehende Nachricht in einer Konversation zitieren/beantworten. Dies kann entweder die Nachricht eines Endnutzers oder ihre eigene Nachricht sein. Dies gibt dem Unternehmen die Möglichkeit, beim Senden einer Nachricht zusätzlichen Kontext zu liefern, um Klarheit zu schaffen, die der Inhalt der Nachricht allein möglicherweise nicht vermitteln kann.

Unternehmen können zitieren/antworten:

  • Die Nachricht eines Endbenutzers. Dies könnte verwendet werden, um deutlich zu machen, dass sich die letzte vom Unternehmen gesendete Nachricht auf eine spezifisch Nachricht des Nutzers zu einem früheren Zeitpunkt der Konversation, z. B. "In Bezug auf Ihre Frage lautet die Antwort..."
  • Eine vom Unternehmen gesendete Nachricht. Damit kann auf etwas verwiesen werden, das das Unternehmen selbst zuvor im Gespräch gesagt hat, z. B. "Dies ist die Option, auf die ich mich bezogen habe".

Innerhalb der WhatsApp-Oberfläche erhält der Empfänger die neue Nachricht zusammen mit einer kontextbezogenen Sprechblase, die den Inhalt der vorherigen Nachricht anzeigt.

Screenshot of an outbound reply message in the WhatsApp UI

API-Anfrage-Nutzdaten

Um eine ausgehende Antwortnachricht sowie die Standardfelder für den gesendeten WhatsApp-Nachrichtentyp zu senden, muss die JSON-Nutzlast für die API-Anforderung eine Top-Level context Eigenschaft. Der Wert dieser Eigenschaft ist ein Objekt mit einer Eigenschaft message_uuid, dessen Wert die UUID der Nachricht ist, die zitiert/beantwortet wird.

Ein Beispiel für eine JSON-Nutzlast könnte etwa so aussehen:

{
	"to": "447700900000",
	"from": "447700900001",
	"channel": "whatsapp",
	"message_type": "text",
	"text": "This looks like your order number. Can you confirm?",
	"context": {
		"message_uuid": "a1b2c3d4a1b2c3d4"
	}
}

Beschränkungen

  • Diese Funktion ist verfügbar auf Cloud-API nur beherbergte WABAs (siehe WhatsApp Numbers Hosting)
  • Die Antworten müssen innerhalb von 24 Stunden nach Erhalt der ursprünglichen Nachricht, die zitiert/beantwortet wurde, erfolgen.

Mögliche Fehler

Der Versuch, auf eine Nachricht zu antworten, die nicht gespeichert ist, weil sie entweder nicht existiert oder die 24-Stunden-Frist abgelaufen ist, führt dazu, dass die Nachricht mit folgendem Fehlercode abgewiesen wird:

1451 - Invalid context - the reference to the original message could not be found because it is invalid or no longer available