WhatsApp-Reaktionen senden

Reagieren Sie auf die Nachricht eines Kontakts mit einem Emoji, zum Beispiel mit einem Daumen hoch, um den Empfang zu bestätigen. Sie können Ihre Reaktion später ersetzen oder entfernen.

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 whatsapp.received 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. Reaktion hinzufügen

Rufen Sie Auf eine WhatsApp-Nachricht reagieren mit einem Emoji auf:

const reaction = await bird.whatsapp.reaction.set("wam_01krdgeqcxet5s7t44vh8rt9mg", {
  emoji: "👍",
});
console.log(reaction.id, reaction.emoji);

reaction = client.whatsapp.reaction.set("wam_01krdgeqcxet5s7t44vh8rt9mg", emoji="\U0001f44d")
print(reaction.id, reaction.emoji)

reaction, err := client.Whatsapp.Reaction.Set(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg", bird.WhatsappReactionSetParams{
	Emoji: "\U0001F44D",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(reaction.Id, reaction.Emoji)

use MessageBird\Wire\Model\WhatsAppReactionUpsert;

$reaction = $bird->whatsapp->reaction->set(
    'wam_01krdgeqcxet5s7t44vh8rt9mg',
    (new WhatsAppReactionUpsert())->setEmoji("\u{1F44D}"),
);
echo $reaction->getId(), ' ', $reaction->getEmoji();

bird whatsapp reaction set wam_01krdgeqcxet5s7t44vh8rt9mg --emoji '👍'

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

Die API gibt 202 mit der id (war_…) und dem emoji der akzeptierten Reaktion zurück. Speichern Sie die Reaktions-ID, um das Ergebnis im Reaktions-Log zu finden. Die Annahme bestätigt nicht, dass WhatsApp die Reaktion angewendet hat.

Sie halten eine Reaktion pro Nachricht. Um sie zu ersetzen, wiederholen Sie die PUT-Anfrage mit einem anderen Emoji. Reaktionen werden nicht berechnet.

2. Reaktionsergebnis prüfen

Rufen Sie die Nachricht ab, um die aktuellen reactions mit je einem Eintrag pro Absender zu sehen. Für das Ergebnis einer bestimmten Änderung listen Sie die Reaktionsereignisse der Nachricht auf und suchen Sie die gespeicherte Reaktions-ID.

Das Reaktions-Log zeichnet endgültige Ergebnisse auf: sent bedeutet, dass WhatsApp Ihre Änderung akzeptiert hat, failed bedeutet, dass WhatsApp sie abgelehnt hat, und rejected bedeutet, dass Bird sie vor der Übertragung abgelehnt hat. Prüfen Sie den error des Ereignisses bei einer fehlgeschlagenen oder abgelehnten Änderung. Eine ausstehende Reaktion hat noch keinen Log-Eintrag. Reaktionen haben keine Zustell- oder Lesebestätigungen und keinen ausgehenden Reaktions-Webhook.

3. Reaktion entfernen

Rufen Sie WhatsApp-Reaktion entfernen mit derselben Nachrichten-ID auf:

await bird.whatsapp.reaction.remove("wam_01krdgeqcxet5s7t44vh8rt9mg");

client.whatsapp.reaction.remove("wam_01krdgeqcxet5s7t44vh8rt9mg")

if err := client.Whatsapp.Reaction.Remove(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg"); err != nil {
	log.Fatal(err)
}

$bird->whatsapp->reaction->remove('wam_01krdgeqcxet5s7t44vh8rt9mg');

bird whatsapp reaction remove wam_01krdgeqcxet5s7t44vh8rt9mg --yes

curl -X DELETE "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/reaction" \
  -H "Authorization: Bearer $BIRD_API_KEY"

Die API gibt 202 ohne Antwortinhalt zurück. Die Entfernung wird asynchron verarbeitet; prüfen Sie die aktuellen reactions der Nachricht oder das Reaktions-Log, um das Ergebnis zu bestätigen. Ein Entfernungs-Log-Eintrag hat emoji: null. Eine nicht vorhandene Reaktion zu entfernen ist unbedenklich, und diese Operation entfernt die Reaktion Ihres Workspace, nicht die des Kontakts.

Fehlerbehebung

404 (E15071): Prüfen Sie die Ziel-Nachrichten-ID und den Workspace. Bird behält die Nachrichtenreferenz, die zum Hinzufügen oder Entfernen einer Reaktion benötigt wird, 15 Tage lang.
422 (E01001): Verwenden Sie eine empfangene Nachricht und ein einzelnes Emoji. Sie können nicht auf eine Nachricht reagieren, die Ihr Workspace gesendet hat. Ein zusammengesetztes Emoji zählt als ein Emoji; zwei separate Emoji nicht.
Reaktion unverändert nach 202: Prüfen Sie das Reaktions-Log auf eine fehlgeschlagene oder abgelehnte Änderung. Eine erfolgreiche HTTP-Antwort bestätigt die Annahme zur Verarbeitung.