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

1

Lade die Desktop-App herunter

Lade All-in-One Messenger Hub herunter und installiere es auf deinem Windows-Computer.

2

Verbinde dein WhatsApp

Füge dein WhatsApp-Konto zur App hinzu, indem du den QR-Code scannst.

3

Erstelle eine Session API

Gehe zum WhatsApp-Tab und erstelle eine neue Session API. Verknüpfe sie mit deinem WhatsApp-Kanal.

4

Kopiere deinen API-Schlüssel

Kopiere den generierten API-Schlüssel. Bewahre ihn sicher auf - er ist deine Authentifizierung.

5

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
POST

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"
  }
}
POST

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"
  }
}
POST

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.

Demnächst verfügbar

Chatbot-API

Löse Chatbot-Antworten aus und verwalte Gespräche programmatisch.

Demnächst verfügbar

Kontakte-API

Greife auf deine Messenger-Kontakte über alle Plattformen hinweg zu und verwalte sie.

Demnächst verfügbar

Webhooks

Erhalte Echtzeit-Benachrichtigungen, wenn Nachrichten empfangen oder gesendet werden.