Visuelle Schritt-für-Schritt-Anleitung

sem.chat Dokumentation

Ein Screenshot-gestütztes SEMJAT-Handbuch, das auf dem echten sem.chat-Dashboard-Ablauf basiert. In jeder Anleitung erfahren Sie, worauf Sie klicken müssen, was nach dem Klicken passieren soll, wie Sie es testen, wie Sie Fehler beheben und was als Nächstes zu tun ist.

Keine passenden Anleitungen gefunden. Versuchen Sie es mit einem kürzeren Schlüsselwort wie Widget, API, Voice, Billing, Webhook, WordPress, SendPulse oder Scheduling.
Screenshot-Hinweis: Jedes Bild in diesem Handbuch wurde aus der echten sem.chat-App mit einem Demo-Arbeitsbereich aufgenommen. Sensible Kontodaten, Kundendaten, API-Schlüssel, Zahlungsdetails und private Gesprächsinhalte werden vor der Veröffentlichung maskiert.
01

Erste Schritte

Erstellen Sie das Konto, schließen Sie das Onboarding ab, verstehen Sie das Dashboard, erstellen Sie den ersten Bot, testen Sie ihn privat, installieren Sie ihn und wählen Sie den richtigen Plan aus.

/authAnmeldung, Testversion und erster Bot
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Beginnen Sie mit der Registrierung oder Anmeldung über die öffentliche Website oder App.
2Überprüfen Sie die E-Mail-Adresse, bevor Sie sich auf Benachrichtigungen oder Rechnungsnachrichten verlassen.
3Nutzen Sie Onboarding, um den ersten Bot zu erstellen, bevor Sie das Dashboard öffnen.
/ÜbersichtÜbersicht nach dem Login
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Verwenden Sie Schnellaktionen, um einen Bot zu erstellen, Bots anzuzeigen, Analysen zu öffnen oder die Abrechnung zu verwalten.
2Überprüfen Sie aktive Bots, conversations, Sprachminuten und Zufriedenheit, bevor Sie Änderungen vornehmen.
3Überprüfen Sie nach jedem Einrichtungstest die aktuelle Aktivität.
Erster Start

Melden Sie sich an, starten Sie die Testversion und machen Sie sich mit dem Dashboard vertraut

Wozu dient das: Verwenden Sie diesen Workflow für einen brandneuen Arbeitsbereich oder beim Onboarding eines Teamkollegen, der sem.chat noch nie verwendet hat.

Bevor Sie beginnen
  • Verwenden Sie eine geschäftliche E-Mail-Adresse, die Bestätigungs- und Rechnungs-E-Mails empfangen kann.
  • Entscheiden Sie, wem der Arbeitsbereich gehören soll, bevor Sie den Rest des Teams einladen.
  • Halten Sie eine sichere Test-Website oder Staging-Seite für die Widget-Installation bereit.
1

Öffnen Sie die App-Anmeldeseite

Gehen Sie über die Schaltfläche „Anmelden/Registrieren“ auf der Website zu app.sem.chat/auth.

Erwartetes Ergebnis: Auf der Authentifizierungsseite werden Anmelde- und Kontoerstellungsoptionen angezeigt.
2

Erstellen Sie das Konto

Geben Sie die geschäftliche E-Mail-Adresse ein, erstellen Sie das Passwort und senden Sie das Anmeldeformular ab.

Erwartetes Ergebnis: Die App fordert eine Verifizierung an oder geht nach der Annahme des Kontos in das Onboarding über.
3

Überprüfen Sie die E-Mail

Öffnen Sie die Bestätigungs-E-Mail und klicken Sie auf den Bestätigungslink.

Erwartetes Ergebnis: Das Konto kann Abrechnungs-, Einladungs-, Berichts- und Warnmeldungen empfangen.
4

Komplettes Onboarding

Geben Sie den Firmennamen ein, beschreiben Sie das Ziel des Assistenten, wählen Sie eine Startfarbe und erstellen Sie den ersten Bot.

Erwartetes Ergebnis: Der Arbeitsbereich wird mit einem Bot-Entwurf und einem aktiven Teststatus geöffnet.
5

Übersicht öffnen

Klicken Sie in der linken Seitenleiste auf Übersicht.

Erwartetes Ergebnis: Das Dashboard zeigt usage-Karten, Schnellaktionen und aktuelle Aktivitäten.
6

Wählen Sie die nächste Aktion

Verwenden Sie „Neuen Bot erstellen“ für die Einrichtung, „Alle Bots anzeigen“ für die Verwaltung, „Analyse“ für die Leistung oder „Abrechnung“ für Planlimits.

Erwartetes Ergebnis: Anhand des Zustands des Arbeitsbereichs wissen Sie, wo Sie fortfahren müssen.
So testen Sie es: Erstellen Sie einen privaten Testbot und senden Sie eine Testnachricht, bevor Sie Teamkollegen einladen. Bestätigen Sie die Änderungen der Übersichtsaktivität nach dem Test.
ProblemBeheben
Die Bestätigungs-E-Mail kommt nicht anÜberprüfen Sie den Spam, bestätigen Sie die Schreibweise der E-Mail und fordern Sie dann eine weitere Bestätigungs-E-Mail an.
Das Dashboard wird unter „Abrechnung“ geöffnetFür den Arbeitsbereich ist möglicherweise eine aktive Testversion oder ein aktiver Plan erforderlich. Starten Sie die Testversion oder wählen Sie vor der Einrichtung den richtigen Plan aus.
Ein Teamkollege kann nicht auf den Arbeitsbereich zugreifenLaden Sie sie über „Einstellungen“ und „Team“ ein, anstatt den Eigentümer-Login zu teilen.

Was als nächstes zu tun ist: Erstellen Sie den ersten Bot, testen Sie ihn privat und installieren Sie dann das Widget auf einer Staging-Seite.

Privater Starttest

Erstellen Sie den ersten privaten Bot-Test, bevor Sie ihn live schalten

Wozu dient das: Verwenden Sie dies, um Konto-, Bot-, Widget- und Verlaufsverfolgung zu überprüfen, bevor Kunden den Assistenten sehen.

Bevor Sie beginnen
  • Halten Sie eine Beispiel-Kundenfrage bereit.
  • Halten Sie eine Staging-Seite oder eine lokale HTML-Testseite bereit.
  • Verwenden Sie im ersten Test keine echten Kundendaten.
1

Öffnen Sie My Bots

Klicken Sie in der Seitenleiste auf My Bots oder verwenden Sie „Alle Bots in der Übersicht anzeigen“.

Erwartetes Ergebnis: Sie können den während des Onboardings erstellten Bot oder einen leeren Zustand mit der Schaltfläche „Neuer Bot“ sehen.
2

Öffnen Sie den Bot Builder

Klicken Sie beim vorhandenen Bot auf „Neuer Bot“ oder „Bearbeiten“.

Erwartetes Ergebnis: Das Bot Builder wird mit den Steuerelementen „Grundlagen“, „Widget“, „Wissen“, „Sprache“ und „Integration“ geöffnet.
3

Speichern Sie den Bot einmal

Geben Sie den erforderlichen Bot-Namen und die erste Nachricht ein und klicken Sie dann auf Speichern.

Erwartetes Ergebnis: Der Bot erhält eine gültige ID und kann Einbettungscode generieren.
4

Private Vorschau

Nutzen Sie das Vorschaufenster und stellen Sie Ihre Beispielfrage.

Erwartetes Ergebnis: Die Antwort sollte mit Ihren Anweisungen übereinstimmen oder verraten, welches Wissen fehlt.
5

Auf Staging installieren

Öffnen Sie Embed, kopieren Sie das Snippet HTML und fügen Sie es vor dem schließenden Body-Tag auf der Staging-Seite ein.

Erwartetes Ergebnis: Das Widget erscheint in der konfigurierten Ecke auf Desktop- und Mobilgeräten.
6

Bestätigen Sie die Sendungsverfolgung

Öffnen Sie nach dem Testgespräch den Posteingang oder Chat History.

Erwartetes Ergebnis: Die Testkonversation wird mit dem richtigen Bot, Kanal und Nachrichtenverlauf angezeigt.
So testen Sie es: Senden Sie eine Textnachricht und einen Sprachtest, wenn die Sprachfunktion aktiviert ist. Bestätigen Sie, dass beide in Chat History erscheinen.
ProblemBeheben
Der Einbettungscode ist nicht verfügbarSpeichern Sie zuerst den Bot. Wenn die Sprachsynchronisierung noch aussteht, warten Sie auf die Synchronisierung oder speichern Sie erneut, nachdem die erforderlichen Felder ausgefüllt sind.
Das Widget zeigt den falschen Bot anBestätigen Sie, dass data-bot-id im Snippet mit der Bot-ID aus dem Embed-Modal übereinstimmt.
Im Verlauf wird keine Konversation angezeigtAktualisieren Sie Chat History, bestätigen Sie, dass der Bot aktiv ist, und stellen Sie sicher, dass der Test auf dem installierten Widget stattgefunden hat und nicht auf einer veralteten Seite.

Was als nächstes zu tun ist: Fahren Sie mit der Einrichtung und Wissensschulung von Bot Builder fort.

02

Erstellen und konfigurieren Sie einen Bot

Erstellen, Bearbeiten, Vorschau, Aktivieren, Übertragen oder Entfernen von Bots aus My Bots und Bot Builder.

/dashboardMy Bots Kontrollzentrum
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Klicken Sie auf Neuer Bot, um einen neuen Assistenten zu starten.
2Verwenden Sie auf jeder Bot-Karte Bearbeiten, Einbetten, Übertragen, Aktivieren oder Löschen.
3Überprüfen Sie vor dem Test den aktiven Status und den Zeitpunkt der letzten Aktualisierung.
/bots/:id/editBot Builder Registerkarte „Grundlagen“.
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Geben Sie den Namen des Bots, den Avatar, die erste Nachricht und die Systemanweisungen ein.
2Verwenden Sie die Vorschau zum Testen vor der Veröffentlichung.
3Speichern und synchronisieren Sie, bevor Sie den Einbettungscode kopieren.
Bot erstellen

Erstellen Sie einen neuen Bot aus My Bots

Wozu dient das: Verwenden Sie diesen Workflow, wenn eine neue Marke, Website, Support-Warteschlange oder Kampagne einen eigenen Assistenten benötigt.

Bevor Sie beginnen
  • Bereiten Sie den Namen des Bots, das Ziel, die erste Nachricht und zwei oder drei Beispielfragen vor.
  • Sammeln Sie die öffentliche Website URL, wenn Sie Inhalte importieren möchten.
  • Bestätigen Sie, dass der Plan die Anzahl der Bots und Sprach-/Avatarfunktionen zulässt, die Sie benötigen.
1

Öffnen Sie My Bots

Klicken Sie in der Seitenleiste auf My Bots.

Erwartetes Ergebnis: Vorhandene Bots und die Schaltfläche „Neuer Bot“ sind sichtbar.
2

Klicken Sie auf Neuer Bot

Starten Sie einen neuen Bot auf der Seite My Bots.

Erwartetes Ergebnis: Bot Builder wird mit einem Entwurfsassistenten geöffnet.
3

Legen Sie die Bot-Identität fest

Geben Sie den Bot-Namen ein, laden Sie einen Avatar hoch oder wählen Sie ihn aus und schreiben Sie die erste Nachricht, die Besucher sehen.

Erwartetes Ergebnis: Im Vorschaufenster werden der Name, der Avatar und die Begrüßung des Assistenten angezeigt.
4

Schreiben Sie Systemanweisungen

Beschreiben Sie, was der Bot tun soll, wie er sprechen soll, was er vermeiden soll und wann er um menschliche Hilfe bitten soll.

Erwartetes Ergebnis: Der Assistent hat klare Verhaltensregeln, bevor Wissen hinzugefügt wird.
5

Grundwissen hinzufügen

Fügen Sie wichtige Unternehmens-, Produkt-, Support-, Preis- und Kontaktinformationen in den Wissensbereich ein.

Erwartetes Ergebnis: Der Bot kann häufige Fragen beantworten, ohne dass ein Website-Import erforderlich ist.
6

Speichern Sie den Bot

Klicken Sie auf Speichern und warten Sie auf die gespeicherte oder synchronisierte Bestätigung.

Erwartetes Ergebnis: Der Bot verfügt über eine stabile ID, die Vorschau kann getestet werden und Einbettungsoptionen werden verfügbar.
7

Vorschau des Ergebnisses

Stellen Sie die vorbereiteten Beispielfragen in der Vorschau.

Erwartetes Ergebnis: Die Antworten sollten den Anweisungen folgen und das von Ihnen eingegebene Wissen nutzen.
8

Nur aktivieren, wenn Sie bereit sind

Aktivieren Sie den Bot, nachdem der private Test bestanden wurde.

Erwartetes Ergebnis: Der Bot ist bereit für Widget- oder Kanalverkehr.
So testen Sie es: Stellen Sie mindestens fünf realistische Fragen. Überprüfen Sie, ob die Antwort richtig ist, ob sie der Marke entspricht und ob sie bei Bedarf um menschliche Hilfe bittet.
ProblemBeheben
Die Antwort ist zu allgemeinFügen Sie spezifischeres Wissen hinzu und schreiben Sie die Anweisungen mit Beispielen für gute Antworten neu.
Der Bot lehnt Fragen ab, die er beantworten sollteEntfernen Sie zu strenge Anweisungen und fügen Sie vertrauenswürdiges Wissen zu diesem Thema hinzu.
Beim Speichern wird kein Einbettungscode generiertÜberprüfen Sie die erforderlichen Felder und speichern Sie sie erneut, nachdem die Synchronisierung mit dem Sprachanbieter abgeschlossen ist.

