Kommunikationskanäle

Owlat modelliert jedes Kommunikationsmedium — E-Mail, nativen Chat, SMS, WhatsApp und einen Auffang-Webhook — als Kanal. Eingehende Nachrichten aus allen diesen Quellen landen im gemeinsamen Team-Postfach auf einer einheitlichen Chronik. Diese Seite behandelt den Einstellungsbereich Kanäle, in dem Owner und Admins Kanäle aktivieren, Anbieter-Zugangsdaten hinterlegen und den Gesundheitsstatus beobachten.

Wo Sie die Kanäle finden

Öffnen Sie im Dashboard Einstellungen → Kanäle (Route /dashboard/admin/instance/channels). Für die Seite selbst genügt eine Anmeldung, aber etwas zu ändern — einen Kanal zu aktivieren/deaktivieren oder Zugangsdaten zu speichern — ist auf Owner und Admins beschränkt: Die zugrunde liegende Mutation updateChannelConfig verlangt die Berechtigung organization:manage (siehe Team & Berechtigungen). Wer ohne Adminrechte auf diesen Bildschirm gelangt, kann die Kanalliste lesen, dessen Speicher- und Umschaltaktionen werden aber abgelehnt.

Der Bildschirm listet eine Karte pro Kanal. Jede Karte zeigt Symbol und Name des Kanals, einen Schalter zum Aktivieren/Deaktivieren, ein Gesundheits-Badge und ein Panel Konfigurieren, das ein Formular für die Zugangsdaten aufklappt. Eine Seitenleiste fasst die Summen zusammen: wie viele Kanäle existieren, wie viele aktiviert sind und wie viele gesund, beeinträchtigt oder ausgefallen sind.

Was die Kanäle sind

Was „aktiviert“ wirklich bedeutet

Der Aktivierungsschalter steuert, ob ein Kanal in die periodische Gesundheitsprüfung einbezogen und in den Übersichtszahlen als aktiv geführt wird. Für E-Mail und Chat spiegelt er einen vollständig funktionierenden Kanal wider. Für SMS, WhatsApp und den Generic Webhook regelt der Schalter nur die Gesundheitsüberwachung und die Übersicht — er kontrolliert nicht den Eingang: Eingehende Webhooks werden allein auf Basis einer gültigen Signatur gegen das konfigurierte Secret des Kanals akzeptiert (siehe Eingehende Kanal-Webhooks), unabhängig davon, ob der Kanal eingeschaltet ist. Er kontrolliert sehr wohl den manuellen Ausgang — die Antwort-Schaltfläche im Postfach und der Kontakt-Composer bieten nur Kanäle an, die aktiviert und konfiguriert sind.

SMS, WhatsApp und den Generic Webhook konfigurieren

Klicken Sie auf einer Kanalkarte auf Konfigurieren, um das zugehörige Formular zu öffnen. Jeder Kanal akzeptiert einen optionalen Anzeigenamen (wird in der Oberfläche anstelle des Standard-Kanalnamens angezeigt). Darüber hinaus unterscheiden sich die Felder für die Zugangsdaten je Kanal.

Klicken Sie auf Konfiguration speichern, um zu persistieren. Ein Toast bestätigt die Speicherung. Token-Felder sind standardmäßig maskiert und lassen sich über einen Schalter ein- und ausblenden.

Überwachung der Kanalgesundheit

Ein Hintergrund-Cron läuft alle 5 Minuten und aktualisiert den Gesundheitsstatus jedes aktivierten Kanals. Jede Karte zeigt ein farbiges Badge sowie — sofern verfügbar — den Zeitpunkt der letzten Prüfung, den letzten erfolgreichen Versand und den letzten Fehler.

Ein separater Cron poll channel delivery status läuft alle 5 Minuten, damit ausgehende SMS-, WhatsApp- und generische Nachrichten nicht für immer auf sent stehen bleiben: Er fragt den Anbieter für jede in den letzten 24 Stunden angenommene Nachricht ab und setzt sie auf der einheitlichen Chronik des Kontakts auf zugestellt, gelesen oder fehlgeschlagen, sobald der Netzbetreiber zurückmeldet.

Eingehende Kanal-Webhooks

Hier kommen Nachrichten aus SMS-, WhatsApp- und generischen Quellen an. Richten Sie Ihren Anbieter auf den passenden HTTP-Endpunkt von Owlat aus:

