API-Integrationsanleitung
Verbinde dein CRM, dein Buchungssystem oder jede Anwendung, um über unsere einfache API WhatsApp-Nachrichten zu senden.
Leg in 5 einfachen Schritten los
Lade die Desktop-App herunter
Lade All-in-One Messenger Hub herunter und installiere es auf deinem Windows-Computer.
Verbinde dein WhatsApp
Füge dein WhatsApp-Konto zur App hinzu, indem du den QR-Code scannst.
Erstelle eine Session API
Gehe zum WhatsApp-Tab und erstelle eine neue Session API. Verknüpfe sie mit deinem WhatsApp-Kanal.
Kopiere deinen API-Schlüssel
Kopiere den generierten API-Schlüssel. Bewahre ihn sicher auf - er ist deine Authentifizierung.
Beginne, Nachrichten zu senden
Nutze die API aus deiner Anwendung. Lass die Desktop-App laufen, um Nachrichten zuzustellen.
Authentifizierung
Alle API-Endpunkte erfordern eine Authentifizierung über deinen API-Schlüssel. Du kannst den Schlüssel auf eine dieser Arten übergeben:
| Methode | Beispiel |
|---|---|
| X-API-Key-Header (empfohlen) | X-API-Key: dein-api-schlüssel |
| Query-/Body-Parameter | key=dein-api-schlüssel |
| Alternativer Parameter | api_key=dein-api-schlüssel |
Nachricht senden
Sende eine WhatsApp-Nachricht an eine Telefonnummer oder Gruppe. Nachrichten werden in eine Warteschlange gestellt und zugestellt, wenn die Desktop-App läuft.
POST https://onemessengerhub.com/api/whatsapp-session/send
Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key |
string | Ja | Dein API-Schlüssel aus der Desktop-App |
mobile |
string | Bedingt | Telefonnummer mit Ländervorwahl (erforderlich ohne group_id) |
group_id |
string | Bedingt | WhatsApp-Gruppen-ID (erforderlich ohne mobile). Das Suffix @g.us wird automatisch hinzugefügt. |
message |
string | Ja | Nachrichtentext (max. 4096 Zeichen) |
Beispielanfrage
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mobile": "1234567890", "message": "Hello!"}'
Einfache GET-Anfrage (Browser oder Link)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!
Erfolgsantwort (201)
{
"success": true,
"message": "Message queued successfully",
"data": {
"message_id": 123,
"recipient": "1234567890",
"status": "pending"
}
}
Kontakt speichern
Speichere oder benenne einen Kontakt in deinem WhatsApp um. Der Vorgang wird in eine Warteschlange gestellt und von der Desktop-App verarbeitet.
POST https://onemessengerhub.com/api/whatsapp-session/save-contact
Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key |
string | Ja | Dein API-Schlüssel aus der Desktop-App |
contact_id |
string | Ja | Telefonnummer des Kontakts oder WhatsApp-ID (max. 50 Zeichen). Das Suffix @c.us wird automatisch hinzugefügt. |
name |
string | Ja | Anzeigename für den Kontakt (max. 255 Zeichen) |
Beispielanfrage
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890", "name": "John Doe"}'
Erfolgsantwort (201)
{
"success": true,
"message": "Contact save operation queued",
"data": {
"operation_id": 456,
"contact_id": "[email protected]",
"status": "pending"
}
}
Kontakt entfernen
Entferne einen Kontakt aus deinem WhatsApp. Der Vorgang wird in eine Warteschlange gestellt und von der Desktop-App verarbeitet.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contact
Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
key |
string | Ja | Dein API-Schlüssel aus der Desktop-App |
contact_id |
string | Ja | Telefonnummer des Kontakts oder WhatsApp-ID (max. 50 Zeichen). Das Suffix @c.us wird automatisch hinzugefügt. |
Beispielanfrage
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890"}'
Erfolgsantwort (201)
{
"success": true,
"message": "Contact remove operation queued",
"data": {
"operation_id": 789,
"contact_id": "[email protected]",
"status": "pending"
}
}
Fehlerbehandlung
Die API verwendet standardmäßige HTTP-Statuscodes. Hier sind die häufigen Fehlerantworten:
Authentifizierungsfehler (401)
{
"success": false,
"message": "Invalid or inactive API key"
}
Validierungsfehler (422)
{
"success": false,
"message": "Validation failed",
"errors": {
"mobile": ["The mobile field is required when group id is not present."],
"message": ["The message field is required."]
}
}
Was du bauen kannst
CRM-Integration
Sende Follow-up-Nachrichten, Erinnerungen und Updates direkt aus deinem CRM-System.
Buchungsbestätigungen
Sende Kunden automatisch Terminbestätigungen und Erinnerungen.
Bestellbenachrichtigungen
Informiere Kunden über Bestellstatus, Versandupdates und Lieferinfos.
Warnsysteme
Sende wichtige Warnungen und Benachrichtigungen an dein Team oder deine Kunden.
Marketing-Kampagnen
Sende Werbenachrichten und Updates an deine Kontaktliste.
Eigene Workflows
Integriere mit Zapier, Make, n8n oder jeder Automatisierungsplattform.
Weitere APIs demnächst verfügbar
Wir erweitern unser API-Angebot, um mehr Plattformen und Anwendungsfälle abzudecken.
Chatbot-API
Löse Chatbot-Antworten aus und verwalte Gespräche programmatisch.
Kontakte-API
Greife auf deine Messenger-Kontakte über alle Plattformen hinweg zu und verwalte sie.
Webhooks
Erhalte Echtzeit-Benachrichtigungen, wenn Nachrichten empfangen oder gesendet werden.
All-in-One Messenger Hub