Was als nächstes zu tun ist: Konfigurieren Sie die Widget-Einstellungen, fügen Sie Website-Wissen hinzu und installieren Sie dann den Bot.

Bots verwalten

Bearbeiten, klonen Sie den Workflow, übertragen, deaktivieren oder löschen Sie einen Bot

Wozu dient das: Verwenden Sie diesen Workflow, wenn ein Bot Updates, Eigentümerwechsel, vorübergehende Pause oder dauerhafte Entfernung benötigt.

Bevor Sie beginnen
  • Exportieren Sie alle Gesprächs- oder Kontaktdaten, die Sie behalten müssen, bevor Sie einen Bot löschen.
  • Stellen Sie sicher, dass der Bot nicht in eine Live-Website eingebettet ist, bevor Sie ihn löschen oder übertragen.
  • Informieren Sie Ihre Teamkollegen, bevor Sie einen Produktions-Bot deaktivieren.
1

Öffnen Sie My Bots

Suchen Sie die Bot-Karte nach Name oder Status.

Erwartetes Ergebnis: Die Karte zeigt den aktuellen Status und die verfügbaren Aktionen.
2

Klicken Sie auf Bearbeiten

Öffnen Sie den Bot Builder und nehmen Sie die erforderlichen Änderungen vor.

Erwartetes Ergebnis: Der Editor lädt die aktuelle Konfiguration.
3

Speichern und erneut testen

Klicken Sie nach jeder Materialänderung auf „Speichern“ und führen Sie dann Vorschaufragen aus.

Erwartetes Ergebnis: Die gespeicherte Konfiguration wird von der Vorschau und dem installierten Widget verwendet.
4

Vorübergehend deaktivieren

Verwenden Sie den aktiven Schalter, wenn der Bot vorerst keine Besucher mehr verarbeiten soll.

Erwartetes Ergebnis: Der Bot stellt die Bereitstellung von Live-Verkehr ein, behält jedoch die Konfiguration bei.
5

Eigentum übertragen

Verwenden Sie „Übertragen“, geben Sie die E-Mail-Adresse des Empfängers ein und bestätigen Sie.

Erwartetes Ergebnis: Das ausgewählte Konto erhält das Eigentum gemäß dem App-Übertragungsablauf.
6

Erst nach Überprüfung löschen

Verwenden Sie „Löschen“, lesen Sie die Warnung und bestätigen Sie sie erst, wenn der Bot nicht mehr benötigt wird.

Erwartetes Ergebnis: Der Bot und die zugehörige Konfiguration werden gemäß der Warnung entfernt.
So testen Sie es: Öffnen Sie nach der Bearbeitung das installierte Widget und stellen Sie genau die Frage, die die Änderung motiviert hat. Bestätigen Sie, dass sich die Live-Antwort geändert hat.
ProblemBeheben
Die alte Antwort wird immer noch angezeigtAktualisieren Sie die Website-Seite, bestätigen Sie, dass Sie den richtigen Bot gespeichert haben, und prüfen Sie, ob importiertes Wissen synchronisiert werden muss.
Die Übertragung schlägt fehlBestätigen Sie, dass die E-Mail-Adresse des Empfängers gültig ist und dass das Zielkonto den Bot akzeptieren kann.
Es wurde versehentlich auf „Löschen“ geklicktStoppen Sie vor der endgültigen Bestätigung. Es liegen Löschwarnungen vor, da die Aktion möglicherweise Bot-Daten dauerhaft entfernt.

Was als nächstes zu tun ist: Überprüfen Sie Analysen und Verlauf nach Live-Änderungen, um sicherzustellen, dass sich das Besuchererlebnis verbessert.

03

Installieren Sie das Widget

Kopieren Sie den richtigen Einbettungscode, installieren Sie ihn in den Kontexten HTML, WordPress, React oder erweitert SDK und überprüfen Sie dann das Desktop- und Mobilverhalten.

Modal einbettenKopieren Sie das Installations-Snippet der Website
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Wählen Sie HTML, WordPress, React oder NPM/SDK basierend auf dem Site-Stack.
2Kopieren Sie den Code, nachdem der Bot gespeichert und synchronisiert wurde.
3Fügen Sie das Snippet vor dem schließenden Body-Tag oder in das Framework-Layout ein.
HTML installieren

Installieren Sie das Widget auf einer Standard-HTML-Website

Wozu dient das: Verwenden Sie dies, wenn Sie die Seitenvorlage, die Themenfußzeile oder das globale HTML-Layout bearbeiten können.

Bevor Sie beginnen
  • Speichern Sie zuerst den Bot, damit das Einbettungsmodal eine echte Bot-ID hat.
  • Nutzen Sie vor der Produktion eine Staging-Site.
  • Behalten Sie die genaue Skriptversion und data-bot-id aus dem Modal bei.
1

Öffnen Sie My Bots

Suchen Sie den Bot, den Sie installieren möchten, und klicken Sie auf Einbetten.

Erwartetes Ergebnis: Das Einbettungsmodal wird mit Installationsregisterkarten geöffnet.
2

Wählen Sie HTML

Wählen Sie die Registerkarte HTML und klicken Sie auf Code kopieren.

Erwartetes Ergebnis: Das Widget-Skript wird mit angehängter Bot-ID kopiert.
3

Öffnen Sie die Website-Vorlage

Bearbeiten Sie die globale Fußzeile oder Layoutdatei, die auf jeder Seite gerendert wird, auf der das Widget erscheinen soll.

Erwartetes Ergebnis: Sie bearbeiten die freigegebene Site-Shell und nicht eine einzelne isolierte Seite, es sei denn, dies ist beabsichtigt.
4

Vor dem Schließen des Körpers einfügen

Fügen Sie das Snippet unmittelbar vor dem schließenden Body-Tag ein.

Erwartetes Ergebnis: Das Skript lädt nach dem Seiteninhalt und kann den Widget-Container mounten.
5

Veröffentlichen oder bereitstellen

Speichern Sie die Vorlage und stellen Sie die Site bereit.

Erwartetes Ergebnis: Das Widget-Skript ist auf den Zielseiten live.
6

Testen Sie Desktop und Mobilgeräte

Öffnen Sie die Site in einem neuen Browserfenster und in einem mobilen Ansichtsfenster.

Erwartetes Ergebnis: Das Widget erscheint an der konfigurierten Position und wird ohne Konsolenfehler geöffnet.
So testen Sie es: Senden Sie eine Nachricht von der Live-Seite, öffnen Sie dann den Posteingang und Chat History, um zu bestätigen, dass die Konversation zum richtigen Bot gehört.
ProblemBeheben
Widget fehltStellen Sie sicher, dass sich der Code vor dem schließenden Body-Tag befindet, Skripte nicht vom Site Builder blockiert werden und der Bot aktiv ist.
Falscher Bot erscheintKopieren Sie das Snippet erneut und vergleichen Sie data-bot-id mit dem gewünschten Bot.
Widget überlappt SeitensteuerelementeÄndern Sie Position oder Größe in den Widget-Einstellungen und testen Sie es erneut auf dem Mobilgerät.

Was als nächstes zu tun ist: Passen Sie die Widget-Einstellungen und die Lead-Erfassung nach der Installation an.

HTML einbetten
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Plattforminstallation

Installieren Sie es in WordPress, React oder erweiterten Sprachflüssen SDK

Wozu dient das: Verwenden Sie dies, wenn die Website von einem CMS, einer React-App oder einer benutzerdefinierten Sprachintegration verwaltet wird.

Bevor Sie beginnen
  • Wissen Sie, welcher Stack das gemeinsame Layout besitzt.
  • Verwenden Sie für den ausgewählten Bot genau das in sem.chat angezeigte Snippet.
  • Bestätigen Sie für die erweiterte Verwendung von SDK, dass Sie über den erforderlichen öffentlichen Schlüssel Vapi und die Assistenten-ID verfügen.
1

Option WordPress

Verwenden Sie Appearance, Theme Editor, footer.php oder ein vertrauenswürdiges Kopf- und Fußzeilen-Plugin.

Erwartetes Ergebnis: Das Snippet wird auf öffentlichen WordPress-Seiten geladen.
2

Option React

Erstellen Sie eine kleine ChatWidget-Komponente, hängen Sie das Skript in useEffect an und rendern Sie es im Stammlayout.

Erwartetes Ergebnis: Das Widget wird einmal geladen und bereinigt, wenn die Bereitstellung des Layouts aufgehoben wird.
3

Erweiterte Option SDK

Verwenden Sie die Registerkarte NPM/SDK nur, wenn Sie über das Standard-Widget hinaus benutzerdefinierte Steuerelemente für Sprachanrufe benötigen.

Erwartetes Ergebnis: Ihre App steuert die Sprachsitzung, während sem.chat die konfigurierte Assistentenquelle bleibt.
4

Bot-ID überprüfen

Bestätigen Sie, dass der installierte Code auf die Bot-ID aus dem Einbettungsmodal verweist.

Erwartetes Ergebnis: Das Live-Widget stellt eine Verbindung zum vorgesehenen Assistenten her.
5

Überprüfen Sie die Konsole

Öffnen Sie die Browser-Entwicklertools und laden Sie sie neu.

Erwartetes Ergebnis: Es liegen keine blockierten Skript-, Duplikat-Container- oder Netzwerkfehler vor.
So testen Sie es: Vervollständigen Sie eine Testnachricht von der installierten Site und bestätigen Sie dann, dass sie im Posteingang mit der erwarteten Seite URL angezeigt wird.
ProblemBeheben
React lädt doppelte WidgetsSchützen Sie das Einfügen von Skripten mit einer Referenz oder rendern Sie die Komponente nur im Stammlayout.
WordPress entfernt Skript-TagsVerwenden Sie ein Footer-Injection-Plugin oder eine Theme-Datei, die Skripte ermöglicht.
SDK Anruf kann nicht gestartet werdenÜberprüfen Sie den öffentlichen Schlüssel, die Assistenten-ID, die Browserberechtigungen und planen Sie den Sprachzugriff.

Was als nächstes zu tun ist: Wechseln Sie zu den Widget-Einstellungen, um Verhalten, Branding und Lead-Erfassung zu steuern.

WordPress Fußzeilenausschnitt
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
React Komponente
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Erweiterte Stimme SDK
npm install @vapi-ai/web

import Vapi from '@vapi-ai/web';

const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');

vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04

Widget-Einstellungen

Konfigurieren Sie Modus, Thema, Größe, Position, Farbe, Branding, Reaktionen, Ton, Einwilligung, Lead-Erfassung, Bewertungen, Folge-E-Mail und Aktivierungsstatus.

Bot Builder / WidgetWidget-Erscheinungsbild und Besucherverhalten
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Wählen Sie chat, Sprache oder Hybridmodus.
2Legen Sie Thema, Farbe, Position, Größe, Branding, Einwilligung und Ton fest.
3Konfigurieren Sie Lead-Erfassung, Bewertungen, Reaktionen und Follow-up-Verhalten.
Widget-Verhalten

Konfigurieren Sie das Verhalten des besucherorientierten Widgets

Wozu dient das: Verwenden Sie dies nach der ersten Installation oder immer dann, wenn das Widget zur Website passen und bessere Leads erfassen muss.

Bevor Sie beginnen
  • Installieren Sie das Widget auf einer Staging-Seite.
  • Finden Sie heraus, ob Besucher mit chat, Sprache oder beidem beginnen sollten.
  • Bereiten Sie die Einwilligung und eine Kopie der Lead-Erfassung vor, falls dies für die Region erforderlich ist.
1

Öffnen Sie den Bot Builder

Öffnen Sie My Bots, klicken Sie auf Bearbeiten und wählen Sie dann die Registerkarte Widget.

Erwartetes Ergebnis: Für den ausgewählten Bot werden Widget-Steuerelemente angezeigt.
2

Wählen Sie den Modus

Wählen Sie je nach gewünschtem Besuchererlebnis Chat, Sprache oder Hybrid.

Erwartetes Ergebnis: Die Vorschau ändert sich und zeigt den ausgewählten Modus an.
3

Aussehen festlegen

Wählen Sie Thema, Farbe, Größe, Schaltflächenposition und Branding-Optionen.

Erwartetes Ergebnis: Das Widget passt zur Website, ohne wichtige Inhalte abzudecken.
4

Aktivieren Sie Besucherkontrollen

Schalten Sie Reaktionen, Töne, Bewertungen und Einwilligungsaufforderungen ein oder aus.

Erwartetes Ergebnis: Besucher sehen nur die Steuerelemente, die sie verwenden sollen.
5

Konfigurieren Sie die Lead-Erfassung

Wählen Sie Pflichtfelder, optionales Beschreibungsfeld und wann das Formular angezeigt wird.

Erwartetes Ergebnis: Kontakte werden je nach Einrichtung vor oder während conversations erfasst.
6

Legen Sie eine Folge-E-Mail fest

Konfigurieren Sie das Folge-E-Mail-Verhalten, wenn Ihr Plan dies vorsieht.

Erwartetes Ergebnis: Besucher können nach der Lösung von conversations Folgenachrichten erhalten.
7

Speichern und testen

Klicken Sie auf Speichern, laden Sie die Staging-Seite neu und öffnen Sie das Widget.