Jede eingehende Anfrage wird verifiziert, bevor sie akzeptiert wird — die Kanal-Webhooks verweigern im Zweifel (fail closed), wenn kein Secret konfiguriert ist. Jede Prüfung nutzt die am Kanal hinterlegten Zugangsdaten (Einstellungen → Kanäle) und fällt auf die Umgebungsvariable des Deployments zurück, wenn das Feld leer ist:

• Twilio-Anfragen werden mit einer HMAC-SHA1-Signatur über die kanonische Zeichenfolge aus URL plus sortierten Parametern (X-Twilio-Signature) verifiziert, unter Verwendung des Auth Tokens des SMS-Kanals (Fallback TWILIO_AUTH_TOKEN).
• **Meta-(WhatsApp-)**Anfragen werden mit einer HMAC-SHA256-Signatur des Rohbodys (X-Hub-Signature-256) verifiziert, unter Verwendung des App Secrets des WhatsApp-Kanals (Fallback META_APP_SECRET). Die GET-Challenge wird mit dessen Verify Token beantwortet (Fallback META_VERIFY_TOKEN).
• Generische Anfragen werden über einen zeitkonstanten Vergleich eines gemeinsamen Secrets authentifiziert, das per Header X-Webhook-Secret oder Authorization: Bearer übergeben wird, gegen den Secret Key des Kanals (Fallback GENERIC_WEBHOOK_SECRET).

Existieren sowohl hinterlegte Zugangsdaten als auch eine Umgebungsvariable, gewinnen die hinterlegten — das Rotieren eines Secrets im Formular wirkt sofort, ohne erneutes Deployment.

Trifft eine verifizierte Nachricht ein, findet oder erstellt Owlat dafür einen Kontakt und einen Konversations-Thread und speichert die Nachricht auf der einheitlichen Chronik, wo sie im Team-Postfach erscheint. Jeder Kanal ist ein eigener Identitätsraum: Ein SMS-Absender und ein E-Mail-Kontakt mit demselben Wert sind nicht automatisch derselbe Kontakt — Kontakte, die über SMS, WhatsApp oder generische Kanäle erreicht werden, haben unter Umständen überhaupt keine E-Mail-Adresse. Wie Identitäten aufgelöst werden, beschreibt Zielgruppendaten.

Aktuelle Einschränkungen

Seien Sie genau, was diese Kanäle heute leisten:

• Manueller Versand ist Owner/Admin vorbehalten und nur auf einem aktivierten Kanal möglich. Drei Oberflächen münden in einen Versandpfad (channels.outbound.dispatchOutbound, der den echten Adapter für Twilio / Meta / nachgelagerten Webhook baut): die Antwort des KI-Agenten (processInboundChannel → agent.walker → agentPipeline.sendApprovedReply, abhängig vom Feature-Flag ai.agent), die Schaltfläche Antworten an einer Kanalnachricht in der Thread-Ansicht des Team-Postfachs und der Composer auf der einheitlichen Chronik des Kontakts — die beiden Letzteren jeweils über channels.outbound.sendChannelMessage, das organization:manage verlangt. Ein Mitglied ohne diese Berechtigung sieht keine Antwortmöglichkeit, und E-Mail-Nachrichten ebenso wenig: Diese werden über den Entwurfs-Composer des Threads beantwortet, der die Sendestrecke der MTA nutzt.
• Eine Antwort braucht einen Kontakt und eine Adresse. SMS und WhatsApp werden an die Telefon-/Handle-Identität des Kontakts zugestellt; eine Nachricht von einem Kontakt ohne eine solche hinterlegte Identität wird mit einem klaren Fehler abgelehnt, statt stillschweigend als fehlgeschlagen festgehalten zu werden. Generische Antworten gehen unsigniert per POST an die Endpunkt-URL des Kanals.
• Das Eingangs-Secret des generischen Kanals ist ein gemeinsames Secret, kein HMAC pro Anfrage. Es wird zeitkonstant verglichen, aber wer es besitzt, kann posten; halten Sie den Endpunkt ratenbegrenzt und rotieren Sie den Secret Key, falls er abhandenkommt.
• Gesundheitsprüfungen prüfen nur das Vorhandensein von Zugangsdaten — beim Generic Webhook; SMS und WhatsApp führen für konfigurierte Kanäle eine echte Anbieter-Abfrage healthCheck() aus (Twilio-Konto / Meta-Graph).

Empfangen und triagieren Sie auf diesen Kanälen im Team-Postfach und antworten Sie dort über die Schaltfläche Antworten an der jeweiligen Nachricht — oder über die einheitliche Chronik des Kontakts, wenn Sie die Konversation beginnen möchten.