Provisionamento e integração
Exemplos para criar espaços de trabalho de clientes e preencher as informações que a recepcionista conhece.
Estes exemplos se baseiam no início rápido. Eles usam o mesmo cliente Bright Smile Dental, e todas as chamadas do espaço de trabalho incluem seu ID em xi-workspace-id.
Provisionar espaços de trabalho
Provisionar em uma solicitação
Quando você ainda não tem os detalhes da empresa, crie o espaço de trabalho, assine um plano, convide o proprietário e conclua a integração em uma única chamada. A recepcionista é criada apenas com base no nome da empresa, então preencha o perfil comercial depois. Passe uma idempotency_key para que uma nova tentativa após um tempo limite não possa criar um segundo espaço de trabalho.
A integração na criação é feita conforme possível: se falhar, onboarding_completed_at_unix será null, e você poderá tentar novamente com complete_onboarding.
Provisionar clientes a partir do seu CRM
Derive cada idempotency_key do seu próprio ID de cliente para que executar a importação novamente retorne os espaços de trabalho já criados, em vez de criar novos. A mesma chave com um corpo diferente é rejeitada com idempotency_key_reused.
Concluir a integração de espaços de trabalho ainda em configuração
workspaces.list mostra quais espaços de trabalho ainda não concluíram a integração. É seguro tentar complete_onboarding novamente, então você pode executá-lo em uma programação definida.
Descrever a empresa
Adicione os locais, a equipe, os serviços e os fechamentos da empresa antes de concluir a integração, para que a recepcionista seja criada com base neles. Você também pode adicioná-los ou alterá-los a qualquer momento depois disso.
Até que a integração seja concluída, o assistente de configuração que o proprietário da empresa vê ao entrar pode substituir ou remover esses dados. Conclua a integração antes que o proprietário entre.
Adicionar um local
Cada local tem seu próprio horário de funcionamento. Os dias vão de 0 (segunda-feira) a 6 (domingo), e um dia sem entrada está fechado.
Adicionar um membro da equipe
Um membro da equipe em um local segue o horário desse local, a menos que você defina seu próprio working_hours. customer_facing_name é o que quem liga ouve; name permanece como o rótulo interno.
Adicionar serviços
Um serviço tem uma ou mais variants, cada uma com sua própria duração e preço; a primeira é a padrão. Defina any_staff_member como false para limitar quem pode realizá-lo.
Quando o preço depende do serviço, use pricing_mode="quote" e adicione intake_questions. A recepcionista faz essas perguntas e registra uma solicitação de orçamento em vez de informar um preço.
Fechar em um feriado
Um fechamento abrange dias inteiros, de start_date a end_date. Use time_off_type="location" para a empresa ou "staff", com o ID do membro da equipe em resource_id, para a folga de uma pessoa.
Enviar um documento
Forneça à recepcionista um documento para responder, como uma FAQ ou uma tabela de preços. Use knowledge_sources.add_url para um site, como no início rápido.
Configurar a recepcionista
Estas chamadas exigem o ID da recepcionista: customer_facing_agent_id de complete_onboarding ou agent_id de receptionists.list.
Definir a saudação, os idiomas e o que coletar
Apenas as configurações que você enviar serão alteradas.
Transferir chamadas e adicionar regras
Uma regra de transferência encaminha a chamada para uma pessoa quando sua condition é atendida. As transferências dependem do plano: primeiro verifique is_transfer_allowed na recepcionista. Uma regra informa à recepcionista como agir; uma regra strict é sempre seguida, enquanto uma suggestion é uma orientação.
Convidar a equipe
Convide pessoas a qualquer momento após a criação do espaço de trabalho. Um convite pendente ocupa uma vaga, então um convite é recusado quando membros e convites atingem o tamanho da equipe previsto no plano.