WhatsApp über Integrations-API senden

Authentifizierung

Die Authentifizierung verwendet einen Local API Key im Anfragekörper (`api_key`-Feld), nicht im HTTP-Header. Jedes Unternehmen hat einen Local API Key (UUID), der automatisch generiert wird, wenn das Unternehmen erstellt wird.

So erhältst du den Local API Key

1. Melde dich im cshub-Panel unter /app an.
2. Öffne Einstellungen → API Key (oder Profil → Integration).
3. Kopiere den Local API Key. Du kannst ihn jederzeit regenerieren — der alte Schlüssel wird sofort ungültig.

Endpunkt

Ein einzelner Endpunkt deckt jede WhatsApp Unofficial (whatsmeow) Sendung ab. Wähle Methode = text für Freitextnachrichten oder Methode = template, um eine Vorlage zu senden, die du bereits im Panel konfiguriert hast.

Körperfelder

Der Körper ist JSON. Die untenstehenden Felder entsprechen dem whatscrmhub Laravel — beim Migrieren von der älteren Version ist die Anforderungsstruktur identisch.

Anforderungsbeispiele

1. Sende eine einfache Textnachricht

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "text",
    "text": "Halo, makasih udah order ya!"
  }'

2. Sende eine Vorlage mit Variablenersetzung

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "template",
    "template": "<TEMPLATE_ID>",
    "variables": {
      "$name": "Pak Budi",
      "$order_id": "INV-20260602-001"
    }
  }'

3. Sende an eine Gruppe (verwende Gruppen-JID)

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "120363012345678901@g.us",
    "method": "text",
    "text": "Pengumuman: order minggu ini ditutup pukul 17:00.",
    "is_group": true
  }'

Erfolgsantwort (200 OK)

{
  "status": true,
  "message": "berhasil mengirim pesan"
}

Fehlercodes & Lösungen

Hinweise & Limits

• Es gibt ein tägliches Sendelimit pro Gerät. Vermeide es, mehr als ~10 Nachrichten/Sekunde von einem einzelnen Gerät zu senden, um WhatsApp-Sperren zu vermeiden.
• Wenn dein Unternehmen `api_device_use = required` hat, ist das Feld `device_key` obligatorisch. Wenn es optional ist, wählt der Server ein aktives Gerät basierend auf der Einstellung `whatsapp_sender_notif` (`sequence` / `spin` / `random`).
• Die Variablenersetzung verwendet wörtliches `str_replace` — Platzhalter können beliebige Zeichenfolgen sein (z.B. `$name`, `{name}`, `[NAME]`). Sie müssen genau mit dem Text in der Vorlagenachricht übereinstimmen.
• Immer ohne "+" und ohne Leerzeichen/Bindestriche formatieren. Beispiel: 6281234567890 (Indonesien), 60123456789 (Malaysia). Für Gruppen verwende die vollständige JID mit dem Suffix `@g.us`.
• MVP-Iteration: Der Upload von Binärdateien über multipart/form-data wird noch nicht unterstützt. Um Medien zu senden, verwende method=template mit einer Vorlage, die bereits ein Bild im Panel konfiguriert hat.

Integrations-API vs Interne Panel-API

cshub hält absichtlich zwei Wege zum Senden von Nachrichten bereit. Die Integrations-API ist für Drittentwickler und Automatisierung gedacht; die interne API versorgt das cshub-Webpanel und die mobile App. Unterschiedliches Publikum, unterschiedliche Authentifizierung, unterschiedliche Antwortstruktur.