Erwartetes Ergebnis: Das Live-Widget entspricht den gespeicherten Einstellungen.
So testen Sie es: Öffnen Sie das Widget auf dem Desktop und auf Mobilgeräten, senden Sie ein Lead-Formular, geben Sie eine Bewertung ab und bestätigen Sie, dass der Kontakt und das Gespräch aufgezeichnet werden.
ProblemBeheben
Die Farbe wurde nicht aktualisiertSpeichern Sie den Bot, aktualisieren Sie die Website hart und bestätigen Sie, dass das installierte Widget dieselbe Bot-ID verwendet.
Lead-Felder fehlenBestätigen Sie, dass die Lead-Erfassung aktiviert ist und die ausgewählte Auslösebedingung erfüllt ist.
Besucher können keine Stimme verwendenÜberprüfen Sie die Spracheinstellungen, die Browser-Mikrofonberechtigung, den Zugriffsplan und die Sprachminutenbegrenzungen.

Was als nächstes zu tun ist: Fügen Sie Sprach-/Avatar-Einstellungen und Wissensquellen vor Produktionsstart hinzu.

05

Stimme und Avatare

Wählen Sie Standardstimmen aus, konfigurieren Sie Sprachmodus und -beschränkungen, lesen Sie Transkripte, klonen Sie Stimmen, weisen Sie geklonte Stimmen zu und verwalten Sie Standard- oder benutzerdefinierte Avatare.

Bot Builder / StimmeStimme, Grenzen, Transkripte und Avatare
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Wählen Sie eine Standardstimme oder eine gespeicherte geklonte Stimme.
2Legen Sie Sprachminutenlimits und die Speicherung von Transkripten fest.
3Wählen Sie Standard-Avatare oder laden Sie einen benutzerdefinierten Avatar hoch, wenn der Plan dies zulässt.
Spracheinrichtung

Richten Sie Sprachanrufe und Transkripte ein

Wozu dient das: Verwenden Sie dies, wenn Besucher mit dem Bot sprechen sollen, anstatt nur zu tippen.

Bevor Sie beginnen
  • Bestätigen Sie, dass der Plan Sprachminuten und die gewünschten Sprach-/Avatar-Optionen enthält.
  • Verwenden Sie zum Testen eine ruhige Browserumgebung.
  • Bereiten Sie eine realistische Support- oder Vertriebsfrage vor, die Sie per Spracheingabe testen können.
1

Öffnen Sie die Spracheinstellungen

Öffnen Sie den Bot Builder und wählen Sie den Bereich „Stimme“ oder „Stimme und Avatare“ aus.

Erwartetes Ergebnis: Sprachsteuerung und aktuelle Sprachauswahl sind sichtbar.
2

Wählen Sie eine Standardstimme aus

Sehen Sie sich die verfügbaren Stimmen in der Vorschau an, wählen Sie die am besten geeignete aus und speichern Sie die Auswahl.

Erwartetes Ergebnis: Der Bot verwendet die gewählte Stimme für Anrufe.
3

Konfigurieren Sie den Sprachmodus

Verwenden Sie die Widget-Einstellungen, um „Sprache“ oder „Hybrid“ auszuwählen, wenn den Besuchern Sprache zur Verfügung stehen soll.

Erwartetes Ergebnis: Besucher sehen im Widget eine Sprachoption.
4

Legen Sie Sprachbeschränkungen fest

Definieren Sie Grenzwerte pro Benutzer oder Arbeitsbereich, sofern verfügbar.

Erwartetes Ergebnis: Lange oder wiederholte Anrufe dürfen nicht mehr Minuten in Anspruch nehmen als vorgesehen.
5

Transkripte aktivieren

Aktivieren Sie die Transkriptspeicherung, wenn Sie eine Anrufüberprüfung im Verlauf benötigen.

Erwartetes Ergebnis: Sprachanrufe erstellen nach der Sitzung lesbare Transkripte.
6

Testen Sie einen Anruf

Öffnen Sie das Widget, erlauben Sie den Mikrofonzugriff, starten Sie einen Anruf und stellen Sie die vorbereitete Frage.

Erwartetes Ergebnis: Der Bot antwortet per Stimme und der Anruf wird sauber beendet.
7

Lesen Sie das Transkript

Öffnen Sie Chat History und suchen Sie nach der Sprachkonversation.

Erwartetes Ergebnis: Das Transkript zeigt, was der Besucher und der Bot gesagt haben.
So testen Sie es: Führen Sie einen kurzen Anruf durch und bestätigen Sie, dass Sprachprotokoll, Transkript und Gesprächsmodus aufgezeichnet werden.
ProblemBeheben
Browser blockiert MikrofonErlauben Sie die Mikrofonberechtigung im Browser und laden Sie die Seite neu.
Die Sprachoption ist gesperrtÖffnen Sie „Abrechnung“ und bestätigen Sie, dass der Workspace-Plan Sprachfunktionen umfasst.
Das Transkript ist leerBestätigen Sie, dass das Speichern des Transkripts aktiviert ist und der Anruf normal beendet wurde.

Was als nächstes zu tun ist: Fügen Sie Wissen hinzu oder verfeinern Sie es, damit Sprachantworten korrekt sind.

Sprachklon und Avatar

Klonen Sie eine Stimme und weisen Sie einen benutzerdefinierten Avatar zu

Wozu dient das: Verwenden Sie dies, wenn der Assistent eine Markenstimme oder ein sprechendes Avatar-Erlebnis benötigt.

Bevor Sie beginnen
  • Verwenden Sie nur Audio- und Bilddateien, zu deren Verwendung Sie berechtigt sind.
  • Nehmen Sie saubere Sprachproben mit geringem Hintergrundrauschen auf.
  • Bestätigen Sie die Plangrenzen für geklonte Stimmen und benutzerdefinierte Avatare.
1

Öffnen Sie Voice Cloning

Klicken Sie im Bereich „Stimme“ auf „Stimme klonen“.

Erwartetes Ergebnis: Im Upload-Dialog werden die akzeptierten Beispielanforderungen angezeigt.
2

Laden Sie Beispiele hoch

Laden Sie ein bis fünf klare Aufnahmen hoch und senden Sie die Klonanfrage.

Erwartetes Ergebnis: Die geklonte Stimme erscheint nach der Verarbeitung oder der Dialog zeigt die nächste Anforderung an.
3

Weisen Sie die geklonte Stimme zu

Wählen Sie die geklonte Stimme in der Stimmenauswahl aus und speichern Sie sie.

Erwartetes Ergebnis: Zukünftige Anrufe verwenden die geklonte Stimme.
4

Wählen Sie einen Standard-Avatar

Wählen Sie einen enthaltenen Avatar aus, wenn kein benutzerdefinierter Avatar-Upload erforderlich ist.

Erwartetes Ergebnis: Das Spracherlebnis hat eine visuelle Identität.
5

Laden Sie einen benutzerdefinierten Avatar hoch

Laden Sie ein klares Gesichtsbild oder ein kurzes Video hoch, wenn Ihr Plan dies unterstützt.

Erwartetes Ergebnis: Der Avatar wird verarbeitet und steht zur Auswahl zur Verfügung.
6

Führen Sie eine vollständige Vorschau aus

Starten Sie einen Sprachanruf und bestätigen Sie gemeinsam das Stimm-, Avatar- und Transkriptverhalten.

Erwartetes Ergebnis: Das Besuchererlebnis entspricht der konfigurierten Marke.
So testen Sie es: Stellen Sie eine kurze Frage mit ausgewählter geklonter Stimme und bestätigen Sie, dass der Anruf die erwartete Stimme/den erwarteten Avatar verwendet.
ProblemBeheben
Die Klonqualität ist schlechtNehmen Sie sauberere Samples mit einem Lautsprecher, stabiler Lautstärke und ohne Musik auf.
Das Hochladen eines benutzerdefinierten Avatars ist nicht verfügbarÜberprüfen Sie die Abrechnung auf die im Plan festgelegten Avatar-Limits.
Die alte Stimme spielt immer nochSpeichern Sie den Bot, nachdem Sie die neue Stimme ausgewählt haben, und laden Sie die Widget-Seite neu.

Was als nächstes zu tun ist: Fahren Sie mit „Wissen und Daten“ fort, damit das Spracherlebnis genaue Antworten liefert.

06

Wissen und Daten

Fügen Sie manuelles Wissen hinzu, importieren Sie Website-Inhalte, wenden Sie Crawling-Ergebnisse an, synchronisieren Sie importierte Inhalte, fügen Sie Produkt-Feeds URLs hinzu, aktualisieren oder entfernen Sie Feeds und überprüfen Sie Antworten mit Testfragen.

Bot Builder / WissenWissensquellen und Antworttests
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Fügen Sie manuelles Wissen für Richtlinien, Preise und Markenregeln hinzu.
2Importieren Sie Website-Seiten und wenden Sie Crawl-Ergebnisse an.
3Fügen Sie Produkt-Feeds hinzu und synchronisieren Sie diese, wenn sich der Lagerbestand ändert.
Wissensquellen

Trainieren Sie den Bot mit manuellen Kenntnissen, Website-Import und Produkt-Feeds

Wozu dient das: Verwenden Sie dies immer dann, wenn der Assistent unvollständige Antworten gibt oder neue Produkt-, Richtlinien- oder Website-Informationen benötigt.

Bevor Sie beginnen
  • Bereiten Sie Quell-URLs und Produkt-Feed-URLs vor.
  • Entscheiden Sie, welche Seiten nicht importiert werden sollen, z. B. Admin- oder private Seiten.
  • Erstellen Sie Testfragen für jedes Thema, das Sie hinzufügen.
1

Offenes Wissen

Öffnen Sie Bot Builder und wählen Sie die Registerkarte Wissen oder Daten.

Erwartetes Ergebnis: Manuelles Wissen, Website-Import und Produkt-Feed-Tools sind sichtbar.
2

Fügen Sie manuelles Wissen hinzu

Fügen Sie prägnante Fakten, Richtlinien, Preise, Kontaktdaten und Hinweise zum Antwortstil ein.

Erwartetes Ergebnis: Der Bot verfügt über eine sofortige vertrauenswürdige Quelle für Antworten mit hoher Priorität.
3

Website-Inhalte importieren

Fügen Sie die öffentliche Website URL ein und starten Sie den Crawl/Import.

Erwartetes Ergebnis: Crawl-Ergebnisse zeigen entdeckte Seiten oder den Importstatus.
4

Überprüfen Sie die Ergebnisse und wenden Sie sie an

Behalten Sie nützliche Seiten bei, entfernen Sie irrelevante Seiten und wenden Sie dann den ausgewählten Inhalt an.

Erwartetes Ergebnis: Nur genehmigte Website-Inhalte gelangen in die Wissensdatenbank.
5

Produkt-Feed URLs hinzufügen

Fügen Sie Google Merchant Center oder den unterstützten Feed URLs ein und importieren Sie ihn.

Erwartetes Ergebnis: Produkte, Preise, Verfügbarkeit und Attribute werden für den Bot verfügbar.
6

Feeds aktualisieren oder entfernen

Verwenden Sie die Aktualisierung, wenn sich Katalogdaten ändern, und entfernen Sie nicht mehr verwendete Feeds.

Erwartetes Ergebnis: Der Bot vermeidet veraltete oder doppelte Produktdaten.
7

Speichern und synchronisieren

Speichern Sie den Bot und warten Sie, bis die Synchronisierung abgeschlossen ist.

Erwartetes Ergebnis: Die neuesten Erkenntnisse werden durch Vorschau- und Live-Widget-Antworten genutzt.
8

Stellen Sie Verifizierungsfragen

Stellen Sie eine Testfrage pro Quelle, die Sie hinzugefügt haben.

Erwartetes Ergebnis: Die Antwort zitiert oder gibt den aktualisierten Inhalt genau wieder.
So testen Sie es: Stellen Sie Fragen zu Preisen, Rückgaben, Verfügbarkeit, Unternehmensinformationen und nicht unterstützten Themen. Bestätigen Sie, dass der Bot bekannte Themen beantwortet und keine unbekannten Details erfindet.
ProblemBeheben
Crawler importiert irrelevante SeitenEntfernen Sie diese Seiten aus ausgewählten Ergebnissen und fügen Sie klarere manuelle Anweisungen hinzu.
Die Produktpreise sind veraltetAktualisieren Sie den Feed und bestätigen Sie, dass der Feed URL selbst aktuelle Werte enthält.
Bot erfindet AntwortenFügen Sie eine Regel hinzu, nach der der Bot sagen soll, dass er sich nicht sicher ist, und menschliche Unterstützung anbieten soll, wenn Wissen fehlt.

Was als nächstes zu tun ist: Kehren Sie zur Vorschau zurück, testen Sie erneut und installieren oder aktualisieren Sie dann das Widget.

07

Posteingang, Live Support, Verlauf, Kontakte

Bearbeiten Sie täglich conversations, fordern Sie Live-Support-Anfragen an, geben Sie die Kontrolle an AI zurück, exportieren Sie den Verlauf, verwalten Sie Kontakte und synchronisieren Sie Kontakte mit SendPulse.

