Website Chat konfigurieren

Konfigurieren Sie Website Chat in Workspace, bevor Entwickler das Widget in eine Storefront oder Website einbinden. Der öffentliche Shop nutzt nur den Widget-Key und das veröffentlichte Widget-Script. Routing, Origins, Verfügbarkeit und interne Bearbeitung bleiben in Workspace.

Chat-Widget-Eingang anlegen

  1. Öffnen Sie System > Chat-Widget-Eingänge.
  2. Erstellen Sie einen neuen Eingang.
  3. Geben Sie einen sprechenden Namen ein, zum Beispiel Shop DE.
  4. Wählen Sie die verantwortliche Gruppe, die neue Website-Konversationen übernehmen soll.
  5. Tragen Sie die erlaubten Origins ein, zum Beispiel https://shop.example.
  6. Speichern Sie den Eingang.
  7. Aktivieren Sie den Eingang, wenn er live genutzt werden soll.
  8. Kopieren Sie den öffentlichen Schlüssel für die Website-Einbindung.

Geben Sie Entwicklern nur den öffentlichen Widget-Key und die erlaubte Einbettungsanleitung. Geben Sie keine Tenant-ID, interne Widget-ID, Gruppen-ID, Queue-ID oder Konversations-ID weiter.

Origins pflegen

Tragen Sie jede Website-Origin ein, von der das Widget genutzt werden darf. Eine Origin enthält Schema, Host und optional Port, aber keinen Pfad:

text
https://www.example.com
https://shop.example.com
https://staging-shop.example.com

Verwenden Sie leere Origins nicht als normale Produktionskonfiguration. Eine enge Allowlist verhindert, dass fremde Websites Ihren öffentlichen Widget-Key einfach mitnutzen.

Routing und Verfügbarkeit steuern

Die verantwortliche Gruppe bestimmt, welches interne Team neue Website-Konversationen standardmäßig sieht oder übernimmt. Prüfen Sie vor dem Livegang:

  • Hat die Gruppe echte Bearbeiterinnen und Bearbeiter?
  • Haben diese Personen Zugriff auf CRM > Konversationen?
  • Ist der Eingang aktiv?
  • Passt der Verfügbarkeitsmodus zur gewünschten Anzeige?

Im Verfügbarkeitsmodus Automatisch wird das Widget nur verfügbar, wenn Operator-Präsenz erkannt wird. Erzwingend an hält den Eingang erreichbar. Erzwingend aus blendet ihn aus, auch wenn Operatoren aktiv sind.

Benachrichtigungen für Service-Mitarbeiter

Workspace kann für neue externe Chat-Nachrichten eine generische Betriebssystem-Benachrichtigung an registrierte Geräte senden. Der Server prüft dabei bei der Zustellung erneut, ob die Zielperson die Unterhaltung über ACL, Queue-/Zuweisungsregeln und die Berechtigung conversation:read sehen darf.

Für Hintergrund-Benachrichtigungen braucht die Installation eine aktive App-Platform-Registration für die verwendete App-ID. Diese Registration muss chat und pushNotifications in capabilities aktivieren, die Plattform in allowedPlatforms erlauben und in pushProviderPolicy die passende Provider-Konfiguration mit Secret-Referenzen hinterlegen.

Die erste unterstützte Strecke ist Android über FCM. iOS und macOS nutzen APNs, sobald die jeweilige App-Verteilung und Provider-Konfiguration freigegeben sind. Die Push-Nutzlast enthält nur Typ, Tenant, Conversation, Message, primären Kanal und Zeitpunkt; der Nachrichtentext bleibt auf dem Server.

Widget-Key rotieren

Rotieren Sie den öffentlichen Schlüssel, wenn ein Key versehentlich veröffentlicht wurde, wenn eine Agentur wechselt oder wenn eine Website aus dem Scope fällt.

  1. Öffnen Sie den Chat-Widget-Eingang.
  2. Nutzen Sie Kennung ersetzen.
  3. Kopieren Sie den neuen öffentlichen Schlüssel.
  4. Aktualisieren Sie das data-widget-key in der Website.
  5. Prüfen Sie den alten Einbau und entfernen Sie ihn aus nicht mehr genutzten Seiten.

Nach einer Rotation funktioniert ein Embed mit altem Key nicht mehr zuverlässig. Planen Sie die Umstellung deshalb mit der Website-Auslieferung.

Entwickler weiterleiten

Die technische Einbindung beschreibt Website Chat einbinden.

Entwickler binden das offizielle Script ein und setzen den öffentlichen Widget-Key als data-widget-key. Sie sollen keine internen Chat- oder Conversation-APIs nachbauen.

Fehler prüfen

Wenn der Chat auf der Website nicht erscheint oder nicht startet, prüfen Sie:

  • Ist chat.public.enabled aktiv?
  • Ist der Chat-Widget-Eingang aktiv?
  • Ist die Website-Origin in der Allowlist enthalten?
  • Ist der öffentliche Widget-Key aktuell?
  • Ist der Verfügbarkeitsmodus passend gesetzt?
  • Gibt es Operator-Präsenz, wenn der Modus Automatisch verwendet wird?
  • Haben Bearbeiter Zugriff auf die interne Konversationsansicht?

Geben Sie bei Supportfällen keine Conversation Tokens weiter. Nennen Sie stattdessen Widget-Name, öffentliche Origin, Zeitpunkt, HTTP-Status und ob es um Script, Status, Bootstrap, Nachricht, Stream oder Leave ging.