Skip to main content

​
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. 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.
  • 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.

​
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 — der vollständige Weg liegt im WABA setup guide.
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.
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:
Die Antwort liefert eine Nachrichten-ID, die Sie über Delivery-Webhooks 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:
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.
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