Provisionering och introduktion
Exempel på hur du skapar kundarbetsytor och fyller i vad deras receptionist känner till.
De här exemplen bygger vidare på snabbstarten. De använder samma kund, Bright Smile Dental, och varje arbetsyteanrop har dess ID i xi-workspace-id.
Provisionera arbetsytor
Provisionera i en begäran
När du ännu inte har företagsuppgifterna kan du skapa arbetsytan, teckna en prenumeration, bjuda in ägaren och slutföra introduktionen i ett enda anrop. Receptionisten skapas enbart utifrån företagsnamnet, så fyll i företagsprofilen efteråt. Skicka en idempotency_key så att ett nytt försök efter en timeout inte kan skapa en andra arbetsyta.
Introduktion vid skapandet görs efter bästa förmåga: om den misslyckas är onboarding_completed_at_unix null och du kan försöka igen med complete_onboarding.
Provisionera kunder från ditt CRM
Härled varje idempotency_key från ditt eget kund-ID, så att en ny importkörning returnerar de arbetsytor som redan skapats i stället för att skapa nya. Samma nyckel med en annan body avvisas med idempotency_key_reused.
Slutför introduktionen för arbetsytor som fortfarande konfigureras
workspaces.list visar vilka arbetsytor som inte har slutfört introduktionen. complete_onboarding kan utan problem köras igen, så du kan köra detta enligt ett schema.
Beskriv företaget
Lägg till företagets platser, personal, tjänster och stängningsdagar innan du slutför introduktionen, så att receptionisten skapas utifrån dem. Du kan också lägga till eller ändra dem när som helst efteråt.
Tills introduktionen är slutförd kan installationsguiden som företagsägaren ser när hen loggar in ersätta eller ta bort dessa data. Slutför introduktionen innan ägaren loggar in.
Lägg till en plats
Varje plats har sina egna öppettider. Dagarna går från 0 (måndag) till 6 (söndag), och en dag utan post är stängd.
Lägg till en personalmedlem
En personalmedlem på en plats följer platsens öppettider om du inte ger personen egna working_hours. customer_facing_name är vad de som ringer hör; name förblir den interna etiketten.
Lägg till tjänster
En tjänst har en eller flera variants, var och en med sin egen längd och sitt eget pris; den första är standard. Ange any_staff_member som false för att begränsa vem som kan utföra den.
När priset beror på jobbet använder du pricing_mode="quote" och lägger till intake_questions. Receptionisten ställer dem och tar emot en offertförfrågan i stället för att ange ett pris.
Stäng för en helgdag
En stängning omfattar hela dagar, från start_date till end_date. Använd time_off_type="location" för företaget, eller "staff" med personalmedlemmens ID i resource_id för en persons ledighet.
Ladda upp ett dokument
Ge receptionisten ett dokument att svara utifrån, till exempel vanliga frågor och svar eller en prislista. Använd knowledge_sources.add_url för en webbplats, som i snabbstarten.
Konfigurera receptionisten
Dessa anrop behöver receptionistens ID: customer_facing_agent_id från complete_onboarding, eller agent_id från receptionists.list.
Ange hälsning, språk och vad som ska samlas in
Endast inställningarna du skickar ändras.
Vidarekoppla samtal och lägg till regler
En vidarekopplingsregel kopplar samtalet till en person när dess condition uppfylls. Vidarekopplingar beror på planen: kontrollera först is_transfer_allowed på receptionisten. En regel talar om för receptionisten hur den ska agera; en strict-regel följs alltid, medan en suggestion är en riktlinje.
Bjud in teamet
Bjud in personer när som helst efter att arbetsytan har skapats. En väntande inbjudan tar upp en plats, så en inbjudan avvisas när medlemmar och inbjudningar når planens teamstorlek.