---
title: "WhatsApp-Webhooks"
description: "Die WhatsApp-Webhook-Events, die Bird an Ihren Endpunkt senden kann, der Umschlag, in dem jedes Event ankommt, und die Felder, die jedes Nachrichten-Event enthält."
canonical: "https://bird.com/de-de/dokumentation/guides/whatsapp/webhooks"
---

# WhatsApp-Webhooks

Bird sendet WhatsApp-Aktivität in Echtzeit an Ihren Endpunkt, sodass Sie nicht danach abfragen müssen. Abonnieren Sie über die Seite [**Webhooks**](https://bird.com/dashboard/w/webhooks) oder mit [`POST /v1/webhooks`](/docs/api/reference/create-webhook). Der [Webhooks-Leitfaden](/docs/guides/webhooks) behandelt Endpunkte, Signaturverifizierung und Wiederholungsversuche.

## Events, die Sie abonnieren können

Jedes Event verlinkt auf seinen Payload.

| Event                                                                                               | Wird ausgelöst, wenn                                          |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| [`whatsapp.accepted`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird eine ausgehende Sendeanfrage annimmt                     |
| [`whatsapp.sent`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | Bird die Nachricht an das WhatsApp-Netzwerk übergibt          |
| [`whatsapp.delivered`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)               | WhatsApp die Zustellung an das Gerät des Empfängers bestätigt |
| [`whatsapp.read`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                    | Der Empfänger die Nachricht öffnet                            |
| [`whatsapp.failed`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                  | Die Zustellung der Nachricht fehlschlägt                      |
| [`whatsapp.rejected`](/docs/guides/whatsapp/webhooks/message-status#delivery-events)                | Bird die Nachricht vor dem Senden ablehnt                     |
| [`whatsapp.received`](/docs/guides/whatsapp/webhooks/messages)                                      | Ein Kontakt Ihnen eine Nachricht sendet                       |
| [`whatsapp.reacted`](/docs/guides/whatsapp/webhooks/reactions)                                      | Ein Kontakt eine Reaktion hinzufügt, ändert oder entfernt     |
| [`whatsapp_suppression.created`](/docs/guides/whatsapp/webhooks/suppressions)                       | Eine Unterdrückung in Ihrem Workspace eröffnet wird           |
| [`whatsapp.group.join_request_created`](/docs/guides/whatsapp/webhooks/groups#join-request-created) | Jemand den Beitritt zu einer Gruppe anfragt                   |
| [`whatsapp.group.join_request_revoked`](/docs/guides/whatsapp/webhooks/groups#join-request-revoked) | Jemand seine Beitrittsanfrage zu einer Gruppe zurückzieht     |

Die Liste der Event-Typen ist offen: Neue Typen können im Laufe der Zeit hinzukommen. Behandeln Sie einen unbekannten Wert als zukünftiges Event und nicht als Fehler.

## Der Event-Umschlag

Jedes WhatsApp-Event verwendet den Standard-[Webhook-Umschlag](/docs/guides/webhooks): ein `type`, ein `timestamp` und ein typspezifisches `data`-Objekt.

```json
{
  "data": {
    "direction": "outbound",
    "from": { "phone_number": "+13124495569" },
    "metadata": { "session_id": "sess_4821" },
    "tags": [{ "name": "flow", "value": "login-otp" }],
    "to": { "phone_number": "+14155550100" },
    "whatsapp_id": "wam_01ky7qbvswf3fvyaw3az90391c",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b"
  },
  "timestamp": "2026-07-23T14:51:39.913Z",
  "type": "whatsapp.delivered"
}
```

## Felder, die jedes Nachrichten-Event enthält

Jeder WhatsApp-Webhook-Payload für eine Nachricht enthält `whatsapp_id`, `workspace_id`, `direction`, `from`, `to`, `tags` und `metadata`. Die Reaktions-, Unterdrückungs- und Gruppen-Events beziehen sich nicht auf eine Nachricht und haben jeweils eine eigene Struktur, die auf ihrer Seite beschrieben ist.

- **Adressen**: `from` und `to` können eine E.164-`phone_number`, eine Meta-[Business-scoped User ID](/docs/guides/whatsapp/business-scoped-user-ids) in `bsuid` oder beides enthalten. Eine Nachricht von einem WhatsApp-Nutzer enthält außerdem das veröffentlichte Profil in `username` und `display_name`.
- **`tags` und `metadata`** sind `null`, wenn beim Senden keine angegeben wurden.
- **`in_reply_to_message_id`** erscheint bei jedem ausgehenden Event einer als Antwort gesendeten Nachricht, von `whatsapp.accepted` über `whatsapp.read`, `whatsapp.failed` oder `whatsapp.rejected`, und benennt die Nachricht, auf die geantwortet wird.

Event-Payloads enthalten keine Kosten. Rufen Sie die Nachricht mit [`GET /v1/whatsapp/messages/{message_id}`](/docs/api/reference/get-whatsapp-message) ab, um die Kosten einzusehen.

## Nächste Schritte

- [Nachrichtenstatus-Webhooks](/docs/guides/whatsapp/webhooks/message-status): Zustellungs- und Fehler-Payloads
- [Eingehende-Nachrichten-Webhooks](/docs/guides/whatsapp/webhooks/messages): der `whatsapp.received`-Payload
- [Reaktions-Webhooks](/docs/guides/whatsapp/webhooks/reactions): der `whatsapp.reacted`-Payload
- [Webhooks-Leitfaden](/docs/guides/webhooks): Endpunkte, Signaturen, Wiederholungsversuche und der vollständige Event-Katalog

## 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](/whatsapp-api) (product)

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