WhatsApp API — Nachrichten programmatisch senden

Eine komplette WhatsApp API zum Senden von Text und Medien sowie zur Verwaltung von Konversationen über eine einfache REST-Schnittstelle. Kein Puppeteer, kein Headless-Browser — reines WebSocket.

curl -X POST https://api2whats.com/send-text \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"to": "971501234567", "message": "Hello from the API!"}'

Was ist eine WhatsApp API?

Mit einer WhatsApp API senden und empfangen Sie WhatsApp-Nachrichten aus Ihrer eigenen Software. Statt die WhatsApp-App auf dem Telefon zu öffnen und Nachrichten manuell zu tippen, sendet Ihr Code HTTP-Anfragen an einen API-Endpunkt. Die API übernimmt die Verbindung zu den WhatsApp-Servern, die Zustellung, die Statusverfolgung und die Weiterleitung eingehender Nachrichten.

Das ist für jedes Unternehmen nützlich, das in großem Umfang mit Kunden kommuniziert. Bestellbestätigungen, Versandupdates, Terminerinnerungen, Antworten im Kundensupport, Marketingkampagnen — all das lässt sich über eine WhatsApp API automatisieren. Die Nachrichten erscheinen im selben WhatsApp-Chat, den Kunden ohnehin nutzen — und werden daher tatsächlich gelesen. Die Öffnungsrate von WhatsApp-Nachrichten liegt typischerweise über 90 %, im Vergleich zu 20 % bei E-Mails.

Das Konzept ist einfach: Ihre Anwendung sendet eine HTTP-Anfrage an den API-Server, der API-Server stellt die Nachricht über WhatsApp an den Empfänger zu, und Sie erhalten eine Antwort, die die Zustellung bestätigt. Eingehende Nachrichten leitet die API in Echtzeit an Ihre Webhook-URL weiter, damit Ihr System sie sofort verarbeiten kann.

So funktioniert unsere WhatsApp API

Unsere API basiert auf dem WhatsApp-Web-Protokoll mit direkten WebSocket-Verbindungen. Das unterscheidet sich grundlegend von Lösungen, die mit Puppeteer oder Headless-Browsern eine Weboberfläche automatisieren. Direktes WebSocket bedeutet niedrigere Latenz, geringeren Ressourcenverbrauch und deutlich bessere Zuverlässigkeit.

Jede von Ihnen erstellte Instanz hält eine authentifizierte WebSocket-Verbindung zu den WhatsApp-Servern. Wenn Sie eine Nachricht über die API senden, läuft sie direkt über diese WebSocket-Verbindung. Kein Browser-Rendering, kein Screenshot-Parsing, keine fehleranfällige DOM-Manipulation. Die Verbindung ist dauerhaft und stellt Verbindungen automatisch wieder her.

Außerdem betreiben wir einen verteilten SOCKS5-Proxy-Pool über mehrere Regionen. Das erfüllt zwei Zwecke: eine zuverlässige Konnektivität unabhängig vom Standort Ihrer Server und eine Verteilung der Verbindungen auf mehrere IP-Adressen, um Rate-Limiting zu vermeiden. Jede Instanz verbindet sich über einen anderen Proxy — selbst wenn Sie zehn Instanzen gleichzeitig betreiben, hat jede ihren eigenen sauberen Verbindungspfad.

Was Sie mit der API tun können

Textnachrichten senden

Der grundlegendste Anwendungsfall: Senden Sie eine Textnachricht an jede WhatsApp-Nummer. Nachrichten unterstützen Unicode, sodass Sie Text in jeder Sprache senden können — einschließlich Arabisch, Hindi, Chinesisch und Emoji. Jede Nachricht wird einzeln zugestellt, mit vollständiger Zustellungsverfolgung.

Medien senden

Mehr als nur Text: Senden Sie Bilder, Videos, Dokumente, Audiodateien und Sticker. Medien können als URL bereitgestellt werden (die API lädt sie und stellt sie zu) oder als Base64-kodierte Daten für den direkten Versand. Dokumente können PDFs, Word-Dateien oder Tabellen sein — jeder Dateityp, den WhatsApp unterstützt.

Nachrichten per Webhook empfangen

Wenn jemand eine Nachricht an Ihre verbundene Nummer sendet, leitet die API sie als POST-Anfrage an Ihre Webhook-URL weiter. Sie erhalten die Nummer des Absenders, den Nachrichteninhalt, etwaige Medienanhänge und Zeitstempelinformationen. Ihr Webhook-Handler verarbeitet die Nachricht und kann jede automatisierte Antwort oder jeden Workflow auslösen.

Mehrere Nummern verwalten

Jeder Tarif unterstützt mehrere Instanzen — Sie können also mehrere WhatsApp-Nummern verbinden und alle über ein Dashboard verwalten. Über die API wechseln Sie zwischen Nummern, indem Sie die Instanz-ID in Ihrer Anfrage angeben. Das ist praktisch für Unternehmen, die in mehreren Regionen oder mit mehreren Marken tätig sind.