/PosteingangWorkflow für Posteingangskonversationen
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Filtern Sie nach Bot oder Kanal.
2Öffnen Sie ein Gespräch und antworten Sie bei Bedarf als Mensch.
3Verwenden Sie die Übersetzungs-, Auflösungs- und Übergabesteuerungen sorgfältig.
/live-supportLive-Support-Übergabekontrolle
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Fordern Sie wartende Übergaben schnell an.
2Antworten Sie als Agent oder geben Sie das Gespräch an AI zurück.
3Lösen Sie das Problem, wenn der Besucher keine menschliche Hilfe mehr benötigt.
/chat-historyGesprächsverlauf und Exporte
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Suchen Sie nach Besucher, Bot, Kanal oder Datum.
2Öffnen Sie vollständige Transkripte für Text- und Sprachsitzungen.
3Exportieren Sie bei Bedarf CSV oder JSON.
/KontakteKontakte und SendPulse-Export
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Filtern Sie Kontakte nach Bot oder Quelle.
2Öffnen Sie Kontaktdaten und Gesprächskontext.
3Exportieren oder synchronisieren Sie ausgewählte Kontakte nach SendPulse.
Antwort im Posteingang

Öffnen Sie eine Konversation und senden Sie eine menschliche Antwort

Wozu dient das: Verwenden Sie dies, wenn ein Operator von sem.chat aus auf einen Kunden antworten muss, anstatt AI alleine weitermachen zu lassen.

Bevor Sie beginnen
  • Bestätigen Sie, dass der Bediener Zugriff auf den Bot oder Arbeitsbereich hat.
  • Lesen Sie das Gespräch, bevor Sie antworten.
  • Wissen Sie, ob der Besucher die gleiche Sprache erwartet.
1

Posteingang öffnen

Klicken Sie in der Seitenleiste auf Posteingang.

Erwartetes Ergebnis: Aktuelle conversations werden mit Bot, Kanal, Besucher, Status und Uhrzeit angezeigt.
2

Filtern Sie bei Bedarf

Verwenden Sie Kanal-, Bot-, Ungelesen- oder Statusfilter, um die Konversation zu finden.

Erwartetes Ergebnis: Die Liste wird auf den Konversationssatz eingegrenzt, den Sie benötigen.
3

Öffnen Sie das Gespräch

Klicken Sie auf die Besucherzeile.

Erwartetes Ergebnis: Der vollständige Thread, Besucherinformationen und Antwortsteuerelemente sind sichtbar.
4

Bei Bedarf übersetzen

Verwenden Sie Übersetzungskontrollen, wenn sich die Sprache des Besuchers von der Sprache des Agenten unterscheidet.

Erwartetes Ergebnis: Der Agent kann verstehen und angemessen antworten.
5

Senden Sie eine Antwort

Schreiben Sie die menschliche Antwort und senden Sie sie.

Erwartetes Ergebnis: Die Nachricht wird dem Thread als Antwort eines Agenten/Menschen hinzugefügt.
6

Lösen oder offen bleiben

Beenden Sie das Gespräch, wenn es abgeschlossen ist, oder lassen Sie es für eine weitere Bearbeitung offen.

Erwartetes Ergebnis: Der Posteingangsstatus entspricht dem tatsächlichen Kundenstatus.
So testen Sie es: Senden Sie eine sichere Testantwort auf eine Testkonversation und bestätigen Sie, dass sie im Besucher-Widget und in Chat History angezeigt wird.
ProblemBeheben
Die Antwort kann nicht gesendet werdenÜberprüfen Sie den Netzwerkstatus, den Gesprächsstatus und ob Live-Support in Anspruch genommen wurde.
Die Besuchersprache ist falschVerwenden Sie die Übersetzung oder aktualisieren Sie die Spracheinstellungen des Bots, bevor Sie antworten.
Die Konversation befindet sich nicht im PosteingangSuchen Sie nach Chat History und bestätigen Sie, dass der Widget-Test den richtigen Bot verwendet hat.

Was als nächstes zu tun ist: Verwenden Sie Live Support für aktive Übergabewarteschlangen und Chat History für Audits.

Live-Support

Anspruch erheben, antworten, an AI zurückgeben und eine Übergabe durchführen

Wozu dient das: Verwenden Sie dies, wenn die KI einen Menschen anfordert oder ein Besucher ausdrücklich einen Agenten benötigt.

Bevor Sie beginnen
  • Halten Sie einen Agenten bereit, bevor Sie den Live-Support aktivieren.
  • Definieren Sie, wann die KI eine Übergabe in Bot-Anweisungen anfordern soll.
  • Lassen Sie die Benachrichtigungseinstellungen für Übergabewarnungen aktiviert.
1

Öffnen Sie Live Support

Klicken Sie in der Seitenleiste auf Live Support.

Erwartetes Ergebnis: Wartende und aktive Übergabe conversations sind sichtbar.
2

Fordern Sie die Anfrage an

Klicken Sie im wartenden Gespräch auf Anspruch.

Erwartetes Ergebnis: Andere Agenten können sehen, dass das Gespräch aktiv geführt wird.
3

Kontext lesen

Öffnen Sie Nachrichten und Besucherdetails, bevor Sie antworten.

Erwartetes Ergebnis: Der Agent versteht, warum die Übergabe stattgefunden hat.
4

Senden Sie die menschliche Antwort

Reagieren Sie klar und deutlich und halten Sie den Thread auf dem Laufenden.

Erwartetes Ergebnis: Der Besucher erhält eine menschliche Antwort.
5

Gegebenenfalls an AI zurückgeben

Verwenden Sie die Hand zurück, wenn das Problem gelöst ist und die KI fortfahren kann.

Erwartetes Ergebnis: AI nimmt die Konversation wieder auf.
6

Lösen Sie das Problem, wenn Sie fertig sind

Klicken Sie auf „Beheben“, wenn der Besucher keine Hilfe mehr benötigt.

Erwartetes Ergebnis: Die Übergabe wird geschlossen und aus der aktiven Warteschlange entfernt.
So testen Sie es: Erstellen Sie eine Testübergabe, fordern Sie sie an, antworten Sie einmal, geben Sie sie zurück und bestätigen Sie die Statusänderungen in Live Support und Chat History.
ProblemBeheben
Agenten verpassen AnfragenAktivieren Sie Browser-/E-Mail-/Push-Benachrichtigungen und fügen Sie einen Prozess für den Warteschlangenbesitz hinzu.
Die KI übernimmt immer wieder zu frühPassen Sie Anweisungen und Übergaberegeln an, sodass die menschliche Kontrolle aktiv bleibt, bis sie gelöst oder zurückgegeben wird.
Externer CRM ist nicht synchronVerwenden Sie Webhooks oder Umfragen aus dem Abschnitt „Entwicklerrezepte“.

Was als nächstes zu tun ist: Verbinden Sie CRM/webhooks, wenn Supportteams außerhalb von sem.chat arbeiten.

Geschichte und Kontakte

Suchen, exportieren und verwenden Sie Gesprächs-/Kontaktdatensätze

Wozu dient das: Verwenden Sie dies für Audits, Lead-Review, CSV-Export und SendPulse-Synchronisierung.

Bevor Sie beginnen
  • Entscheiden Sie, ob Sie conversations, Kontakte oder beides benötigen.
  • Wenden Sie vor dem Exportieren den richtigen Datumsbereich an.
  • Exportieren Sie nicht mehr persönliche Daten als nötig.
1

Öffnen Sie Chat History

Klicken Sie in der Seitenleiste auf Chat History.

Erwartetes Ergebnis: Konversationsfilter, Statistiken und die Transkriptliste sind sichtbar.
2

Suchen und filtern

Filtern Sie nach Bot, Kanal, Modus, Besucher oder Datumsbereich.

Erwartetes Ergebnis: Nur passende conversations bleiben sichtbar.
3

Öffnen Sie ein Transkript

Klicken Sie auf eine Konversation, um den vollständigen Nachrichtenthread zu lesen.

Erwartetes Ergebnis: Der vollständige Kontext, Kontaktdaten und Konversationsmetadaten sind sichtbar.
4

conversations exportieren

Klicken Sie auf „Exportieren“ und wählen Sie das gewünschte Format aus, falls verfügbar.

Erwartetes Ergebnis: Der Export enthält die gefilterten Konversationsdaten.
5

Öffnen Sie Kontakte

Klicken Sie in der Seitenleiste auf Kontakte.

Erwartetes Ergebnis: Lead-/Kontaktdatensätze werden mit Quelle, Bot und Status angezeigt.
6

Kontakte filtern und exportieren

Suchen Sie nach Kontakten, wählen Sie die gewünschten Datensätze aus und exportieren oder synchronisieren Sie sie mit SendPulse.

Erwartetes Ergebnis: Die ausgewählten Kontakte sind entsprechend der gewählten Aktion außerhalb von sem.chat verfügbar.
So testen Sie es: Exportieren Sie ein kleines gefiltertes CSV und öffnen Sie es lokal, um zu bestätigen, dass Spalten und Datumsbereich korrekt sind.
ProblemBeheben
Kontakt fehlt in den KontaktenBestätigen Sie, dass die Lead-Erfassung aktiviert ist und der Besucher das Formular gesendet hat.
Der Export ist zu großGrenzen Sie den Datumsbereich oder den Bot-Filter vor dem Exportieren ein.
SendPulse Synchronisierung nicht verfügbarVerbinden Sie zuerst SendPulse in Integrationen und kehren Sie dann zu Kontakte zurück.

Was als nächstes zu tun ist: Sehen Sie sich Analytics an, um Leistungstrends nach laufendem Betrieb zu verstehen.

08

Kanäle und Integrationen

Verbinden Sie Slack, Facebook, Instagram, WhatsApp, Telegram über BotFather, manuelle Anmeldeinformationen, alternative chat-Links, SendPulse und CRM-Integrationen.

/IntegrationenKanäle, CRM und E-Mail-Verbindungen
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Wählen Sie den Kanal oder die Integrationskarte CRM.
2Befolgen Sie die OAuth- oder Anmeldeinformationsschritte für jeden Anbieter.
3Trennen Sie die Integrationen von derselben Seite oder testen Sie sie erneut.
Kanäle verbinden

Verbinden Sie einen Messaging-Kanal oder eine CRM-Integration

Wozu dient das: Verwenden Sie dies, wenn sem.chat conversations außerhalb des Website-Widgets empfangen oder Kontakte an andere Tools senden soll.

Bevor Sie beginnen
  • Haben Sie Administratorzugriff auf die externe Plattform.
  • Wissen Sie, welcher Bot Kanalnachrichten empfangen soll.
  • Verwenden Sie Testkanäle, bevor Sie Produktionskonten verbinden.
1

Offene Integrationen

Klicken Sie in der Seitenleiste auf Integrationen.

Erwartetes Ergebnis: Verfügbare Kanäle, CRM-Tools, SendPulse und Website-Widget-Optionen sind sichtbar.
2

Wählen Sie die Integration

Klicken Sie auf „Verbinden“ bei Slack, Metakanälen, Telegram, SendPulse, CRM oder manuellen Anmeldeinformationen.

Erwartetes Ergebnis: Der Setup-Dialog oder OAuth-Flow wird geöffnet.
3

Komplette Provider-Einrichtung

Genehmigen Sie für OAuth-Kanäle die angeforderten Berechtigungen. Fügen Sie für manuelle Kanäle das erforderliche Token, Geheimnis, die Konto-ID oder den Webhook URL ein.

Erwartetes Ergebnis: sem.chat speichert die Verbindung und zeigt die Integration als verbunden an.
4

Weisen Sie den Bot zu

Wählen Sie aus, welcher Bot Nachrichten von diesem Kanal verarbeiten soll, wenn Sie im Dialog dazu aufgefordert werden.

Erwartetes Ergebnis: Eingehende Nachrichten werden an den richtigen Assistenten weitergeleitet.
5

Testen Sie den Kanal

Senden Sie eine Testnachricht vom externen Kanal.

Erwartetes Ergebnis: Die Nachricht erscheint im Posteingang oder Chat History unter dem richtigen Kanal.
6

Bei Bedarf trennen

Verwenden Sie „Verbindung zur Integrationskarte trennen“, wenn der Kanal gestoppt werden soll.

Erwartetes Ergebnis: sem.chat empfängt oder sendet nicht mehr über diese Integration.
So testen Sie es: Senden Sie eine Testnachricht über den verbundenen Kanal und bestätigen Sie die Bot-Antwort, die Posteingangszeile und den Verlaufseintrag.
ProblemBeheben
Telegram-Token schlägt fehlErstellen Sie das Token in BotFather oder setzen Sie es zurück und fügen Sie es erneut ein.
Slack Nachrichten kommen nicht anÜberprüfen Sie App-Bereiche, Ereignisabonnement URL, Bot-Token, Signaturgeheimnis und Kanalmitgliedschaft.
Die Verbindung zum Metakanal schlägt fehlBestätigen Sie, dass das Konto Facebook/Instagram/WhatsApp über Administratorberechtigungen und den erforderlichen Geschäftszugriff verfügt.
Die Synchronisierung von SendPulse schlägt fehlVerbinden Sie SendPulse erneut und bestätigen Sie, dass die Kontaktfelder zugeordnet sind.

Was als nächstes zu tun ist: Dokumentieren Sie die Kanaleigentümerschaft für das Team und überwachen Sie den Posteingang nach dem Start.

09

Terminplanung

Erstellen Sie Veranstaltungstypen, konfigurieren Sie die Verfügbarkeit, verbinden Sie Kalender, verwalten Sie Buchungen, erstellen Sie einmalige Links, konfigurieren Sie Buchungs-E-Mails, überprüfen Sie Analysen, richten Sie kostenpflichtige Veranstaltungen ein und testen Sie öffentliche Buchungslinks.

