Nachricht als gelesen markieren

Bestätigen Sie die WhatsApp-Nachricht eines Kontakts, wenn Sie sie gelesen oder mit der Bearbeitung der Anfrage begonnen haben. Sie können auch einen Tippindikator anzeigen, während Sie eine Antwort vorbereiten.

Voraussetzungen

Sie benötigen einen API-Schlüssel mit WhatsApp-Schreibberechtigung und die Bird-Nachrichten-ID (wam_…) einer Nachricht, die Ihr Workspace empfangen hat. Verwenden Sie data.whatsapp_id aus dem whatsapp.received-Webhook oder die id der Nachricht aus dem WhatsApp-Log.

Ersetzen Sie die Beispiel-Nachrichten-ID durch die ID einer Nachricht, die Ihr Workspace empfangen hat. Initialisieren Sie den Client für Ihre Sprache mit der TypeScript-, Python-, Go- oder PHP-SDK-Anleitung. Für CLI-Beispiele installieren und authentifizieren Sie die CLI mit WhatsApp-Schreibzugriff. Verwenden Sie den API-Host für Ihre Workspace-Region in cURL-Anfragen.

1. Die empfangene Nachricht als gelesen markieren

Rufen Sie Nachricht als gelesen markieren mit der empfangenen Nachrichten-ID auf. WhatsApp markiert auch frühere Nachrichten in derselben Konversation als gelesen – wählen Sie daher die Nachricht, die angibt, bis wohin Sie gelesen haben.

const acknowledgement = await bird.whatsapp.markRead("wam_01krdgeqcxet5s7t44vh8rt9mg", {});
console.log(acknowledgement.typing_indicator);

ack = client.whatsapp.mark_read("wam_01krdgeqcxet5s7t44vh8rt9mg")
print(ack.typing_indicator)

ack, err := client.Whatsapp.MarkRead(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg", bird.WhatsappMarkReadParams{})
if err != nil {
	log.Fatal(err)
}
fmt.Println(ack.TypingIndicator)

use MessageBird\Wire\Model\WhatsAppReadReceiptRequest;

$ack = $bird->whatsapp->markRead(
    'wam_01krdgeqcxet5s7t44vh8rt9mg',
    new WhatsAppReadReceiptRequest(),
);
var_dump($ack->getTypingIndicator());

bird whatsapp mark-read wam_01krdgeqcxet5s7t44vh8rt9mg

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/read" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Eine erfolgreiche Anfrage gibt 202 mit typing_indicator: false zurück. Die Bestätigung wird zur Verarbeitung angenommen; die Antwort bestätigt nicht, dass der Kontakt sie gesehen hat. Lesebestätigungen erzeugen keine abrechnungsfähige ausgehende Nachricht.

2. Tippindikator während der Antwortvorbereitung anzeigen

Um die Nachricht als gelesen zu markieren und den Tippindikator anzuzeigen, übergeben Sie typing_indicator: true in derselben Anfrage:

await bird.whatsapp.markRead("wam_01krdgeqcxet5s7t44vh8rt9mg", {
  typing_indicator: true,
});

ack = client.whatsapp.mark_read("wam_01krdgeqcxet5s7t44vh8rt9mg", typing_indicator=True)
print(ack.typing_indicator)

ack, err := client.Whatsapp.MarkRead(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg", bird.WhatsappMarkReadParams{
	TypingIndicator: bird.Ptr(true),
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(ack.TypingIndicator)

$ack = $bird->whatsapp->markRead(
    'wam_01krdgeqcxet5s7t44vh8rt9mg',
    (new WhatsAppReadReceiptRequest())->setTypingIndicator(true),
);
var_dump($ack->getTypingIndicator());

bird whatsapp mark-read wam_01krdgeqcxet5s7t44vh8rt9mg --typing-indicator=true

curl -X POST "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/read" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"typing_indicator": true}'

WhatsApp löscht den Indikator, wenn Sie eine Nachricht senden oder nach 25 Sekunden. Ein erneuter Aufruf ist unbedenklich. Um den Tippindikator zu aktualisieren, lassen Sie Idempotency-Key weg oder verwenden Sie einen neuen Schlüssel; das Wiederholen einer früheren Anfrage aktualisiert den Indikator nicht.

3. Die empfangene Nachricht prüfen

Rufen Sie die Nachricht ab, um read_at zu prüfen. Nachdem WhatsApp die Bestätigung akzeptiert hat, kann die empfangene Nachricht diesen Zeitstempel tragen und gleichzeitig ihren received-Status behalten. Es gibt keine separate Bestätigungsressource und keinen Zustellungs-Webhook zur Nachverfolgung.

Fehlerbehebung

404 (E15071): Prüfen Sie die Nachrichten-ID und den Workspace. Bird kann eine Nachricht 15 Tage lang für eine Bestätigung auflösen; eine ältere Nachricht kann über diese Operation nicht als gelesen markiert werden.
422 (E15074): Verwenden Sie eine eingehende Nachricht, die Ihr Workspace bestätigen kann. Eine ausgehende Nachricht ist kein gültiges Ziel.
503 (E15073): Versuchen Sie es nach einem vorübergehenden Fehler beim Auflösen der Nachricht erneut.