Nachrichtenstatus verfolgen

Jede gesendete Nachricht erhält eine eindeutige ID. Sie können den Status jeder Nachricht abfragen — ob sie aussteht, gesendet, zugestellt oder gelesen wurde. Webhooks übermitteln Statusaktualisierungen außerdem in Echtzeit, sodass Ihr System sofort weiß, wann eine Nachricht zugestellt oder gelesen wurde — ganz ohne Polling.

API-Endpunkte

Die API folgt einem klaren REST-Design. Alle Endpunkte akzeptieren und zurückgeben JSON. Hier sind die wichtigsten Endpunkte:

• POST /send-text — Eine Textnachricht senden
• POST /send-image — Ein Bild senden
• POST /send-video — Ein Video senden
• POST /send-document — Ein Dokument oder eine Datei senden
• POST /send-audio — Eine Audiodatei senden
• POST /send-location — Einen Standort-Pin senden
• GET /message-status/{id} — Zustellstatus prüfen
• POST /set-webhook — Ihre Webhook-URL konfigurieren
• GET /instance/status — Verbindungsstatus prüfen

Jeder Endpunkt erfordert einen API-Schlüssel im Authorization-Header. Rate-Limits gelten pro Tarif, und die API liefert klare Fehlermeldungen mit HTTP-Statuscodes, falls etwas schiefgeht.

Verbindungsmethoden

Eine Telefonnummer mit der API zu verbinden ist einfach. Wir unterstützen zwei Methoden:

QR-Code-Verbindung

Scannen Sie einen QR-Code aus Ihrem Dashboard mit der WhatsApp-App auf Ihrem Telefon. Das ist die schnellste Methode — sie dauert etwa 10 Sekunden. Der QR-Code wird automatisch aktualisiert, wenn Sie nicht rechtzeitig scannen. Nach dem Scannen wird die Verbindung hergestellt, und die Instanz bleibt online, bis Sie sie trennen.

Kopplungscode-Verbindung

Geben Sie auf Ihrem Telefon einen numerischen Kopplungscode ein, statt einen QR-Code zu scannen. Das ist nützlich, wenn Sie keinen QR-Code scannen können — etwa beim Verbinden einer Nummer auf einem Remote-Server. Der Kopplungscode wird von der API generiert und läuft nach wenigen Minuten ab.

Unterstützte Programmiersprachen

Die API ist sprachunabhängig. Jede Sprache, die HTTP-Anfragen senden kann, kann sie nutzen. Wir stellen fertige Codebeispiele bereit für:

• PHP — Mit cURL oder Guzzle
• Python — Mit der requests-Bibliothek
• JavaScript — Mit fetch oder axios (Node.js und Browser)
• cURL — Direkt über die Kommandozeile
• Go — Mit net/http
• Java — Mit HttpURLConnection oder OkHttp

Wenn Ihre Sprache eine HTTP-POST-Anfrage mit JSON-Body senden kann, können Sie diese API nutzen. Keine SDK-Installation erforderlich.

Ablauf der Nachrichten Zustellung

Wer versteht, wie Nachrichten durch das System fließen, baut bessere Integrationen. Wenn Sie eine Nachricht senden, passiert Folgendes, Schritt für Schritt:

1. Ihre Anwendung sendet eine HTTP-Anfrage an die API mit Ihrem API-Schlüssel und den Nachrichtendaten
2. Die API validiert Ihre Anfrage: Sie prüft den API-Schlüssel, verifiziert das Format der Telefonnummer und bestätigt, dass die Instanz verbunden ist
3. Die Nachricht wird für die Zustellung über die WebSocket-Verbindung der entsprechenden Instanz in die Warteschlange gestellt
4. Die Nachricht wird über die dauerhafte WebSocket-Verbindung an die WhatsApp-Server übertragen
5. WhatsApp stellt die Nachricht an das Telefon des Empfängers zu
6. Die API empfängt eine Zustellungsbestätigung von WhatsApp und aktualisiert den Nachrichtenstatus
7. Wenn ein Webhook konfiguriert ist, wird die Statusaktualisierung an Ihren Server weitergeleitet

Der gesamte Ablauf von Ihrer Anfrage bis zur Zustellungsbestätigung dauert typischerweise 1-3 Sekunden. Statusaktualisierungen (zugestellt, gelesen) können je nach Verbindung des Empfängers und Zeitpunkt des Öffnens länger dauern.

Instanzverwaltung

Jede verbundene WhatsApp-Nummer heißt "Instanz". Sie können mehrere Instanzen über ein einziges Dashboard verwalten und über die API zwischen ihnen wechseln, indem Sie die Instanz-ID angeben. Jede Instanz hat ihre eigene:

• API key — Eindeutiges Authentifizierungs-Token
• Connection status — Verbindungsstatus: verbunden, getrennt oder verbinde erneut
• Phone number — Die WhatsApp-Nummer, die der Instanz zugeordnet ist
• Webhook URL — Webhook-URL, an die eingehende Nachrichten weitergeleitet werden
• Message history — Nachrichtenverlauf mit gesendeten und empfangenen Nachrichten