/TerminplanungArbeitsbereich planen
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Verwenden Sie Registerkarten für Veranstaltungstypen, Buchungen, Analysen, einmalige Links, Kalender, E-Mails und Einstellungen.
2Ereignistypen bearbeiten, kopieren, einbetten, aktivieren oder pausieren.
3Kopieren Sie den öffentlichen Link und führen Sie einen privaten Buchungstest durch.
Event-EditorKonfiguration des Ereignistyps
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Geben Sie Namen, Beschreibung, Dauer, Ort und Puffer ein.
2Legen Sie Verfügbarkeit, Buchungsfenster, Fragen, Optionen für kostenpflichtige Veranstaltungen und Stornierungsregeln fest.
3Speichern Sie die Veranstaltung, bevor Sie den Link teilen.
/book/:username/:eventSlugÖffentliche Buchungsseite
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Besucher wählen auf der öffentlichen Buchungsseite einen Termin aus.
2Besucher wählen ein verfügbares Zeitfenster.
3Besucher bestätigen die Buchung und erhalten Bestätigungs-E-Mails.
Ereignistyp

Erstellen Sie einen Veranstaltungstyp und veröffentlichen Sie einen Buchungslink

Wozu dient das: Nutzen Sie dies, wenn Besucher Demos, Beratungen, Verkaufsgespräche, Onboarding- oder Support-Sitzungen buchen sollen.

Bevor Sie beginnen
  • Wählen Sie den Veranstaltungsnamen, die Dauer, den Besprechungstyp und den Eigentümer aus.
  • Legen Sie die Zeitzone und Verfügbarkeit fest, bevor Sie Links teilen.
  • Verknüpfen Sie Kalender, wenn Doppelbuchungen wichtig sind.
1

Öffnen Sie die Planung

Klicken Sie in der Seitenleiste auf „Planung“.

Erwartetes Ergebnis: Der Planungsarbeitsbereich zeigt Registerkarten für Veranstaltungstypen, Buchungen, Analysen, einmalige Links, Kalender, E-Mails und Einstellungen.
2

Erstellen Sie einen Ereignistyp

Klicken Sie auf „Erstellen“ und fügen Sie dann Name, Beschreibung, Dauer, Ort, Puffer und Buchungsregeln hinzu.

Erwartetes Ergebnis: Die Veranstaltung verfügt über genügend öffentliche Informationen, damit die Besucher sie verstehen können.
3

Verfügbarkeit festlegen

Konfigurieren Sie wöchentliche Stunden, Datumsüberschreibungen, Benachrichtigungsfenster und Buchungsfenster.

Erwartetes Ergebnis: Besucher sehen nur Zeiten, die Sie anbieten möchten.
4

Fügen Sie Fragen hinzu

Fügen Sie erforderliche Fragen wie Telefonnummer, Firma, Website oder Besprechungsziel hinzu.

Erwartetes Ergebnis: Buchungen erfassen den Kontext, den Ihr Team vor dem Anruf benötigt.
5

Kalender verbinden

Öffnen Sie Kalender und verbinden Sie Google, Outlook oder iCal, falls verfügbar.

Erwartetes Ergebnis: Belegte Zeiten können blockiert und bestätigte Buchungen in den Kalender geschrieben werden.
6

Legen Sie E-Mails und Erinnerungen fest

Öffnen Sie E-Mails und konfigurieren Sie Bestätigungs-, Erinnerungs-, Stornierungs- und Neuplanungsnachrichten.

Erwartetes Ergebnis: Besucher erhalten eine korrekte Buchungskommunikation.
7

Teilen und testen Sie den öffentlichen Link

Kopieren Sie den Veranstaltungslink, öffnen Sie ihn in einem privaten Fenster, wählen Sie einen Termin aus und schließen Sie eine Testbuchung ab.

Erwartetes Ergebnis: Die Buchung erscheint auf der Registerkarte „Buchungen“ und es werden Bestätigungsnachrichten gesendet.
So testen Sie es: Führen Sie eine Testbuchung, eine Umbuchung und eine Stornierung durch. Bestätigen Sie, dass jedes Ereignis in der Terminplanung und in verbundenen Kalendern angezeigt wird.
ProblemBeheben
Auf der öffentlichen Seite werden keine Zeiten angezeigtÜberprüfen Sie die Zeitzone, die wöchentliche Verfügbarkeit, Datumsüberschreibungen, das Benachrichtigungsfenster und verbundene Kalenderkonflikte.
Buchungs-E-Mail fehltÜberprüfen Sie die E-Mail-Einstellungen und den Spam-Ordner und senden Sie dann eine weitere Testbuchung.
Die Zahlung für ein bezahltes Ereignis schlägt fehlBestätigen Sie vor der Veröffentlichung, dass die Abrechnungs-/Zahlungsintegrationseinstellungen und die Währung gültig sind.

Was als nächstes zu tun ist: Betten Sie Buchungslinks in den Bot, die Website oder Folge-E-Mails ein.

Erweiterte Terminplanung

Nutzen Sie einmalige Links, Analysen, Einbettungen und kostenpflichtige Events

Wozu dient das: Verwenden Sie dies, wenn für die Planung vorübergehende Verfügbarkeit, Berichte, eingebettete Buchungen oder Zahlungen erforderlich sind.

Bevor Sie beginnen
  • Erstellen Sie zunächst mindestens einen Veranstaltungstyp.
  • Verknüpfen Sie Kalender, bevor Sie häufig einmalige Links verwenden.
  • Definieren Sie Rückerstattungs-/Stornierungsrichtlinien, bevor Sie kostenpflichtige Veranstaltungen aktivieren.
1

Erstellen Sie einen einmaligen Link

Öffnen Sie Einmalige Links, wählen Sie die angebotenen Slots oder Regeln aus und generieren Sie dann den Link.

Erwartetes Ergebnis: Der Empfänger kann nur ab der ausgewählten Verfügbarkeit buchen.
2

Einbettungsplanung

Nutzen Sie die Option zum Einbetten der Veranstaltungskarte, wenn der Buchungsablauf auf Ihrer Website erscheinen soll.

Erwartetes Ergebnis: Die Buchungsoberfläche kann auf der Seite platziert werden, auf der Besucher konvertieren.
3

Überprüfen Sie die Planungsanalyse

Öffnen Sie Analytics in Scheduling.

Erwartetes Ergebnis: Sie können Buchungen, Fertigstellungstrends und die Leistung von Veranstaltungstypen sehen.
4

Aktivieren Sie kostenpflichtige Veranstaltungen

Öffnen Sie den Event-Editor, legen Sie Preis, Währung und Zahlungsverhalten fest.

Erwartetes Ergebnis: Besucher müssen den Zahlungsschritt entsprechend der Veranstaltungseinrichtung abschließen.
5

Prüfungsbuchungen

Öffnen Sie Buchungen und überprüfen Sie bevorstehende, abgeschlossene, stornierte und verschobene Einträge.

Erwartetes Ergebnis: Das Team kann die Anwesenheit und Nachbereitung verwalten.
So testen Sie es: Buchen Sie über die öffentliche Seite und ggf. über eine eingebettete Seite. Bestätigen Sie, dass beide denselben Typ von Buchungsdatensatz erstellen.
ProblemBeheben
Ein einmaliger Link deckt falsche Slots aufGenerieren Sie den Link mit einem kleineren Slot-Set oder einem strengeren Datumsbereich neu.
Die eingebettete Buchung ist zu engPlatzieren Sie die Einbettung in einem größeren Inhaltscontainer und überprüfen Sie das mobile Layout.
Analytics sieht leer ausErstellen oder warten Sie auf echte Buchungen; Analysen basieren auf Buchungsdatensätzen.

Was als nächstes zu tun ist: Verknüpfen Sie Planungsergebnisse mit Berichten und Analysen.

10

Analysen und Berichte

Wählen Sie Datumsbereiche aus, verwenden Sie benutzerdefinierte Daten, lesen Sie Kernmetriken, exportieren Sie CSV, überprüfen Sie Zufriedenheit und Konversationstrends, konfigurieren Sie E-Mail-Berichte und überprüfen Sie die Zustellung.

/AnalyseAnalytics-Dashboard
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Wählen Sie Datumsbereiche oder benutzerdefinierte Daten.
2Lesen Sie Konversations-, Zufriedenheits-, Sprach-, Kanal- und Konversionskennzahlen.
3Exportieren Sie CSV für die Offline-Analyse.
Einstellungen / BerichteEinrichtung des E-Mail-Berichts
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Wählen Sie zwischen täglichem, wöchentlichem oder monatlichem Berichtsrhythmus.
2Berichtsempfänger hinzufügen.
3Senden Sie einen sofortigen Bericht, um die Lieferung zu testen.
Analytics-Überprüfung

Lesen Sie Analysen und exportieren Sie Leistungsdaten

Wozu dient das: Verwenden Sie dies für wöchentliche Überprüfungen, Einführungsprüfungen, Überprüfung der Supportqualität und Conversion-Analyse.

Bevor Sie beginnen
  • Wählen Sie den Datumsbereich aus, bevor Sie die Messwerte lesen.
  • Wissen Sie, welchen Bot oder Kanal Sie bewerten.
  • Schließen Sie private Testtermine aus, wenn Sie die Produktionsleistung melden.
1

Öffnen Sie Analytics

Klicken Sie in der Seitenleiste auf Analytics.

Erwartetes Ergebnis: Dashboard-Metriken und Diagrammbereiche sind sichtbar.
2

Wählen Sie den Datumsbereich

Wählen Sie heute, 7 Tage, 30 Tage oder benutzerdefinierte Daten aus.

Erwartetes Ergebnis: Alle Diagramme werden auf den ausgewählten Zeitraum aktualisiert.
3

Lesen Sie Kernkennzahlen

Überprüfen Sie conversations, Sprachminuten, Zufriedenheit, Konvertierung und Kanalmix.

Erwartetes Ergebnis: Sie verstehen den Umfang und die Qualität der Kundeninteraktionen.
4

Überprüfen Sie Trends

Sehen Sie sich Gesprächstrends, Zufriedenheitsänderungen, häufigste Fragen und Sprach-/Kanalmuster an.

Erwartetes Ergebnis: Sie können erkennen, wo Bot-Anweisungen oder Personalbesetzung verbessert werden können.
5

CSV exportieren

Verwenden Sie Export CSV, wenn das Team eine Tabellenkalkulationsanalyse benötigt.

Erwartetes Ergebnis: Der CSV enthält den ausgewählten Datumsbereich und die ausgewählten Messwerte.
6

Erkenntnisse in Veränderungen umwandeln

Aktualisieren Sie Bot-Anweisungen, Wissen, Widget-Einstellungen oder Support-Abdeckung basierend auf den Daten.

Erwartetes Ergebnis: Analysen führen zu konkreten Produktverbesserungen.
So testen Sie es: Exportieren Sie ein kleines benutzerdefiniertes Datum CSV und überprüfen Sie, ob der Datumsbereich und die Messwerte mit denen im Dashboard übereinstimmen.
ProblemBeheben
Die Kennzahlen scheinen zu hoch zu seinÜberprüfen Sie, ob Staging/Test conversations im ausgewählten Datumsbereich enthalten sind.
Zufriedenheit ist leerAktivieren Sie Bewertungen in den Widget-Einstellungen und warten Sie, bis Besucher Bewertungen hinterlassen.
Sprachminuten entsprechen nicht den ErwartungenBestätigen Sie, dass der Sprachmodus nur für die vorgesehenen Bots aktiviert ist.

Was als nächstes zu tun ist: Planen Sie E-Mail-Berichte für wiederkehrende Sichtbarkeit.

Berichte

Konfigurieren Sie wiederkehrende E-Mail-Berichte und testen Sie die Zustellung

Wozu dient das: Verwenden Sie dies, wenn Eigentümer, Manager oder Kunden automatische Leistungszusammenfassungen benötigen.

Bevor Sie beginnen
  • Entscheiden Sie, wer Berichte erhalten soll.
  • Verwenden Sie verifizierte E-Mail-Adressen.
  • Wählen Sie einen Rhythmus, der zum Rhythmus der Geschäftsbewertungen passt.
1

Öffnen Sie Einstellungen und dann Berichte

Gehen Sie zu „Einstellungen“ und wählen Sie die Registerkarte „Berichte“ oder verwenden Sie die Weiterleitung „Berichte“, sofern verfügbar.

Erwartetes Ergebnis: Berichtsrhythmus, Empfänger und Verlauf sind sichtbar.
2

Wählen Sie die Trittfrequenz

Aktivieren Sie tägliche, wöchentliche oder monatliche Berichte.

Erwartetes Ergebnis: Der Berichtszeitplan wird für den Arbeitsbereich gespeichert.
3

Empfänger hinzufügen

Geben Sie die E-Mail-Adressen ein, die Berichte erhalten sollen.

Erwartetes Ergebnis: Berichte werden an die richtigen Stakeholder gesendet.
4

Sofortbericht senden

Klicken Sie auf „Jetzt senden“ oder eine entsprechende Sofortberichtsaktion.

Erwartetes Ergebnis: Zur Überprüfung wird sofort eine Berichts-E-Mail gesendet.
5

Überprüfen Sie den Berichtsverlauf

Überprüfen Sie das Verlaufsfenster, nachdem Berichte gesendet wurden.

