Bereitstellung und Onboarding
Beispiele zum Erstellen von Kunden-Workspaces und zum Hinterlegen des Wissens der Rezeption.
Diese Beispiele bauen auf dem Schnellstart auf. Sie verwenden denselben Kunden Bright Smile Dental, und jeder Workspace-Aufruf übergibt dessen ID in xi-workspace-id.
Workspaces bereitstellen
In einer Anfrage bereitstellen
Wenn Ihnen die Unternehmensdetails noch nicht vorliegen, erstellen Sie den Workspace, abonnieren Sie ihn, laden Sie den Inhaber ein und schließen Sie das Onboarding in einem Aufruf ab. Die Rezeption wird allein anhand des Unternehmensnamens erstellt. Ergänzen Sie das Unternehmensprofil daher anschließend. Übergeben Sie einen idempotency_key, damit ein Wiederholungsversuch nach einem Timeout keinen zweiten Workspace erstellen kann.
Das Onboarding bei der Erstellung erfolgt nach bestem Bemühen: Falls es fehlschlägt, ist onboarding_completed_at_unix null, und Sie können es mit complete_onboarding wiederholen.
Kunden aus Ihrem CRM bereitstellen
Leiten Sie jeden idempotency_key aus Ihrer eigenen Kunden-ID ab. So gibt ein erneuter Import die bereits erstellten Workspaces zurück, statt neue zu erstellen. Derselbe Key mit einem anderen Body wird mit idempotency_key_reused abgelehnt.
Onboarding für Workspaces in der Einrichtung abschließen
workspaces.list zeigt, welche Workspaces das Onboarding noch nicht abgeschlossen haben. complete_onboarding kann sicher wiederholt werden. Sie können dies daher nach einem Zeitplan ausführen.
Unternehmen beschreiben
Fügen Sie die Standorte, Mitarbeitenden, Services und Schließzeiten des Unternehmens hinzu, bevor Sie das Onboarding abschließen, damit die Rezeption daraus erstellt wird. Sie können diese Daten auch danach jederzeit hinzufügen oder ändern.
Bis das Onboarding abgeschlossen ist, kann der Einrichtungsassistent, den der Unternehmensinhaber beim Anmelden sieht, diese Daten ersetzen oder entfernen. Schließen Sie das Onboarding ab, bevor sich der Inhaber anmeldet.
Standort hinzufügen
Jeder Standort hat eigene Öffnungszeiten. Die Tage reichen von 0 (Montag) bis 6 (Sonntag); ein Tag ohne Eintrag ist geschlossen.
Mitarbeiter hinzufügen
Ein Mitarbeiter an einem Standort übernimmt dessen Öffnungszeiten, sofern Sie ihm nicht eigene working_hours geben. customer_facing_name hören Anrufer; name bleibt die interne Bezeichnung.
Services hinzufügen
Ein Service hat eine oder mehrere variants, jeweils mit eigener Dauer und eigenem Preis; die erste ist die Standardvariante. Setzen Sie any_staff_member auf false, um festzulegen, wer ihn ausführen darf.
Wenn der Preis von der Arbeit abhängt, verwenden Sie pricing_mode="quote" und fügen Sie intake_questions hinzu. Die Rezeption stellt diese Fragen und nimmt eine Angebotsanfrage entgegen, statt einen Preis zu nennen.
An Feiertagen schließen
Eine Schließzeit umfasst ganze Tage, von start_date bis end_date. Verwenden Sie time_off_type="location" für das Unternehmen oder "staff" mit der ID des Mitarbeiters in resource_id für die Abwesenheit einer einzelnen Person.
Dokument hochladen
Geben Sie der Rezeption ein Dokument, aus dem sie Antworten ableiten kann, etwa eine FAQ oder eine Preisliste. Verwenden Sie für eine Website knowledge_sources.add_url, wie im Schnellstart.
Rezeption einrichten
Für diese Aufrufe benötigen Sie die ID der Rezeption: customer_facing_agent_id aus complete_onboarding oder agent_id aus receptionists.list.
Begrüßung, Sprachen und zu erfassende Daten festlegen
Nur die Einstellungen, die Sie senden, werden geändert.
Anrufe weiterleiten und Regeln hinzufügen
Eine Weiterleitungsregel übergibt den Anruf an eine Person, wenn ihre condition erfüllt ist. Weiterleitungen hängen vom Plan ab: Prüfen Sie zuerst is_transfer_allowed der Rezeption. Eine Regel weist die Rezeption an, wie sie sich verhalten soll; eine strict-Regel wird immer befolgt, eine suggestion ist eine Richtlinie.
Team einladen
Laden Sie Personen jederzeit ein, nachdem der Workspace erstellt wurde. Eine ausstehende Einladung belegt einen Platz. Daher wird eine Einladung abgelehnt, sobald Mitglieder und Einladungen zusammen die Teamgröße des Plans erreichen.