REST API
WhatsApp Business API
Für Shell, Cronjobs und CI/CD gibt es zusätzlich die instantKOM CLI.
"id": 650034,
"recipientId": 12345,
"message": "Hallo!",
"status": "queued"
}
Alle wichtigen Messenger
Grundlagen
Was ist die WhatsApp Business API?
Die WhatsApp Business API ist Metas Unternehmensschnittstelle für WhatsApp – ohne eigene App und ohne Smartphone-Bindung. Meta stellt die Schnittstelle nur über zertifizierte Provider bereit; instantKOM® bindet Sie über den Provider CM.com an und übernimmt Verwaltung, Versand und Auswertung in einer Oberfläche.
WhatsApp Business API
Metas Schnittstelle für Unternehmen: serverseitig angebunden, ohne Smartphone, mit Automatisierung, Team-Zugriff und Nachrichten-Templates für werblichen Versand.
WhatsApp-Business-App
Die kostenlose App von Meta für Solo- und Kleinbetriebe: an ein Smartphone gebunden, ohne API-Zugang und ohne Mehrbenutzer-Betrieb.
instantKOM-REST-API
Channel-übergreifend: eine Schnittstelle für WhatsApp, Signal, Threema, Telegram, RCS und SMS – statt einer WhatsApp-only-Anbindung.
Mehr zum Channel selbst: WhatsApp für Unternehmen. Alle Pakete und Preise: Preisübersicht.
Voraussetzungen
Zugangsvoraussetzungen: Wer bekommt Zugang zur WhatsApp Business API?
Zum Testen reicht ein kostenloses instantKOM®-Konto. Für den produktiven Versand kommen ein paar zusätzliche Schritte dazu.
- Business-Paket: Der API-Zugang ist ab dem Business-Paket enthalten.
- 14-Tage-Test ohne Freigabe-Gate: Der Test-Account nutzt die API sofort nach der Registrierung, begrenzt auf 1 Channel, 10 Abonnenten und 100 Nachrichten.
- Connectivity-Vereinbarung: Self-Service direkt in der Anwendung abschließbar – kein Sales-Gespräch nötig.
- Embedded Sign-Up: Meta verknüpft Ihre Nummer und Ihr Unternehmensprofil per Embedded-Sign-Up-Flow; instantKOM® begleitet Sie dabei mit einem Termin.
- Profildaten: Anzeigename, Kategorie, Beschreibung, Adresse und Profilbild Ihres Unternehmens.
- Rufnummer: Eine Telefonnummer, die noch nicht an einen anderen WhatsApp-Account gebunden ist.
- Opt-in der Empfänger: Werbliche Nachrichten dürfen ausschließlich an Empfänger gehen, die dem Empfang aktiv zugestimmt haben.
Transparente Kosten
Was kostet die WhatsApp Business API?
Zwei Kostenblöcke: die monatliche Plattformgebühr und die Kosten je Nachrichten-Kategorie.
| Kategorie | Preis je Nachricht | Typischer Einsatz |
|---|---|---|
| Marketing | 0,15 € | Werbliche Vorlagen, z. B. Newsletter und Angebote |
| Utility | 0,0718 € | Transaktionale Vorlagen, z. B. Bestell- und Versandupdates |
| Authentication | 0,0718 € | Einmalpasswort- und Verifizierungs-Vorlagen |
| Service & Session | kostenlos | Antworten innerhalb des 24-Stunden-Servicefensters |
Alle Transfers zählen auf das Nachrichten-Volumen des Pakets; darüber hinaus 1 € je 1.000 Nachrichten im Business-Paket.
Signal, Threema und Telegram haben keine Kosten pro Nachricht. Plattform-Satz: API-Zugang ab Business-Paket – 239 €/Monat im Jahresabo (299 € monatlich).
Schritt für Schritt
WhatsApp Business API einrichten: Schritt für Schritt
Von der Registrierung bis zum ersten API-Request.
- 1
Konto erstellen
Kostenloses instantKOM®-Konto anlegen, 14 Tage testen – ohne Kreditkarte.
- 2
Connectivity-Vereinbarung abschließen
Self-Service direkt in der Anwendung, Voraussetzung für den WhatsApp-Channel.
- 3
Embedded Sign-Up durchlaufen
Rufnummer und Unternehmensprofil über Metas Embedded-Sign-Up-Flow verknüpfen, begleitet von einem instantKOM-Termin.
- 4
Gateway wird aktiviert
instantKOM® aktiviert Ihren WhatsApp-Channel serverseitig, sobald die Verknüpfung beim Provider aktiviert ist und Sie Ihr Profil veröffentlicht haben.
- 5
API-Key erstellen
Self-Service in der Anwendung, als Scoped Key mit nur den benötigten Rechten.
- 6
Ersten Request senden
POST /v1/messagesmitAuthorization: Bearer <api-key>. Hinweis: der Legacy-HeaderX-API-KEYwird auf/v1/-Endpunkten nicht unterstützt. - 7
Webhook abonnieren
Event-Endpoint hinterlegen und das einmalig angezeigte HMAC-Secret sicher verwahren – damit signieren Sie eingehende Webhook-Payloads.
Endpoint-Übersicht
Was die instantKOM API kann
Alle Bereiche, die Sie per REST-API steuern können – vollständig dokumentiert in der OpenAPI-Referenz.
| Bereich | Was Sie tun können |
|---|---|
| Nachrichten | 1-zu-1-Nachrichten senden und empfangen, Status abfragen. |
| Broadcasts | Broadcasts und Newsletter anlegen, planen und versenden. |
| Templates | WhatsApp-Nachrichten-Vorlagen anlegen und verwalten. |
| Kontakte | Kontakte anlegen, aktualisieren, importieren und löschen. |
| Channels | Channels lesen und verwalten – alle Messenger in der Multi-Messenger-Plattform. |
| Chats & Tickets | Chat-Verläufe und Support-Tickets lesen und aktualisieren. |
| Bots & Flows | Automatisierungs-Bots und Flows steuern. |
| Segmente & Tags | Kontakte segmentieren und taggen. |
| Webhooks | 5 Event-Typen (neuer Kontakt, neue Nachricht, Broadcast versendet, Kontakt aktualisiert, Kontakt abgemeldet), HMAC-signierte Payloads. |
| Auswertung | Kennzahlen und Reporting-Daten abrufen. |
| API-Keys | Scoped Keys mit eingeschränkten Rechten sowie optionalem IP-Whitelisting je Key (Enterprise). |
| Weitere Endpunkte | Custom Fields, E-Commerce-Bestellungen, Objektordner und mehr. |
| CLI | Dieselbe API aus Shell, Cronjobs und CI/CD – instantKOM CLI. |
| MCP-Server | Dieselbe API per natürlicher Sprache aus Claude, Cursor & Co. – instantKOM MCP-Server. |
Reguläres Rate-Limit: 100 Requests pro 60 Sekunden. Authentifizierung per Bearer Token. Vollständig dokumentiert mit OpenAPI 3.0.
API Self-Service
API-Einstieg ohne Sales-Hürde
Testen, API-Key erstellen, dokumentierte Endpoints nutzen und bei Bedarf auf Business oder Enterprise skalieren.
14 Tage
API kostenlos testen
ohne Kreditkarte
100/60s
Rate-Limit Schutz
stabiler Betrieb
REST
JSON API & Webhooks
OpenAPI Docs
DSGVO
B2B Messaging API
Made in Germany
Core Features
API-Funktionen im Überblick
Dokumentierte REST-Endpunkte, API-Key-Authentifizierung und Webhooks für Ihre Messenger-Workflows.
REST API
Standardisierte REST-Schnittstelle mit JSON-Datenformat für einfache Integration.
Sichere Authentifizierung
API-Schlüssel für alle Requests, zentral in der Plattform verwaltbar.
OpenAPI-Dokumentation
Interaktive Dokumentation mit Endpoints, Parametern und Beispielantworten.
Webhooks
Event-Updates für Nachrichten, Kontakte und Statusänderungen.
Integration
Schnelle Integration in bestehende Systeme
Ohne verschachtelte Toolchains: Sie starten mit API-Key, Dokumentation und klaren Betriebsgrenzen.
5 Minuten Setup
API-Key erstellen, Endpoint testen, ersten Workflow anbinden.
CLI & Beispiele
Quickstarts für Shell, Cronjobs und einfache Integrationspfade.
TLS-geschützt
Sichere API-Kommunikation und nachvollziehbare Zugriffe.
IP Whitelist
Zusätzliche Zugriffsbeschränkung für Enterprise-Anforderungen.
Key Benefits
API-Nutzung sauber starten und betreiben
Von API-Key und OpenAPI-Dokumentation bis zu Rate-Limit-Handling und abgesichertem Produktivbetrieb.
Für Entwickler
- RESTful API mit vollständiger CRUD-Unterstützung
- Interaktive Swagger/OpenAPI 3.0 Dokumentation
- Rate Limiting, CORS, Security Headers (Helmet)
- Bearer Token Authentifizierung mit API Keys
Für Unternehmen
- Zentrale Verwaltung aller Messenger-Channels
- Automatisierte, KI-gestützte Kampagnen
- Echtzeit-Analysen & Reporting
- Flexible Skalierung von Starter bis Enterprise
Minimum-Anforderungen
- REST-Client (curl, Postman, etc.)
- JSON-Parser
- Bearer Token API Key
Empfohlen
- HTTPS/SSL für sichere Kommunikation
- Error Handling für 4xx/5xx Status Codes
- Rate Limit Handling (100 req/min)
Use Cases
Praktische API-Anwendungsfälle
Typische Workflows für CRM, Support, Commerce und interne Automatisierung.
Automatisierte Kundenakquise
Leads aus CRM, Formularen oder Shop-Systemen automatisch in Messenger-Dialoge überführen.
- Lead-Qualifizierung
- Follow-up Workflows
Support-Automatisierung
Tickets, Statusupdates und Standardantworten per Messenger automatisieren.
- Ticket-Routing
- Status-Updates
Transaktionale Nachrichten
Bestell-, Versand- und Service-Updates aus Shop-Systemen senden.
- Bestellupdates
- Lieferbenachrichtigungen
Interne Workflows
Alerts, Freigaben und interne Benachrichtigungen aus bestehenden Tools starten.
- Approval-Workflows
- Mitarbeiter-Alerts
Integrationsstatus
API-Anbindungen transparent eingeordnet
Live nutzbare Wege, Marketplace-Review und Roadmap sind getrennt markiert. So sehen Sie vor dem Start, was heute verfügbar ist.
Live nutzbar
Direkt nutzbar
Im Review
Marketplace-Freigabe läuft
Roadmap
In Vorbereitung
Häufige Fragen
Häufige Fragen zur WhatsApp Business API
Authorization: Bearer <api-key>. API-Keys erstellen Sie self-service in der Anwendung, optional als Scoped Key mit eingeschränkten Rechten. Ihre Frage war nicht dabei? Hier finden Sie alle häufigen Fragen zu instantKOM.
Jetzt loslegen
Starten Sie mit der instantKOM-API
Wählen Sie den passenden Einstieg: Dokumentation lesen, API-Key erstellen, Beispiele nutzen oder direkt den passenden Plan prüfen.
API-Dokumentation
Interaktive Swagger-Dokumentation mit Endpoints und Beispielen.
Dokumentation öffnenKommen Sie in Kontakt
Wir freuen uns auf Ihre Nachricht
Bei instantKOM® stehen Ihnen verschiedene Möglichkeiten zur Verfügung, um mit uns in Kontakt zu treten. Ob Sie Fragen zu unseren Produkten haben, Hilfe bei der Nutzung unserer Plattform benötigen oder einfach nur Feedback geben möchten: Wir freuen uns auf Ihre Nachricht.