Erwartetes Ergebnis: Sie können den Lieferstatus und den Liefertermin bestätigen.
So testen Sie es: Senden Sie einen Sofortbericht an einen Testempfänger und bestätigen Sie den Empfang und die Formatierung.
ProblemBeheben
Die Berichts-E-Mail kommt nicht anÜberprüfen Sie die Rechtschreibung des Empfängers, den Spam-Ordner und den Status des Berichtsverlaufs.
Falsche Leute erhalten BerichteAktualisieren Sie die Empfänger und speichern Sie sie vor dem nächsten geplanten Versand.
Der Inhalt des Berichts fühlt sich verrauscht anPassen Sie die Erwartungen an den Datumsbereich an und nutzen Sie Analytics für eine tiefergehende manuelle Überprüfung.

Was als nächstes zu tun ist: Nutzen Sie den Berichtsrhythmus als Arbeitsrhythmus für Bot-Verbesserungen.

11

Abrechnung, Team, Sicherheit, Einstellungen, Partner

Starten oder aktualisieren Sie Pläne, verwalten Sie das Abrechnungsportal, laden Sie Teamkollegen ein, legen Sie Rollen fest, bearbeiten Sie Profil/Sprache, konfigurieren Sie Benachrichtigungen, aktivieren Sie 2FA, verwenden Sie Gefahrenzonenaktionen und führen Sie den Affiliate-Workflow aus.

/AbrechnungPlan- und Abrechnungskontrollen
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Überprüfen Sie den aktuellen Plan, den Teststatus und die usage-Limits.
2Vergleichen Sie die Planfunktionen, bevor Sie ein Upgrade durchführen.
3Öffnen Sie das Abrechnungsportal für Rechnungen, Zahlungsmethoden, Stornierung oder Reaktivierung.
/EinstellungenEinstellungen, Team und Sicherheit
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Verwenden Sie „Allgemein“ für Profil und Sprache.
2Verwenden Sie Team für Einladungen und Rollen.
3Verwenden Sie Sicherheit für 2FA, API-Schlüssel und Gefahrenzonenaktionen.
/PartnerKontrollen des Partnerprogramms
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Treten Sie dem Programm bei, um einen Empfehlungslink zu erstellen.
2Kopieren Sie den Empfehlungslink für Kampagnen.
3Legen Sie eine Auszahlungs-E-Mail fest und fordern Sie berechtigte Auszahlungen an.
Abrechnung

Starten, upgraden, kündigen oder reaktivieren Sie einen Plan

Wozu dient das: Verwenden Sie diese Option, wenn für den Arbeitsbereich eine Testaktivierung, weitere Limits, Rechnungen, Zahlungsaktualisierungen oder Abonnementänderungen erforderlich sind.

Bevor Sie beginnen
  • Der Kontoinhaber oder Abrechnungsadministrator sollte Abrechnungsaktionen durchführen.
  • Bestätigen Sie, welche Funktionen plangesteuert sind: Stimme, geklonte Stimmen, benutzerdefinierte Avatare, API, Team, CRM und Kanäle.
  • Nutzen Sie das sichere Abrechnungsportal für Zahlungsmethoden- und Rechnungsänderungen.
1

Abrechnung öffnen

Klicken Sie in der Seitenleiste auf Abrechnung.

Erwartetes Ergebnis: Aktueller Plan, Teststatus, usage-Limits und Plankarten sind sichtbar.
2

Tarife vergleichen

Überprüfen Sie chat, Stimme, Team, API, Avatar, Integration, Planung und Supportgrenzen.

Erwartetes Ergebnis: Sie wissen, welcher Plan die benötigte Funktion freischaltet.
3

Wählen Sie das Abrechnungsintervall

Wählen Sie monatlich oder jährlich, wenn die Umschaltfunktion verfügbar ist.

Erwartetes Ergebnis: Preis- und Sparaktualisierung für das ausgewählte Intervall.
4

Upgraden oder zur Kasse gehen

Wählen Sie den gewünschten Plan und schließen Sie den Checkout ab.

Erwartetes Ergebnis: Das Abonnement wird nach Zahlungsbestätigung aktiv.
5

Kundenportal öffnen

Nutzen Sie das Abrechnungsportal für Zahlungsart, Rechnungen, Stornierung oder Reaktivierung.

Erwartetes Ergebnis: Sensible Abrechnungsvorgänge erfolgen im sicheren Anbieterportal.
6

Überprüfen Sie den Funktionszugriff

Kehren Sie zu der gesperrten Funktion zurück und laden Sie die App neu.

Erwartetes Ergebnis: Die freigeschaltete Funktion ist jetzt verfügbar, wenn sie im Plan enthalten ist.
So testen Sie es: Öffnen Sie nach dem Upgrade die zuvor gesperrte Funktion, z. B. Voice Clone oder API-Tasten, und bestätigen Sie, dass die Sperre aufgehoben ist.
ProblemBeheben
Die Funktion bleibt nach dem Upgrade gesperrtAktualisieren Sie die App, warten Sie einen Moment auf die Abonnementsynchronisierung und überprüfen Sie dann erneut die Abrechnung.
Der Checkout wurde abgebrochenKehren Sie zur Abrechnung zurück und starten Sie den Bezahlvorgang erneut. Nach einem stornierten Checkout finden keine Planänderungen statt.
Rechnungs- oder Kartenwechsel erforderlichÖffnen Sie das Kundenportal, anstatt Zahlungsdetails in der App zu bearbeiten.

Was als nächstes zu tun ist: Laden Sie Teamkollegen ein und sichern Sie sich das Besitzerkonto.

Team und Sicherheit

Laden Sie Teamkollegen ein, legen Sie Rollen fest, bearbeiten Sie das Profil, aktivieren Sie 2FA und verwalten Sie Einstellungen

Wozu dient das: Verwenden Sie dies, wenn der Arbeitsbereich vom Einzelbetrieb zum Teambetrieb wechselt.

Bevor Sie beginnen
  • Machen Sie sich mit der Rolle jedes Teamkollegen vertraut, bevor Sie Einladungen versenden.
  • Verwenden Sie den Zugriff mit den geringsten Rechten: Eigentümer, Administrator, Herausgeber, Betrachter.
  • Halten Sie eine Authentifizierungs-App für 2FA bereit.
1

Öffnen Sie Einstellungen

Klicken Sie in der Seitenleiste auf Einstellungen.

Erwartetes Ergebnis: Allgemein, Benachrichtigungen, Team, Berichte, Entwickler, Sicherheit und verwandte Registerkarten sind sichtbar.
2

Profil und Sprache bearbeiten

Aktualisieren Sie den Anzeigenamen, die Profilinformationen und die bevorzugte Sprache unter „Allgemein“.

Erwartetes Ergebnis: Die App identifiziert den Benutzer korrekt und verwendet die gewählte Sprache, sofern verfügbar.
3

Laden Sie Teammitglieder ein

Öffnen Sie Team, geben Sie eine E-Mail ein, wählen Sie eine Rolle und senden Sie die Einladung.

Erwartetes Ergebnis: Der Teamkollege erhält einen Einladungslink und wird bis zur Annahme als ausstehend angezeigt.
4

Rollenberechtigungen festlegen

Verwenden Sie „Eigentümer“ für die vollständige Kontrolle, „Admin“ für die Verwaltung, „Editor“ für Inhaltsänderungen und „Viewer“ für schreibgeschützten Zugriff.

Erwartetes Ergebnis: Jeder Benutzer hat einen seiner Verantwortung entsprechenden Zugriff.
5

Konfigurieren Sie Benachrichtigungen

Wählen Sie E-Mail, Browser, Push, Live-Support, Abrechnung und Berichtsbenachrichtigungen.

Erwartetes Ergebnis: Die richtigen Personen erhalten Benachrichtigungen ohne unnötigen Lärm.
6

Aktivieren Sie 2FA

Öffnen Sie Security, aktivieren Sie die Zwei-Faktor-Authentifizierung, scannen Sie den Code und speichern Sie die Wiederherstellungsdetails.

Erwartetes Ergebnis: Das Konto erfordert nach der Passwortanmeldung einen zweiten Faktor.
7

Gehen Sie bei Maßnahmen im Gefahrenbereich vorsichtig vor

Exportieren Sie benötigte Daten und bestätigen Sie aktive Widgets/Integrationen vor destruktiven Kontoaktionen.

Erwartetes Ergebnis: Der Arbeitsbereich vermeidet versehentlichen Datenverlust.
So testen Sie es: Laden Sie einen Test-Teamkollegen ein, nehmen Sie die Einladung in einem separaten Browser an und bestätigen Sie, dass die Rolle nur die beabsichtigten Funktionen offenlegt.
ProblemBeheben
Einladungs-E-Mail fehltÜberprüfen Sie den Spam, senden Sie die Einladung erneut und überprüfen Sie die Adresse.
Teamkollege sieht zu vielSenken Sie ihre Rolle und überprüfen Sie die Bot-Zugriffseinstellungen.
Die 2FA-Einrichtung schlägt fehlÜberprüfen Sie die Gerätezeit, scannen Sie den QR-Code erneut und speichern Sie die Wiederherstellungsdetails, bevor Sie sich darauf verlassen.

Was als nächstes zu tun ist: Konfigurieren Sie API-Schlüssel nur für Benutzer und Dienste, die sie benötigen.

Partner

Treten Sie einem Partner bei, kopieren Sie den Empfehlungslink, legen Sie eine Auszahlungs-E-Mail fest und fordern Sie eine Auszahlung an

Wozu dient das: Verwenden Sie dies, wenn ein Partner oder Kunde neue sem.chat-Benutzer empfehlen und die Provisionsaktivität verfolgen möchte.

Bevor Sie beginnen
  • Verwenden Sie das Konto, das über die Empfehlungszuordnung verfügen soll.
  • Bereiten Sie die Auszahlungs-E-Mail vor, bevor Sie eine Auszahlung beantragen.
  • Überprüfen Sie die Programmregeln, bevor Sie Empfehlungskampagnen veröffentlichen.
1

Partner öffnen

Klicken Sie in der Seitenleiste auf „Affiliate“ oder öffnen Sie die Registerkarte „Affiliate“ über die Einstellungen, sofern dort ein Link vorhanden ist.

Erwartetes Ergebnis: Auf der Seite des Partnerprogramms werden die Bereiche „Beitritt“, „Empfehlung“, „Auszahlung“ und „Verlauf“ angezeigt.
2

Nehmen Sie am Programm teil

Klicken Sie auf Beitreten, wenn das Konto noch nicht beigetreten ist.

Erwartetes Ergebnis: Es werden ein Empfehlungscode und ein Empfehlungslink erstellt.
3

Empfehlungslink kopieren

Kopieren Sie den eindeutigen Link und verwenden Sie ihn in Inhalten, Kampagnen oder Partnernachrichten.

Erwartetes Ergebnis: Anmeldungen über den Link können dem Affiliate-Konto zugeordnet werden.
4

Auszahlungs-E-Mail festlegen

Geben Sie die Auszahlungs-E-Mail ein und speichern Sie sie.

Erwartetes Ergebnis: Berechtigte Auszahlungen können korrekt weitergeleitet werden.
5

Überprüfen Sie Empfehlungen und Provisionen

Überprüfen Sie die Empfehlungsliste, den Provisionsstatus und den Auszahlungsverlauf.

Erwartetes Ergebnis: Sie wissen, was aussteht, berechtigt oder bereits bezahlt ist.
6

Auszahlung beantragen

Klicken Sie auf Auszahlung anfordern, wenn die Programmregeln und Mindestbeträge erfüllt sind.

Erwartetes Ergebnis: Der Auszahlungsantrag wird zur Bearbeitung erfasst.
So testen Sie es: Öffnen Sie den Empfehlungslink in einem privaten Browser und bestätigen Sie, dass er zum erwarteten Anmeldevorgang mit Empfehlungsverfolgung gelangt.
ProblemBeheben
Der Empfehlungslink fehltTreten Sie zuerst dem Programm bei oder aktualisieren Sie die Partnerseite nach dem Beitritt.
Auszahlungsanfrage nicht verfügbarÜberprüfen Sie den Mindestauszahlungsschwellenwert, den Status der berechtigten Provision und die Auszahlungs-E-Mail.
Empfehlung nicht zugeordnetBestätigen Sie, dass der Besucher den genauen Empfehlungslink verwendet und die Tracking-Parameter nicht entfernt hat.

Was als nächstes zu tun ist: Verwenden Sie Analysen und Berichte, um ggf. die Wirkung geworbener Kunden zu überwachen.

12

Benachrichtigungen und App Updates

Überprüfen Sie Warnungen, markieren Sie Benachrichtigungen als gelesen, filtern Sie wichtige Ereignisse und nutzen Sie App-Updates, um neue Produktänderungen zu verstehen.

/BenachrichtigungenBenachrichtigungscenter
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Verwenden Sie „Alle als gelesen markieren“, nachdem Sie ungelesene Benachrichtigungen überprüft haben.
2Filtern Sie nach ungelesenen, Abrechnungs-, Live-Support- oder Systemereignissen.
3Öffnen Sie die entsprechende Funktion, nachdem Sie die Warnung gelesen haben.
/app-updatesApp-Updates-Feed
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Lesen Sie die Versionshinweise für neue Funktionen und Korrekturen.
2Nutzen Sie Details, um Teamkollegen zu schulen, bevor sich der Arbeitsablauf ändert.
3Überprüfen Sie Updates, nachdem Sie Änderungen an der Benutzeroberfläche oder im Verhalten festgestellt haben.
Benachrichtigungen

Überprüfen Sie Benachrichtigungen und reagieren Sie auf Warnungen

Wozu dient das: Verwenden Sie dies, wenn die App Übergaben, den Abrechnungsstatus, Systemereignisse, die Berichtszustellung oder wichtige Arbeitsbereichsaktivitäten meldet.

