> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mit der WhatsApp Business Platform starten

> Senden Sie Ihre erste WhatsApp-Business-Platform-Nachricht über Orbit: WABA verbinden, Template genehmigen lassen, senden und innerhalb des 24-Stunden-Fensters antworten.

## Sprachhinweis

Diese deutsche Variante ist eine gekürzte Übersetzung: Der Abschnitt „Frequently asked questions" existiert nur in der englischen Fassung: [/en/guides/whatsapp/getting-started](https://docs.orbit.devotel.io/en/guides/whatsapp/getting-started). Code-Blöcke, Endpoint-Pfade, API-Feldnamen und Fehlercodes bleiben englisch.

# Mit der WhatsApp Business Platform starten

Die WhatsApp Business Platform ist Metas offizielle API für das Senden und Empfangen von WhatsApp-Nachrichten im großen Maßstab — dieselbe Plattform hinter Bestellupdates, Terminerinnerungen und Support-Chats. Über Orbit nutzen Sie sie mit einem REST-Call und einem API-Key, ohne Metas Cloud API direkt zu integrieren.

## So funktioniert die Plattform

Zwei Regeln prägen alles, was Sie senden:

* **Sie benötigen ein genehmigtes Template, um ein Gespräch zu beginnen.** Jede Nachricht, die *Sie* zuerst senden — Bestellbestätigung, Einmal-Passcode, Versandupdate — muss ein von Meta geprüftes und genehmigtes Template nutzen. Templates gibt es in vier Kategorien: **authentication**, **utility**, **marketing** und **service**. Die Kategorie bestimmt, [was Sie zahlen](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md).
* **Eine Antwort öffnet ein 24-Stunden-Fenster.** Wenn ein Kunde Ihnen schreibt, öffnet sich ein 24-Stunden-*Servicefenster*. Darin können Sie Freiform-Nachrichten senden — einfacher Text, Medien, interaktive Buttons. Schließt sich das Fenster, sind Sie wieder auf Templates beschränkt. Siehe [The 24-hour window](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md).

## Bevor Sie beginnen

Sie benötigen:

* Ein Orbit-Konto und einen Live-API-Key (**Settings → API Keys**). Live-Keys tragen das Präfix `dv_live_sk_`; halten Sie sie serverseitig.
* Eine mit Orbit verbundene **WhatsApp Business Account (WABA)**. Folgen Sie [Schritt 1](#1-connect-a-whatsapp-business-account) — der vollständige Weg liegt im [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md).

**1. Connect a WhatsApp Business Account**

Gehen Sie im Orbit-Dashboard zu **Settings → Channels → WhatsApp → Connect** und schließen Sie Metas eingebettete Anmeldung ab: Business Manager wählen, WABA erstellen oder auswählen und eine Rufnummer per SMS- oder Voice-Code verifizieren.

Sie können senden, sobald die Nummer verifiziert ist — Sie müssen Metas Business-Verifikation nicht abwarten. Bis dahin ist eine neue WABA auf **250 eindeutige Empfänger pro 24 Stunden** begrenzt.

**2. Create and approve a template**

Gehen Sie zu **Channels → WhatsApp → Templates → New Template** und reichen Sie eines ein:

1. **Kategorie** wählen — authentication, utility, marketing oder service.
2. **Sprache** wählen (jedes Locale ist eine eigene Einreichung).
3. Body mit nummerierten Variablen schreiben, z. B. `Hi {{1}}, your order {{2}} shipped.`
4. Einreichen. Die meisten Templates sind binnen Minuten genehmigt; planen Sie bis zu 24 Stunden ein.

Halten Sie die Kategorie ehrlich — eine Werbebotschaft, als `utility` eingereicht, ist die häufigste Ablehnung. Siehe [Content Policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md).

**3. Send your first template message**

Sobald ein Template genehmigt ist, senden Sie es mit einem einzigen POST. Referenzieren Sie das Template über `name` und `language` und füllen Sie die Variablen über `components`:

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "language": { "code": "en" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Ada" },
            { "type": "text", "text": "ORD-12345" }
          ]
        }
      ]
    }
  }'
```

Die Antwort liefert eine Nachrichten-ID, die Sie über [Delivery-Webhooks](https://docs.orbit.devotel.io/webhooks/events.md) verfolgen können (`message.sent`, `message.delivered`, `message.read`).

**4. Reply inside the 24-hour window**

Wenn ein Kunde antwortet, öffnet sich das 24-Stunden-Servicefenster und Sie können Freiform-Nachrichten senden — ohne Template:

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "text",
    "text": { "body": "Thanks for reaching out! How can we help?" }
  }'
```

**5. Check the window before you send**

Unsure, ob ein Kontakt noch im Fenster ist? Prüfen Sie es, bevor Sie eine Freiform-Nachricht verfassen. Ist das Fenster geschlossen, fallen Sie auf ein Template zurück.

```bash theme={null}
curl "https://api.orbit.devotel.io/api/v1/messages/whatsapp/window-status?to=+14155552671&from=+18005551234" \
  -H "X-API-Key: dv_live_sk_..."
```

Die Sendepipeline erzwingt dieselbe Regel, ein Freiform-Send außerhalb des Fensters wird abgelehnt statt still verworfen — aber der Vorab-Check erlaubt es Ihnen, Ihre UI auf Template-only zu gatten.

**6. Scale beyond the starter limit**

Neue WABAs starten mit 250 eindeutigen Empfängern pro 24 Stunden. Während Sie konsistent an mehr Empfänger senden und Ihr Quality-Rating **Medium** oder **Green** halten, hebt Meta Ihre Stufe automatisch an — auf 1.000, dann 10.000, dann 100.000, dann unbegrenzt. Ein **Low**-Rating friert Stufenaufstiege ein.

## Nächste Schritte

* [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md) — der vollständige Weg für Account, Nummer und Verifikation.
* [The 24-hour window](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md) — wie Servicefenster und Re-Engagement funktionieren.
* [WhatsApp channel reference](https://docs.orbit.devotel.io/channels/whatsapp.md) — jedes WhatsApp-API-Feld inklusive Medien und interaktiver Nachrichten.
* [WhatsApp pricing](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md) — wie Gespräche bepreist werden.
* [Content policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md) — was Meta genehmigt und ablehnt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.