hermes whatsapp-cloud Befehl — Vollständige Referenz & Beispiele

Übersicht

hermes whatsapp-cloud konfiguriert den offiziellen Meta-WhatsApp-Business-Cloud-API-Adapter. Anders als hermes whatsapp — die Baileys-Bridge für persönliche Konten — nutzt dieser die von Meta gehostete Cloud API und erfordert ein Business-Konto und eine öffentliche Webhook-URL. Es ist ein interaktiver Assistent: Es gibt keine Unterbefehle.

hermes whatsapp-cloud

Erfordert ein TTY: Der Assistent fragt interaktiv ab.

Was der Assistent durchgeht

Meta-Zugangsdaten — Phone Number ID, Access Token und App Secret, plus optionale App- und WABA-IDs (WhatsApp Business Account).
Webhook-Konfiguration — den Endpunkt einrichten, über den Meta eingehende Nachrichten zustellt.
Validierung — Feldformat-Validatoren fangen häufige Konfigurationsfehler ab, etwa das Einfügen einer Telefonnummer in das Feld Phone Number ID.

Voraussetzungen

Ein Meta-Business-Konto mit einer WhatsApp-Business-Telefonnummer
Eine öffentliche, aus dem Internet erreichbare Webhook-URL
Eine Meta-App mit aktiviertem WhatsApp-Produkt

Beispiele

hermes whatsapp-cloud
# Der interaktive Assistent fragt ab:
#   - Phone Number ID
#   - Access Token
#   - App Secret
#   - Optionale App-/WABA-IDs
#   - Webhook-Konfiguration

# Verbindung nach der Einrichtung prüfen
hermes status

Tipps

Die beiden WhatsApp-Adapter ergänzen sich, sie sind keine Alternativen: hermes whatsapp koppelt ein persönliches Konto per QR-Code; hermes whatsapp-cloud nutzt die offizielle Meta-Business-Cloud-API für Produktions-Workloads.
Eine öffentliche, aus dem Internet erreichbare Webhook-URL ist erforderlich — für lokale Tests den Server per Tunnel freigeben.
Die Zugangsdaten werden bei der Eingabe validiert, sodass Tippfehler wie eine falsch platzierte Telefonnummer sofort auffallen.