Kurze Antwort
Um eine WhatsApp-Nachricht per API zu senden, verbinden Sie einen WhatsApp Business Account über einen Meta-Partner oder die Cloud API von Meta, holen die Einwilligung ein und lassen eine Nachrichtenvorlage genehmigen. Mit der Vorlage starten Sie die Konversation. Antwortet der Kunde, dürfen Sie im 24-stündigen Kundenservice-Fenster freien Text, Medien oder interaktive Nachrichten senden.
Was Sie vor dem ersten Versand brauchen
- Einen WhatsApp Business Account (WABA), meist über den Embedded-Signup-Ablauf von Meta bei einem Partner angelegt, mit verifizierter geschäftlicher Telefonnummer und verifiziertem Anzeigenamen.
- Mindestens eine genehmigte Nachrichtenvorlage in der Kategorie Marketing, Utility oder Authentifizierung.
- Die Einwilligung jedes Empfängers, wie es die Richtlinien von Meta verlangen.
- Eine Abrechnungsvereinbarung. Seit dem 1. Juli 2025 berechnet Meta jede zugestellte Nachricht nach Kategorie und Empfängermarkt; prüfen Sie die aktuelle Preisliste von Meta.
Vorlage oder frei formulierte Nachricht?
Ab dem 1. Oktober 2026 berechnet Meta auch Servicenachrichten und Utility-Vorlagen, die innerhalb des Fensters gesendet werden – nach 1.000 kostenlosen Servicenachrichten pro geschäftlicher Telefonnummer und Monat.
| Situation | Was Sie senden dürfen |
|---|---|
| Sie starten die Konversation | Nur eine genehmigte Vorlage |
| Der Kunde hat Ihnen in den letzten 24 Stunden geschrieben | Jeder Nachrichtentyp: Text, Medien, interaktiv oder Vorlage |
| Das 24-Stunden-Fenster ist geschlossen | Nur eine genehmigte Vorlage |
| Versand eines Einmal-Passcodes | Eine Authentifizierungsvorlage |
Schritte zum Versand
- Legen Sie die Vorlage mit Name, Sprache, Kategorie und Beispielwerten für die Variablen an und reichen Sie sie bei Meta zur Prüfung ein.
- Warten Sie, bis die Vorlage den Status „genehmigt“ hat.
- Rufen Sie den Send-Endpunkt mit Empfänger, Vorlagenname, Sprache und Variablenwerten auf.
- Speichern Sie die zurückgegebene ID und verfolgen Sie SENT, DELIVERED, READ oder FAILED über Ihren Webhook.
Beispiel: eine Vorlage senden
Bei OmniChannels.ai läuft jede WhatsApp-Nachricht über POST https://api.broadnet.me/whatsapp/message/sendbulk als Multipart-Formulardaten mit einem Bearer-Token. Setzen Sie messageType auf TEMPLATE und übergeben Sie destinationNo, templateName, templateLanguage und bodyTemplateVariables. Der Aufruf liefert eine batchId zurück; die Status je Empfänger erhalten Sie über Ihren Webhook oder über GET /whatsapp/message/bulk-insights.