Instanzen können über das Dashboard oder die API erstellt, getrennt und gelöscht werden. Beim Trennen einer Instanz wird die WhatsApp-Sitzung beendet — Sie können sich aber jederzeit wieder verbinden, ohne Ihre Daten zu verlieren.

Zuverlässigkeit und Verfügbarkeit

Wir garantieren eine Verfügbarkeit von 99,9 % (SLA) in allen Tarifen. Unsere Infrastruktur ist auf Zuverlässigkeit ausgelegt:

• Automatic reconnection — Bricht eine WebSocket-Verbindung ab, stellt die API sie innerhalb von Sekunden automatisch wieder her
• Proxy failover — Hat ein Proxy-Server Probleme, wird der Datenverkehr automatisch über einen anderen aus dem Pool geleitet
• Message queuing — Ist die WhatsApp-Verbindung vorübergehend nicht verfügbar, werden Nachrichten in die Warteschlange gestellt und nach Wiederherstellung zugestellt
• Health monitoring — Wir überwachen alle Instanzen rund um die Uhr und beheben Probleme proaktiv, bevor sie die Zustellung beeinträchtigen

Die API gibt nur dann einen 503 Service Unavailable-Fehler zurück, wenn alle Verbindungspfade erschöpft sind — was äußerst selten vorkommt. In der Praxis werden Ihre Nachrichten zugestellt, selbst wenn einzelne Komponenten kurzzeitig ausfallen.

Sicherheit und Datenschutz

Die gesamte API-Kommunikation ist über HTTPS verschlüsselt. API-Schlüssel werden sicher mit bcrypt-Hashing gespeichert — wir speichern sie niemals im Klartext. Ihre Webhook-URLs werden validiert, und alle Webhook-Payloads sind signiert, sodass Sie verifizieren können, dass sie wirklich von unseren Servern stammen.

Wir haben keinen Zugriff auf Ihre Nachrichteninhalte, es sei denn, Sie leiten sie ausdrücklich per Webhook weiter. Nachrichten zwischen Ihnen und Ihren Kunden bleiben privat. Die WhatsApp-Verbindung nutzt Ende-zu-Ende-Verschlüsselung für die Nachrichten-Transportschicht.

Preise

Tarife beginnen bei 9,99 $ pro Monat und enthalten eine feste Anzahl an API-Anfragen pro Tag, Instanzen und Funktionen. Es gibt keine versteckten Kosten, keine Gebühren pro Nachricht und keine Überraschungen bei Verbrauchsüberschreitungen. Sie können jederzeit über Ihr Dashboard up- oder downgraden.

Wir akzeptieren Kryptowährungen und Kreditkarten. Die Zahlungsabwicklung läuft über sichere Gateways, und Ihre Zahlungsdaten werden niemals auf unseren Servern gespeichert.

Anwendungsfälle

Unsere WhatsApp API wird in den verschiedensten Branchen und Anwendungen eingesetzt. Hier sind einige der häufigsten Anwendungsfälle unserer Kunden:

• E-commerce — Bestellbestätigungen, Versandupdates, Zustellbenachrichtigungen, Rücksendestatus und Erinnerungen an verlassene Warenkörbe
• Healthcare — Terminerinnerungen, Hinweise auf Folgerezepte, Übermittlung von Laborergebnissen und Nachfassungen bei Patienten
• Education — Bestätigungen der Kurseinschreibung, Abgabefristen, Prüfungsergebnisse und Kommunikation zwischen Eltern und Lehrkräften
• Real Estate — Benachrichtigungen zu neuen Immobilienangeboten, Besichtigungsbestätigungen, Angebotsmitteilungen und Mieterkommunikation
• Financial Services — Transaktionswarnungen, Rechnungszustellung, Zahlungserinnerungen und Kontobenachrichtigungen
• Restaurants — Bestellbestätigungen, Erinnerungen an Tischreservierungen, Feedback-Einholung und Werbeangebote
• Logistics — Sendungsverfolgung, Zustellbestätigungen, Fahrerzuweisungen und Lagerbenachrichtigungen

Jedes Unternehmen, das per WhatsApp mit Kunden kommuniziert, profitiert davon, diese Gespräche über die API zu automatisieren. Entscheidend ist, herauszufinden, welche Nachrichten sich wiederholen und vorhersehbar sind — genau die sollten automatisiert werden.

Erste Schritte

1. Kostenloses Konto erstellen — dauert 30 Sekunden
2. Wählen Sie den Tarif, der zu Ihnen passt
3. Erstellen Sie eine Instanz in Ihrem Dashboard
4. Verbinden Sie Ihre Telefonnummer per QR-Code oder Kopplungscode
5. Senden Sie mit Ihrem API-Schlüssel Ihre erste Nachricht

Wenn Sie Hilfe bei den ersten Schritten benötigen, werfen Sie einen Blick in unsere API-Dokumentation oder kontaktieren Sie unser Support-Team.