Bevor Sie beginnen
  • Stellen Sie sicher, dass in den Einstellungen Benachrichtigungseinstellungen festgelegt sind.
  • Erhalten Sie Live-Support, wenn Übergabewarnungen aktiviert sind.
  • Überprüfen Sie ungelesene Benachrichtigungen, bevor Sie sie als gelesen markieren.
1

Benachrichtigungen öffnen

Klicken Sie in der Seitenleiste oder im App-Header-Benachrichtigungseintrag auf Benachrichtigungen.

Erwartetes Ergebnis: Das Benachrichtigungscenter listet aktuelle Warnungen auf.
2

Warnungen filtern

Verwenden Sie Ungelesen- oder Kategoriefilter, um sich auf Abrechnung, Live-Support, Bots, Berichte oder Systemereignisse zu konzentrieren.

Erwartetes Ergebnis: Es bleiben nur passende Benachrichtigungen sichtbar.
3

Öffnen Sie die entsprechende Seite

Klicken Sie auf die Warnung oder verwenden Sie ihren Kontext, um Billing, Live Support, Reports oder den entsprechenden Bot zu öffnen.

Erwartetes Ergebnis: Sie reagieren auf die Benachrichtigung, anstatt sie nur zu lesen.
4

Mark hat gelesen

Markieren Sie eine einzelne Warnung als gelesen oder verwenden Sie „Alle nach Überprüfung als gelesen markieren“.

Erwartetes Ergebnis: Ungelesene Zählverluste und überprüfte Elemente werden nicht mehr hervorgehoben.
5

Passen Sie die Einstellungen an

Öffnen Sie Einstellungen, Benachrichtigungen, wenn zu viele oder zu wenige Benachrichtigungen eingehen.

Erwartetes Ergebnis: Der Benachrichtigungsstream entspricht den Teamanforderungen.
So testen Sie es: Erstellen Sie ein sicheres Testereignis, z. B. eine Live-Support-Anfrage oder einen Sofortbericht, und bestätigen Sie dann, dass die Benachrichtigung angezeigt wird und als gelesen markiert werden kann.
ProblemBeheben
Es kommt keine BenachrichtigungÜberprüfen Sie die Benachrichtigungseinstellungen, die Browserberechtigungen und ob das Ereignis tatsächlich stattgefunden hat.
Zu viele WarnungenDeaktivieren Sie laute Kategorien oder senden Sie sie nur an die zuständigen Teammitglieder.
Die Anzahl der ungelesenen Nachrichten scheint festzusteckenAktualisieren Sie die App, nachdem Sie alle gelesenen Elemente markiert haben, und bestätigen Sie, dass die Filter ungelesene Elemente nicht verbergen.

Was als nächstes zu tun ist: Überprüfen Sie App Updates, wenn sich das Verhalten ändert oder neue Steuerelemente angezeigt werden.

App-Updates

Nutzen Sie App-Updates, um Produktänderungen zu verstehen

Wozu dient das: Verwenden Sie dies, wenn Teamkollegen erfahren müssen, was sich geändert hat, bevor sie eine neue Funktion verwenden.

Bevor Sie beginnen
  • Öffnen Sie Updates nach Hauptversionen oder wenn sich die Benutzeroberfläche ändert.
  • Teilen Sie relevante Update-Hinweise mit Support- und Vertriebsbenutzern.
  • Testen Sie kritische Arbeitsabläufe nach größeren Änderungen erneut.
1

Öffnen Sie App Updates

Klicken Sie in der Seitenleiste auf App Updates.

Erwartetes Ergebnis: Der Update-Feed zeigt neue Funktionen, Korrekturen und Versionshinweise.
2

Lesen Sie das neueste Update

Öffnen Sie die aktuellste Update-Karte oder Detailansicht.

Erwartetes Ergebnis: Sie sehen, was sich geändert hat und welchen Workflow es betrifft.
3

Ordnen Sie die Änderung Ihrem Workflow zu

Stellen Sie fest, ob sich das Update auf Bots, Widgets, Support, Planung, Abrechnung oder Entwickler auswirkt.

Erwartetes Ergebnis: Die richtigen Teammitglieder wissen, was zu überprüfen ist.
4

Kritische Pfade erneut testen

Wenn sich das Update auf einen Produktionsworkflow auswirkt, wiederholen Sie die entsprechenden manuellen Schritte aus dieser Dokumentation.

Erwartetes Ergebnis: Das Team bestätigt, dass der geänderte Workflow weiterhin funktioniert.
5

Intern teilen

Senden Sie die Update-Zusammenfassung an Benutzer, denen der betroffene Bereich gehört.

Erwartetes Ergebnis: Die Teamakzeptanz verläuft reibungsloser und Supportfragen werden seltener gestellt.
So testen Sie es: Wiederholen Sie nach einem relevanten Update die Anleitung für die betroffene Funktion und vergewissern Sie sich, dass Screenshots oder Schrittnamen immer noch übereinstimmen.
ProblemBeheben
Update erwähnt eine gesperrte FunktionÖffnen Sie „Abrechnung“, um zu bestätigen, ob dies im aktuellen Plan enthalten ist.
Das Team hat einen Wechsel verpasstFügen Sie die App Updates-Überprüfung zu Release- oder wöchentlichen Betriebsroutinen hinzu.
Die Dokumentation sieht nach einem Update veraltet ausVerwenden Sie den Engineer Guide, um Screenshots und Schritte zu aktualisieren.

Was als nächstes zu tun ist: Halten Sie die öffentliche Dokumentation auf dem neuesten Stand, wenn sich die Funktionen weiterentwickeln.

13

Entwicklerrezepte

Generieren Sie API-Schlüssel, verwenden Sie die x-api-key-Authentifizierung, rufen Sie aktionsbasierte Endpunkte auf, überbrücken Sie Live-Support mit einem CRM, registrieren Sie Webhooks, überprüfen Sie Signaturen und betten Sie das Widget in Code ein.

Einstellungen / EntwicklerAPI-Tasten, Schnellstart und usage-Registerkarten
Echter Screenshot des sem.chat-Demo-Arbeitsbereichs
1Generieren und widerrufen Sie API-Schlüssel auf der Registerkarte API-Schlüssel.
2Verwenden Sie Quick Start für erste Curl-Beispiele.
3Überprüfen Sie die Nutzung, bevor Sie eine großvolumige Automatisierung aktivieren.
API Schnellstart

Generieren Sie einen API-Schlüssel und tätigen Sie die ersten API-Aufrufe

Wozu dient das: Verwenden Sie dies für Berichtsskripte, benutzerdefinierte Apps, CRM-Brücken, externen Live-Support oder Automatisierung.

Bevor Sie beginnen
  • Verwenden Sie eine serverseitige Umgebung. Machen Sie keine API-Schlüssel im Browser JavaScript verfügbar.
  • Generieren Sie für jede Integration einen separaten Schlüssel.
  • Kopieren Sie den Schlüssel sofort, da Geheimnisse nur einmal angezeigt werden.
1

Offene Entwickler

Öffnen Sie die Einstellungen und wählen Sie „Entwickler“ oder verwenden Sie die Entwicklerumleitung, falls verfügbar.

Erwartetes Ergebnis: Die Registerkarten „API Schlüssel“, „Quick Start“, „Dokumentation“ und „Nutzung“ sind sichtbar.
2

Generieren Sie einen Schlüssel

Klicken Sie auf Schlüssel generieren, geben Sie ihm eine eindeutige Bezeichnung und kopieren Sie ihn sofort.

Erwartetes Ergebnis: Der Schlüssel beginnt mit sk_live_ und ist für serverseitige Anfragen verfügbar.
3

Senden Sie den Header x-api-key

Fügen Sie x-api-key in jede öffentliche API-Anfrage ein.

Erwartetes Ergebnis: Der öffentliche API kann die Anfrage authentifizieren und sie dem Eigentümer zuordnen.
4

Bots auflisten

Rufen Sie action=list-bots auf, um die benötigte Bot-ID zu finden.

Erwartetes Ergebnis: Die Antwort gibt Bot-IDs, Namen, aktiven Status und eine Konfigurationszusammenfassung zurück.
5

Senden Sie eine chat-Nachricht

POST Aktion chat mit botId und Nachricht.

Erwartetes Ergebnis: Die Antwort gibt Antwort-, Modell- und usage-Informationen zurück.
6

Überprüfen Sie usage

Rufen Sie action=usage auf, bevor Sie Aufträge mit hohem Volumen ausführen.

Erwartetes Ergebnis: Sie kennen den aktuellen Plan und den usage-Status, bevor die Automatisierung ausgeführt wird.
7

Drehen Sie die Schlüssel bei Bedarf

Widerrufen Sie ungenutzte Schlüssel und generieren Sie neue für geänderte Anbieter oder Dienste.

Erwartetes Ergebnis: Alte Dienste können veraltete Anmeldeinformationen nicht weiter verwenden.
So testen Sie es: Führen Sie list-bots und chat von einem lokalen Terminal oder einer Serverumgebung aus aus und vergewissern Sie sich dann, dass die Konversation in Chat History erscheint, wenn chat gesendet wurde.
ProblemBeheben
401 oder nicht autorisierte AntwortÜberprüfen Sie die Rechtschreibung von x-api-key, kopieren Sie den vollständigen Schlüssel und stellen Sie sicher, dass er nicht widerrufen wurde.
Bot nicht gefundenVerwenden Sie list-bots erneut und bestätigen Sie, dass der Bot dem Schlüsseleigentümer API gehört.
Problem mit Browser CORSVerschieben Sie den API-Aufruf in Ihr Backend. API-Schlüssel sind für die serverseitige Verwendung vorgesehen.

Was als nächstes zu tun ist: Verwenden Sie /api-docs als gezielte Endpunktreferenz und behalten Sie diese Seite als Workflow-Anleitung bei.

Bots auflisten
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
  -H "x-api-key: sk_live_your_key_here"
Senden Sie eine chat-Nachricht
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "chat",
    "botId": "YOUR_BOT_ID",
    "message": "What can you help me with?"
  }'
Live-Support CRM Bridge

Live-Support-Anfragen abfragen oder an einen CRM senden

Wozu dient das: Verwenden Sie dies, wenn Agenten in einem anderen System arbeiten, aber sem.chat die Besucherkonversation empfängt.

Bevor Sie beginnen
  • Erstellen Sie einen dedizierten API-Schlüssel mit dem Namen für die CRM-Brücke.
  • Entscheiden Sie, ob Polling oder Webhooks zu Ihrer Infrastruktur passen.
  • Stellen Sie sicher, dass CRM Konversations-IDs für zukünftige Antworten/Lösungen speichert.
1

Wartende Übergaben auflisten

GET action=live-support-list mit status=requested oder status=all.

Erwartetes Ergebnis: Der CRM empfängt offene conversations, die menschliche Aufmerksamkeit erfordern.
2

Nachrichten abrufen

GET action=live-support-messages mit conversationId.

Erwartetes Ergebnis: Der CRM verfügt über den vollständigen Thread-Kontext und Besucherdetails.
3

Reklamieren Sie, bevor Sie antworten

POST Aktion=live-support-claim.

Erwartetes Ergebnis: sem.chat markiert die Konversation als aktiv bearbeitet.
4

Agentenantwort senden

POST action=live-support-reply mit conversationId, Nachricht und Agentenname.

Erwartetes Ergebnis: Der Besucher erhält die menschliche Antwort und die Thread-Updates.
5

Lösen oder zurückgeben

POST action=live-support-resolve mit Auflösung, Auflösung oder Rückgabe.

Erwartetes Ergebnis: Das Gespräch verlässt die Warteschlange oder die KI übernimmt wieder die Kontrolle.
6

Protokollstatus in CRM

Speichern Sie den neuesten Übergabestatus, die Nachrichten-ID und die Zeitstempel.

Erwartetes Ergebnis: CRM und sem.chat bleiben überprüfbar.
So testen Sie es: Erstellen Sie eine sichere Übergabe, spiegeln Sie sie auf CRM, antworten Sie von der Bridge aus und bestätigen Sie die Besucher-Thread-Updates.
ProblemBeheben
Doppelte CRM-TicketsVerwenden Sie conversationId als Idempotenzschlüssel in Ihrer CRM-Brücke.
Die Antworten kommen nicht in der richtigen ReihenfolgeSpeichern Sie Nachrichtenzeitstempel und vermeiden Sie gleichzeitige Antworten von mehreren Systemen.
AI antwortet, während der Agent arbeitetFordern Sie zuerst die Übergabe an und geben Sie sie erst zurück, wenn der Agent fertig ist.

Was als nächstes zu tun ist: Registrieren Sie Webhooks, wenn die Abfrage zu langsam oder zu teuer ist.

Webhooks

Registrieren Sie Webhooks und überprüfen Sie X-SemChat-Signature

Wozu dient das: Verwenden Sie diese Option, wenn Ihr System Echtzeitereignisse für Übergaben, Nachrichten und Auflösungsaktualisierungen benötigt.

Bevor Sie beginnen
  • Webhook URL muss HTTPS sein und über das öffentliche Internet erreichbar sein.
  • Speichern Sie das Webhook-Geheimnis sofort. es wird einmal angezeigt.
  • Überprüfen Sie die Signaturen, bevor Sie Ereignisse verarbeiten.
1

Registrieren Sie den Webhook

POST Aktion webhook-register mit URL und Ereignissen.

Erwartetes Ergebnis: Die Antwort enthält Webhook-Details und ein einmaliges Signaturgeheimnis.
2

