Ir para a navegação

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.

from elevenlabs import ElevenLabs, ProvisionResellerWorkspaceSubscription, TeamInviteRequest
elevenlabs = ElevenLabs()
workspace = elevenlabs.reception.workspaces.create(
business_name="Bright Smile Dental",
subscription=ProvisionResellerWorkspaceSubscription(
tier_id="smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
),
members=[
TeamInviteRequest(email="owner@brightsmiledental.com", role="workspace_admin"),
TeamInviteRequest(email="frontdesk@brightsmiledental.com"),
],
complete_onboarding=True,
idempotency_key="provision-crm-10482",
)
for result in workspace.member_results:
if result.outcome == "failed":
print("Invite failed:", result.email, result.error_status)
if workspace.onboarding_completed_at_unix is None:
elevenlabs.reception.workspaces.complete_onboarding(workspace.workspace_id)

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.

customers = [
{"crm_id": "10482", "name": "Bright Smile Dental", "owner": "owner@brightsmiledental.com"},
{"crm_id": "10483", "name": "Harbor Physio", "owner": "hello@harborphysio.com"},
]
workspace_ids = {}
for customer in customers:
workspace = elevenlabs.reception.workspaces.create(
business_name=customer["name"],
subscription=ProvisionResellerWorkspaceSubscription(
tier_id="smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
),
members=[TeamInviteRequest(email=customer["owner"], role="workspace_admin")],
idempotency_key=f"provision-crm-{customer['crm_id']}",
)
workspace_ids[customer["crm_id"]] = workspace.workspace_id

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.

cursor = None
while True:
page = elevenlabs.reception.workspaces.list(cursor=cursor, page_size=100)
for workspace in page.workspaces:
if workspace.onboarding_completed_at_unix is None:
elevenlabs.reception.workspaces.complete_onboarding(workspace.workspace_id)
if not page.has_more:
break
cursor = page.next_cursor

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.

from elevenlabs import TimeRangeModel, WorkingHours
workspace_id = "8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7"
weekday = [TimeRangeModel(start_hour=8, start_minute=0, end_hour=17, end_minute=0)]
saturday = [TimeRangeModel(start_hour=9, start_minute=0, end_hour=13, end_minute=0)]
location = elevenlabs.reception.locations.create(
xi_workspace_id=workspace_id,
name="Mission Street",
address="2140 Mission St, San Francisco, CA 94110",
notes="Free parking behind the building.",
operating_hours=WorkingHours(hours={**{str(day): weekday for day in range(5)}, "5": saturday}),
)

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.

hygienist = elevenlabs.reception.staff.create(
xi_workspace_id=workspace_id,
name="Maria Lopez (hygienist)",
customer_facing_name="Maria",
description="Dental hygienist. Speaks English and Spanish.",
email="maria@brightsmiledental.com",
location_id=location.id,
working_hours=WorkingHours(
hours={str(day): [TimeRangeModel(start_hour=9, start_minute=0, end_hour=15, end_minute=0)] for day in range(4)},
),
)

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.

from elevenlabs import ReceptionIntakeQuestion, ReceptionServiceVariant
elevenlabs.reception.services.create(
xi_workspace_id=workspace_id,
name="Cleaning",
description="Routine cleaning and polish.",
variants=[
ReceptionServiceVariant(duration_minutes=45, price=120),
ReceptionServiceVariant(duration_minutes=60, price=160),
],
any_staff_member=False,
staff_ids=[hygienist.id],
buffer_minutes=10,
)
elevenlabs.reception.services.create(
xi_workspace_id=workspace_id,
name="Invisalign consultation",
pricing_mode="quote",
variants=[ReceptionServiceVariant(duration_minutes=30)],
intake_questions=[
ReceptionIntakeQuestion(label="Have you worn braces or aligners before?", kind="choice", options=["Yes", "No"]),
ReceptionIntakeQuestion(label="What would you like to fix?", required=True),
],
)

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.

from elevenlabs import DateModel
elevenlabs.reception.holidays.create(
xi_workspace_id=workspace_id,
name="Winter break",
start_date=DateModel(year=2026, month=12, day=24),
end_date=DateModel(year=2026, month=12, day=26),
time_off_type="location",
location_id=location.id,
)

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.

with open("new-patient-faq.pdf", "rb") as file:
elevenlabs.reception.knowledge_sources.upload(xi_workspace_id=workspace_id, file=file)

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.

from elevenlabs import ReceptionCustomerFacingConfigPatch
receptionist_id = elevenlabs.reception.receptionists.list(xi_workspace_id=workspace_id)[0].agent_id
elevenlabs.reception.receptionists.update(
receptionist_id,
xi_workspace_id=workspace_id,
config=ReceptionCustomerFacingConfigPatch(
first_message="Thanks for calling Bright Smile Dental, how can I help?",
additional_languages=["es"],
tone_traits=["warm", "concise"],
details_to_collect=["full name", "date of birth", "insurance provider"],
additional_instructions="Never give medical advice. Offer the next available appointment instead.",
),
)

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.

elevenlabs.reception.receptionists.transfer_rules.create(
receptionist_id,
xi_workspace_id=workspace_id,
label="Front desk",
phone_number="+14155550142",
condition="The caller has a dental emergency or asks to speak to a person.",
)
elevenlabs.reception.receptionists.rules.create(
receptionist_id,
xi_workspace_id=workspace_id,
title="New patients",
description="Ask new patients to arrive 15 minutes early to fill in forms.",
)

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.

elevenlabs.reception.team.invites.create(
xi_workspace_id=workspace_id,
email="office.manager@brightsmiledental.com",
role="workspace_admin",
)