Zum Hauptinhalt springen

📡 Kanäle Übersicht

Ein Kanal in PulseHub repräsentiert ein einzelnes verbundenes Messaging-Konto. Sie können mehrere Kanäle des gleichen Typs haben — zum Beispiel zwei WhatsApp-Nummern für verschiedene Abteilungen oder drei E-Mail-Postfächer für Vertrieb/Support/Rechnungswesen.


Wie Kanäle funktionieren

Anbieter (WhatsApp, Twilio, etc.)

│ HTTP POST (Webhook)

/webhooks/{type}/{channel_id}


WebhookController
1. Verifiziert Signatur
2. Normalisiert Payload
3. Findet/erstellt Kontakt
4. Findet/erstellt Konversation
5. Speichert Nachricht
6. Löst Automatisierungs-Events aus

Jeder Kanal hat:

  • Eine eindeutige ID (UUID) — dies ist die {channel_id} in der Webhook-URL
  • Einen Typ — einer der 8 unterstützten Kanaltypen
  • Eine Konfiguration — JSON-Blob mit den für diesen Kanaltyp spezifischen Zugangsdaten
  • Ein Webhook-Token — ein zufälliges 32-Hex-Zeichen-Token, das bei der Erstellung generiert wird
  • Ein Aktiv-Flag — inaktive Kanäle lehnen eingehende Webhooks ab und senden keine ausgehenden Nachrichten

Einen Kanal hinzufügen

  1. Gehen Sie zu Kanäle in der Seitenleiste
  2. Klicken Sie auf Kanal hinzufügen
  3. Wählen Sie den Kanaltyp aus dem Dropdown
  4. Füllen Sie die typspezifischen Zugangsdaten aus (siehe jeweilige Kanalanleitung)
  5. Klicken Sie auf Kanal speichern

Nach dem Speichern zeigt die Kanalkarte die Webhook-URL. Kopieren Sie diese URL und fügen Sie sie in das Entwickler-Dashboard Ihres Anbieters ein.


Webhook-URL-Format

https://ihredomain.com/webhooks/{type}/{channel_id}

Unterstützte Kanäle

KanalRichtungSignaturverifizierungHinweise
WhatsAppBeide✅ HMAC-SHA256Erfordert Meta Business-Konto
SMS / TwilioBeideTeilweiseErfordert Twilio-Konto
E-MailBeideN/AIMAP-Abfrage für Eingang
TelegramBeideBot API, keine Signatur
ViberBeide✅ HMAC-SHA256Erfordert Viber Partners-Konto
InstagramBeide✅ HMAC-SHA256Über Meta Graph API
Facebook MessengerBeide✅ HMAC-SHA256Über Meta Graph API
Web-Chat-WidgetBeideTokenEingebettetes JS-Snippet