Bewahren Sie das Geheimnis auf

Speichern Sie das Geheimnis in Ihrer Serverumgebung oder Ihrem Geheimmanager.

Erwartetes Ergebnis: Zukünftige Lieferungen können überprüft werden.
3

Signatur überprüfen

Lesen Sie X-SemChat-Signature und vergleichen Sie es mit einem HMAC SHA-256 über dem rohen Anforderungstext.

Erwartetes Ergebnis: Es werden nur echte sem.chat-Lieferungen akzeptiert.
4

Behandeln Sie Wiederholungsversuche idempotent

Verwenden Sie eine Ereignis-ID oder Konversations-/Nachrichten-ID, um eine doppelte Verarbeitung zu vermeiden.

Erwartetes Ergebnis: Bei Wiederholungsversuchen werden keine doppelten CRM-Datensätze erstellt.
5

Webhooks auflisten

GET Aktion webhook-list zur Prüfung konfigurierter Endpunkte.

Erwartetes Ergebnis: Sie können URLs, Ereignisse, den aktivierten Status und den aktuellen Lieferstatus sehen.
6

Löschen Sie veraltete Webhooks

POST Aktion webhook-delete mit Webhook-ID.

Erwartetes Ergebnis: Alte Endpunkte empfangen keine Ereignisse mehr.
So testen Sie es: Registrieren Sie einen Testendpunkt, lösen Sie ein Live-Support-Ereignis aus, überprüfen Sie die Signatur und bestätigen Sie, dass Ihr Handler 2xx zurückgibt.
ProblemBeheben
Signatur stimmt nicht übereinVerwenden Sie den Rohtext, nicht den geparsten JSON, und bestätigen Sie das richtige Webhook-Geheimnis.
Webhook empfängt keine EreignisseBestätigen Sie, dass die Ereignisliste das von Ihnen getestete Ereignis enthält und der Endpunkt HTTPS ist.
Zeitüberschreitung beim WebhookBestätigen Sie schnell und verarbeiten Sie lange Arbeiten asynchron.

Was als nächstes zu tun ist: Verknüpfen Sie Ingenieure mit /api-docs für Endpunktdetails und Beispiele.

Registrieren Sie den Webhook
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Überprüfen Sie die Webhook-Signatur
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Endpunktkarte

Verwenden Sie das aktionsbasierte öffentliche API richtig

Wozu dient das: Verwenden Sie dies, wenn Sie die richtige Aktion für eine Funktion auswählen.

Bevor Sie beginnen
  • Jede Anfrage verwendet dieselbe öffentliche API-Funktion URL.
  • GET-Aktionen verwenden Abfrageparameter. POST-Aktionen verwenden den JSON-Text.
  • Senden Sie x-api-key für alle Anfragen.
So testen Sie es: Rufen Sie usage und list-bots als Rauchtest nach jeder API-Schlüssel- oder Endpunktänderung auf.
ProblemBeheben
Nichtübereinstimmung der MethodeVerwenden Sie die in der Endpunkttabelle gezeigte Methode. Einige Aktionen gelten nur für GET oder nur für POST.
Fehlender erforderlicher WertÜberprüfen Sie botId, conversationId, Webhook-ID und Aktionsschreibweise.

Was als nächstes zu tun ist: Verwenden Sie Quick Start für erste Anfragen und dann /api-docs für die vollständige Referenz.

MethodeAktionZweck
GETlist-botsListen Sie alle Bots auf, die dem Schlüsseleigentümer API zur Verfügung stehen.
GETget-botRufen Sie eine Bot-Konfiguration nach Bot-ID ab.
POSTchatSenden Sie eine Besuchernachricht an einen Bot und senden Sie die KI-Antwort zurück.
GETconversationsListen Sie die letzten conversations für einen Bot auf, bis zu 100 Datensätze.
GETusageRückgabeplan, Credits, Bot-Anzahl, conversations und API Schlüssel usage.
GETlive-support-listListe conversations, die auf einen menschlichen Agenten wartet oder von diesem bearbeitet wird.
GETlive-support-messagesRufen Sie einen Übergabethread mit Nachrichten und Besucherinformationen ab.
POSTlive-support-replySenden Sie eine menschliche Agentenantwort von einem externen System.
POSTlive-support-claimFordern Sie ein wartendes Übergabegespräch an.
POSTlive-support-resolveLösen Sie die Übergabe oder geben Sie die Kontrolle an die KI zurück.
POSTwebhook-registerRegistrieren Sie einen HTTPS-Webhook-Endpunkt.
GETwebhook-listListen Sie Webhook-Registrierungen auf, ohne Geheimnisse zurückzugeben.
POSTwebhook-deleteLöschen Sie eine Webhook-Registrierung nach ID.
14

Leitfaden für Ingenieure: Funktionen hinzufügen

Fügen Sie Routen, Dashboard-Navigation, Bot-Builder-Einstellungen, Supabase Tabellen/Funktionen/Migrationen, API Dokumente, öffentliche Dokumentation, SEO-Prüfungen und lokale Überprüfung hinzu.

App-Feature-Workflow

Fügen Sie eine App-Route, eine Seite, ein Navigationselement und einen Dokumenteintrag hinzu

Wozu dient das: Verwenden Sie dies, wenn Sie eine neue kundenorientierte Dashboard-Funktion hinzufügen.

Bevor Sie beginnen
  • Erstellen Sie vor der Bearbeitung einen Zweig.
  • Identifizieren Sie, ob die Funktion zum App-Repository oder zum öffentlichen sem.chat-Frontend-Repository gehört.
  • Überprüfen Sie vorhandene Routen-, Seitenleisten-, i18n- und Einstellungsmuster, bevor Sie eine neue Struktur hinzufügen.
1

Fügen Sie die Route hinzu

Aktualisieren Sie src/App.tsx mit einer geschützten Route für Kundenseiten oder einer öffentlichen Route nur, wenn die Seite öffentlich sein muss.

Erwartetes Ergebnis: Der URL wird in der App aufgelöst, ohne auf NotFound zu klicken.
2

Erstellen oder aktualisieren Sie die Seitenkomponente

Verwenden Sie vorhandene Seitenmuster, Datenladezustände, Leerzustände, Ladezustände und Berechtigungen.

Erwartetes Ergebnis: Die Funktion verhält sich konsistent mit dem Dashboard.
3

Fügen Sie eine Dashboard-Navigation hinzu

Aktualisieren Sie die Seitenleiste/Navigationsquelle bei Bedarf mit Beschriftung, Symbol, Route und Plantoren.

Erwartetes Ergebnis: Benutzer können die neue Seite über die App-Shell entdecken.
4

Fügen Sie eine Registerkarte oder Einstellung für den Bot-Builder hinzu

Wenn die Funktion zu einem Bot gehört, fügen Sie sie in die Registerkarten Bot Builder ein und behalten Sie sie in vorhandenen Speicherabläufen bei.

Erwartetes Ergebnis: Die Bot-spezifische Konfiguration wird mit dem Bot gespeichert und bleibt nicht im lokalen Status hängen.
5

Fügen Sie Supabase Schema-/Funktionsänderungen hinzu

Erstellen Sie Migrationen für Tabellen/Richtlinien und Edge-Funktionen für serverseitige Arbeit.

Erwartetes Ergebnis: Datenbank- und Serververhalten können wiederholbar bereitgestellt werden.
6

Aktualisieren Sie die Form API, wenn sie öffentlich ist

Fügen Sie die Aktionsbehandlung in supabase/functions/public-api/index.ts hinzu oder erweitern Sie sie und dokumentieren Sie das Verhalten von x-api-key.

Erwartetes Ergebnis: Integrationen können die Funktion sicher nutzen.
7

App-Dokumente und öffentliche Dokumentation aktualisieren

Aktualisieren Sie In-App-Entwicklerdokumente und diese /documentation-Seite mit Screenshots und Klick-für-Klick-Schritten.

Erwartetes Ergebnis: Benutzer und Ingenieure sehen die Funktion an beiden Stellen.
8

Führen Sie Kontrollen durch

Führen Sie App-Tests/-Builds, SEO-Optimierer auf der öffentlichen Website, Sitemap-Prüfungen und Browserüberprüfungen durch.

Erwartetes Ergebnis: Die Funktion funktioniert lokal und die öffentliche Website bleibt crawlbar.
So testen Sie es: Öffnen Sie die neue Route, verwenden Sie die Funktion durchgehend, überprüfen Sie Konsolen-/Netzwerkfehler und überprüfen Sie alle Datenbankänderungen über die Benutzeroberfläche.
ProblemBeheben
Die Route funktioniert, aber die Navigation wird nicht hervorgehobenÜberprüfen Sie die Routenübereinstimmung und Weiterleitungspfade in der Seitenleiste.
Daten funktionieren lokal, werden aber nicht bereitgestelltBestätigen Sie die Migration, RLS-Richtlinien und Umgebungsvariablen für Edge-Funktionen.
Öffentliche Dokumente fehlen in der SitemapFühren Sie den SEO-Optimierer aus und überprüfen Sie sitemap.xml auf den kanonischen URL.

Was als nächstes zu tun ist: Erfassen oder generieren Sie Dokumentations-Screenshots neu, wenn sich die Benutzeroberfläche ändert.

Workflow für die Dokumentenwartung

Aktualisieren Sie diese öffentliche Dokumentationsseite nach Produktänderungen

Wozu dient das: Verwenden Sie dies, wenn sich Screenshots, Arbeitsabläufe, das Verhalten von API oder die Navigation ändern.

Bevor Sie beginnen
  • Verwenden Sie nur sichere Demodaten.
  • Geben Sie niemals echte Kunden, E-Mails, Zahlungsdetails, API-Schlüssel oder private conversations preis.
  • Aktualisieren Sie zuerst das englische Handbuch und anschließend jede lokalisierte Dokumentationsseite vor den SEO-Prüfungen.
1

Überprüfen Sie die geänderte Route

Öffnen Sie die App-Route und identifizieren Sie visuell und prozessual, was sich geändert hat.

Erwartetes Ergebnis: Sie wissen, welche Anleitungs-, Screenshot- und Fehlerbehebungszeilen bearbeitet werden müssen.
2

Erfassen oder erstellen Sie einen sicheren Screenshot

Verwenden Sie einen Demo-Arbeitsbereich und maskieren Sie Geheimnisse, bevor Sie WebP-Assets unter Assets/Dokumentation speichern.

Erwartetes Ergebnis: Der Screenshot ist korrekt und kann sicher veröffentlicht werden.
3

Aktualisieren Sie den Leitfaden

Bearbeiten Sie die entsprechenden Abschnitte „Wozu dient dies“, „Bevor Sie beginnen“, „Schritte“, „Erwartete Ergebnisse“, „Test“, „Fehlerbehebung“ und „Weiter“.

Erwartetes Ergebnis: Der Leitfaden sagt den Benutzern, worauf sie klicken müssen und was nach jedem Klick passieren soll.
4

Aktualisieren Sie die Navigation bei Bedarf

Fügen Sie den Abschnitt dem Sticky-Inhaltsverzeichnis, der mobilen Abschnittsauswahl und dem visuellen Index hinzu, wenn es sich um eine Hauptseite handelt.

Erwartetes Ergebnis: Leser können die neuen Inhalte schnell finden.
5

Führen Sie SEO-Tools aus

Führen Sie node tools/seo-optimize-static-pages.js und node tools/seo-optimize-static-pages.js --check aus.

Erwartetes Ergebnis: Canonical, Metadaten, Sitemap und Robots-Ausgabe bleiben korrekt.
6

Führen Sie Bereinigungs- und Diff-Prüfungen durch

Führen Sie node tools/static-translation-cleanup.js --audit und git diff --check aus.

Erwartetes Ergebnis: Statische Übersetzungen und Leerzeichen sind sauber.
7

Browserüberprüfung

Stellen Sie die Site lokal bereit und testen/dokumentieren Sie sie auf dem Desktop und auf Mobilgeräten.

Erwartetes Ergebnis: Bilder werden geladen, die Suche funktioniert, die Schaltflächen zum Kopieren funktionieren, das Inhaltsverzeichnis wird hervorgehoben und das Layout überschneidet sich nicht mit dem Cookie-Banner.
So testen Sie es: Suchen Sie unter /documentation nach dem geänderten Funktionsnamen und vergewissern Sie sich, dass der richtige Führungsblock angezeigt wird.
ProblemBeheben
Screenshot-Markierungen verschieben sich auf MobilgerätenBelassen Sie die Markierungen im Screenshot-Bild oder verwenden Sie responsive Markierungskoordinaten.
Bei der Suche fehlt der neue LeitfadenFügen Sie dem Datentitel nützliche Schlüsselwörter hinzu und geben Sie die genauen Produktbegriffe an, nach denen Benutzer suchen.
Lokalisierte Dokumentation wird veraltetNachdem Sie das englische Handbuch bearbeitet haben, aktualisieren Sie jede lokalisierte Dokumentationsseite, führen Sie den SEO-Optimierer erneut aus und bestätigen Sie, dass sitemap.xml jede Dokumentations-URL enthält.

Was als nächstes zu tun ist: Übernehmen Sie die Dokumentenseite, Assets, Kopf-/Fußzeilen-Links, .htaccess und Sitemap-Änderungen gemeinsam.

Benötigen Sie die gezielte API-Referenz?

Die ältere Seite /api-docs bleibt für API-Details auf Endpunktebene verfügbar.

Öffnen Sie API Dokumente