# WhatsApp Business Platform: Cloud API und Templates

> Die WhatsApp Business Platform sendet Nachrichten über die Cloud API (von Meta gehostet) oder die ältere On-Premises API. Business-initiierte Nachrichten müssen vorab genehmigte Templates einer Kategorie (Marketing, Utility, Authentication) verwenden; freie Session-Nachrichten sind nur innerhalb eines 24-Stunden-Kundenservicefensters erlaubt, das durch die letzte Nachricht des Nutzers geöffnet wird. Opt-in ist verpflichtend.

- Kanonische URL: https://www.broadnet.me/de/reference/whatsapp-business-cloud-api
- Sprache: de
- Zuletzt aktualisiert: 2026-07-18
- Herausgeber: BroadNet (https://www.broadnet.me)

Wie die WhatsApp Business Platform funktioniert: Cloud API vs. On-Premises API, Template-Nachrichten (HSM) vs. Session-Nachrichten, das 24-Stunden-Kundenservicefenster, die Kategorien Marketing/Utility/Authentication, Webhooks, Qualitätsstufen von Rufnummern und Opt-in.

## Cloud API vs. On-Premises API

Die WhatsApp Business Platform stellt zwei APIs mit demselben Nachrichtenmodell, aber unterschiedlichem Hosting bereit. Die Cloud API wird von Meta gehostet: Ein Unternehmen (oder sein Solution Provider) ruft einen Graph-artigen REST-Endpoint auf, der auf einer phone-number-ID basiert, ohne einen lokalen Client betreiben zu müssen. Die On-Premises API ist ein containerisierter Client, den das Unternehmen selbst hostet, historisch aus Gründen der Datenresidenz oder Latenz genutzt; Meta hat sie zugunsten der Cloud API zur Abschaltung vorgesehen. Beide unterliegen denselben Regeln — Templates, dem 24-Stunden-Fenster, Kategorien, Qualität und Opt-in —, sodass die Wahl operativ (wer hostet) und nicht funktional ist.

*Cloud API vs. On-Premises API*

| Eigenschaft | Cloud API | On-Premises API |
|---|---|---|
| Hosting | Von Meta gehostet, kein eigener Client erforderlich | Vom Unternehmen gehosteter containerisierter Client |
| Endpunkt | Graph REST auf einer Telefonnummern-ID | Lokaler Client-REST-Endpunkt |
| Upgrades | Verwaltet durch Meta | Das Unternehmen pflegt Clientversionen |
| Status | Empfohlen, aktiv weiterentwickelt | Zur Abkündigung vorgesehen |
| Regeln (Vorlagen/Fenster/Qualität) | Identisch | Identisch |

## Template-Nachrichten (HSM) vs. Session-Nachrichten

WhatsApp trennt die beiden Richtungen des Business Messaging. Ein Unternehmen darf einen Nutzer nicht mit freiem Inhalt kalt anschreiben: Jede business-initiierte Nachricht muss ein Message-Template sein — historisch als Highly Structured Message (HSM) bezeichnet —, das vorab bei WhatsApp eingereicht und genehmigt wurde, mit benannten Variablen-Platzhaltern und einer deklarierten Kategorie. Sobald der Nutzer antwortet, öffnet sich ein 24-Stunden-Kundenservicefenster, in dem das Unternehmen freie Session-Nachrichten (Text, Medien, interaktiv) ohne Template senden darf. Außerhalb dieses Fensters muss das Unternehmen erneut mit einem genehmigten Template beginnen. Diese Template-First-Regel ist die zentrale Einschränkung der Plattform.

*Cloud API: ein genehmigtes Utility-Template senden*

```json
POST https://graph.facebook.com/v20.0/{phone-number-id}/messages
Authorization: Bearer {access-token}
{
  "messaging_product": "whatsapp",
  "to": "15551234567",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en_US" },
    "components": [
      { "type": "body",
        "parameters": [ { "type": "text", "text": "4021" } ] }
    ]
  }
}
```

## Das 24-Stunden-Kundenservicefenster

Das 24-Stunden-Fenster ist der Mechanismus, der freies Messaging steuert. Es öffnet sich (oder öffnet sich erneut) jedes Mal, wenn der Nutzer eine Nachricht an das Unternehmen sendet, und dauert 24 Stunden ab dieser letzten Nutzernachricht. Innerhalb des Fensters darf das Unternehmen mit jedem erlaubten Nachrichtentyp antworten — reiner Text, Medien, interaktive Buttons oder Listen — ohne ein Template zu verwenden. Wenn das Fenster schließt, werden freie Sendungen abgelehnt, und das Unternehmen muss mit einem genehmigten Template erneut aktiv werden (vorbehaltlich Kategorie und, bei Marketing, Limits pro Nutzer). Sowohl die Session-Bepreisung als auch die neuere Bepreisung pro Nachricht hängen davon ab, ob eine Sendung innerhalb oder außerhalb dieses Fensters liegt.

## Nachrichtenkategorien: Marketing, Utility, Authentication

Jedem Template wird eine Kategorie zugewiesen, die regelt, wie es verwendet werden darf und wie es bepreist wird. Utility-Templates beziehen sich auf eine konkrete, vereinbarte Transaktion oder ein Kontoereignis (Bestellaktualisierungen, Terminerinnerungen, Kontoauszüge). Authentication-Templates liefern Einmalpasscodes und Verifizierungen in einem eingeschränkten Format. Marketing-Templates tragen Werbeaktionen, Angebote und Reaktivierung und unterliegen der strengsten Steuerung — abhängig von Nutzer-Opt-in, Qualitätssignalen und Frequenzlimits. WhatsApp prüft den Template-Inhalt bei der Genehmigung gegen die deklarierte Kategorie und kann ihn umkategorisieren; das Senden von Marketing-Inhalten unter einem Utility-Label ist eine häufige Ursache für Ablehnung oder Qualitätsschäden.

*WhatsApp-Template-Kategorien*

| Kategorie | Zweck | Anmerkungen |
|---|---|---|
| Utility | Transaktions-/Kontoaktualisierungen, die der Benutzer erwartet | An eine bestimmte Handlung oder Vereinbarung gebunden |
| Authentifizierung | Einmalpasswörter, Verifizierung | Eingeschränktes Format; OTP-fokussiert |
| Marketing | Werbeaktionen, Angebote, Reaktivierung | Strenges Opt-in, Steuerung von Qualität und Frequenz |
| Dienst (Sitzung) | Freitextantworten im 24-Stunden-Fenster | Keine Vorlage erforderlich; nicht vom Unternehmen initiiert |

## Webhooks: eingehende Nachrichten und Zustellstatus

Die Plattform ist asynchron und callback-gesteuert. Ein Unternehmen konfiguriert eine Webhook-URL, an die WhatsApp zwei Arten von Ereignissen postet: eingehende Nachrichten (die Antworten, Medien, Button-Taps und der Standort des Nutzers) sowie Statusbenachrichtigungen für ausgehende Nachrichten, die durch sent, delivered, read und — bei Fehlschlag — failed mit einem Fehlercode durchlaufen. Lesebestätigungen und der Nachrichtenlebenszyklus werden hier abgebildet, und genau das Eintreffen eines eingehenden Nachrichtenereignisses öffnet oder aktualisiert das 24-Stunden-Fenster. Eine robuste Integration bestätigt Webhooks schnell und gleicht den Zustellstatus gegen den eigenen Nachrichtenspeicher ab, ähnlich wie eine SMS-Plattform DLRs abgleicht.

*Eingehender Webhook: Nutzernachricht öffnet das 24-Stunden-Fenster*

```json
{
  "entry": [{ "changes": [{ "value": {
    "messaging_product": "whatsapp",
    "messages": [{
      "from": "15551234567", "id": "wamid.HBg...",
      "timestamp": "1752796800",
      "type": "text", "text": { "body": "Where is my order?" }
    }]
  } }] }]
}
```

## Rufnummernqualität, Stufen und Opt-in

Jede Business-Rufnummer trägt ein Qualitätsrating (angezeigt als hoch/mittel/niedrig, oft grün/gelb/rot eingefärbt), abgeleitet daraus, wie Nutzer auf ihre Nachrichten reagieren — Blockierungen und Meldungen ziehen es nach unten. Die Qualität steuert die Messaging-Limit-Stufe, die begrenzt, mit wie vielen eindeutigen Nutzern eine Nummer in rollierenden 24 Stunden Konversationen beginnen darf; die Stufen steigen (zum Beispiel 250, 1K, 10K, 100K, dann unbegrenzt) bei anhaltender Qualität und Volumen und fallen, wenn die Qualität sinkt. Grundlage von allem ist das Opt-in: WhatsApp verlangt, dass Unternehmen vor dem Senden eine ausdrückliche Nutzereinwilligung einholen und dokumentieren, die auf jedem Kanal erfasst werden kann. Schlechte Opt-in-Praxis zeigt sich schnell in Blockierungen, verschlechterter Qualität und einer gedrosselten Stufe.

*Qualitätsrating und Messaging-Stufen*

| Signal | Bedeutung | Auswirkung |
|---|---|---|
| Qualität: hoch (grün) | Wenige Blockierungen/Meldungen | Berechtigt zum Aufstieg in höhere Stufen |
| Qualität: mittel (gelb) | Einige negative Rückmeldungen | Unter Beobachtung; Skalierung pausiert |
| Qualität: niedrig (rot) | Viele Sperrungen/Meldungen | Risiko einer Herabstufung oder Kennzeichnung |
| Tier (250 / 1K / 10K / 100K / ∞) | Eindeutige gestartete Nutzer pro 24 Std. | Erhöht bei anhaltender Qualität + Volumen |
| Opt-in | Protokollierte Nutzereinwilligung | Erforderlich vor jedem vom Unternehmen initiierten Versand |

## Häufige Fragen

### Was ist der Unterschied zwischen der Cloud API und der On-Premises API?

Beide nutzen dasselbe WhatsApp-Nachrichtenmodell, aber die Cloud API wird von Meta gehostet (Sie rufen einen REST-Endpoint auf, ohne etwas zu betreiben), während die On-Premises API ein containerisierter Client ist, den Sie selbst hosten. Meta hat die On-Premises API zugunsten der Cloud API zur Abschaltung vorgesehen. Templates, das 24-Stunden-Fenster, Kategorien und Qualitätsregeln gelten für beide identisch.

### Was ist ein WhatsApp-Message-Template (HSM)?

Ein Template — historisch eine Highly Structured Message — ist vorab genehmigter Inhalt mit benannten Variablen-Platzhaltern und einer deklarierten Kategorie. Jede business-initiierte WhatsApp-Nachricht muss ein Template sein; freier Inhalt ist nur innerhalb des 24-Stunden-Kundenservicefensters erlaubt, das durch eine Antwort des Nutzers geöffnet wird.

### Was ist das 24-Stunden-Kundenservicefenster?

Es ist der Zeitraum von 24 Stunden ab der letzten Nachricht des Nutzers an das Unternehmen, während dessen das Unternehmen freie Session-Nachrichten ohne Template senden darf. Wenn es schließt, werden freie Sendungen abgelehnt, und das Unternehmen muss mit einem genehmigten Template erneut aktiv werden. Eingehende Webhook-Ereignisse öffnen oder aktualisieren das Fenster.

### Welche WhatsApp-Nachrichtenkategorien gibt es?

Templates werden als Utility (vom Nutzer erwartete Transaktions-/Kontoaktualisierungen), Authentication (Einmalpasscodes und Verifizierung) oder Marketing (Werbung und Reaktivierung, am strengsten gesteuert) kategorisiert. Freie Antworten innerhalb des Fensters sind Service-Nachrichten. Die Kategorie regelt die zulässige Nutzung und die Bepreisung, und WhatsApp prüft den Inhalt gegen die deklarierte Kategorie.

### Was bestimmt das Messaging-Limit einer WhatsApp-Nummer?

Die Messaging-Stufe begrenzt, mit wie vielen eindeutigen Nutzern eine Nummer pro rollierenden 24 Stunden Konversationen beginnen kann (zum Beispiel 250, 1K, 10K, 100K, dann unbegrenzt). Die Stufen steigen bei anhaltender Qualität und Volumen und fallen, wenn die Qualität sinkt. Die Qualität ist ein Rating von hoch/mittel/niedrig, das durch Blockierungen und Meldungen von Nutzern bestimmt wird.

### Brauche ich ein Opt-in, um Nutzer auf WhatsApp anzuschreiben?

Ja. WhatsApp verlangt vor dem Senden von Nachrichten eine ausdrückliche, dokumentierte Nutzereinwilligung — die auf jedem Kanal erfasst werden kann. Schwaches Opt-in zeigt sich schnell in Blockierungen und Meldungen, die das Qualitätsrating der Nummer senken und ihre Messaging-Stufe drosseln oder herabstufen können.

## Quellen

- [WhatsApp Business Platform — Cloud API documentation](https://developers.facebook.com/docs/whatsapp/cloud-api)
- [WhatsApp — Message templates and categories](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates)
- [WhatsApp — Per-message pricing and the 24-hour window](https://developers.facebook.com/docs/whatsapp/pricing)

## Verwandte Seiten

- [WhatsApp Business API](https://www.broadnet.me/de/products/whatsapp-business-api)
- [RCS vs. SMS vs. WhatsApp](https://www.broadnet.me/de/reference/rcs-vs-sms-vs-whatsapp-channels)
- [Rich Cards und interaktives Messaging](https://www.broadnet.me/de/reference/rich-cards-and-interactive-messaging)
- [Kanal-Fallback und Orchestrierung](https://www.broadnet.me/de/reference/channel-fallback-and-orchestration)
- [Omnichannel](https://www.broadnet.me/de/products/omnichannel)
- [Entwickler](https://www.broadnet.me/de/developers)