# 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`](/docs/guides/whatsapp/receiving-whatsapp) oder die `id` der Nachricht aus dem [WhatsApp-Log](/docs/guides/whatsapp/message-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](/docs/sdks/typescript)-, [Python](/docs/sdks/python)-, [Go](/docs/sdks/go)- oder [PHP](/docs/sdks/php)-SDK-Anleitung. Für CLI-Beispiele [installieren und authentifizieren Sie die CLI](/docs/cli#authenticate) mit WhatsApp-Schreibzugriff. Verwenden Sie den API-Host für Ihre [Workspace-Region](/docs/api/regions) in cURL-Anfragen.

## 1. Reaktion hinzufügen

Rufen Sie [Auf eine WhatsApp-Nachricht reagieren](/docs/api/reference/upsert-whatsapp-message-reaction) mit einem Emoji auf:

**TypeScript**

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

Examples: [TypeScript](/de-de/dokumentation/guides/whatsapp/reactions.ts.md) · [Python](/de-de/dokumentation/guides/whatsapp/reactions.py.md) · [Go](/de-de/dokumentation/guides/whatsapp/reactions.go.md) · [PHP](/de-de/dokumentation/guides/whatsapp/reactions.php.md) · [CLI](/de-de/dokumentation/guides/whatsapp/reactions.cli.md) · [cURL](/de-de/dokumentation/guides/whatsapp/reactions.curl.md)

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](/docs/api/reference/get-whatsapp-message), 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](/docs/api/reference/list-whatsapp-message-reaction-events) 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](/docs/api/reference/delete-whatsapp-message-reaction) mit derselben Nachrichten-ID auf:

**TypeScript**

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

Examples: [TypeScript](/de-de/dokumentation/guides/whatsapp/reactions.ts.md) · [Python](/de-de/dokumentation/guides/whatsapp/reactions.py.md) · [Go](/de-de/dokumentation/guides/whatsapp/reactions.go.md) · [PHP](/de-de/dokumentation/guides/whatsapp/reactions.php.md) · [CLI](/de-de/dokumentation/guides/whatsapp/reactions.cli.md) · [cURL](/de-de/dokumentation/guides/whatsapp/reactions.curl.md)

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](/docs/api/errors/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](/docs/api/errors/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.

## Nächste Schritte

- [Reaktionsänderungen empfangen](/docs/guides/whatsapp/receiving-whatsapp/reactions)
- [Nachricht als gelesen markieren](/docs/guides/whatsapp/mark-message-as-read)
- [Eine WhatsApp-Antwort senden](/docs/guides/whatsapp/sending-whatsapp)

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)