Saltar a la navegación

Aprovisionamiento e incorporación

Ejemplos para crear espacios de trabajo de clientes y completar la información que conoce su recepcionista.

Estos ejemplos se basan en el inicio rápido. Usan el mismo cliente, Bright Smile Dental, y todas las llamadas al espacio de trabajo incluyen su ID en xi-workspace-id.

Aprovisionar espacios de trabajo

Aprovisionar en una solicitud

Cuando todavía no tengas los datos del negocio, crea el espacio de trabajo, suscríbelo, invita al propietario y completa la incorporación en una sola llamada. La recepcionista se crea solo a partir del nombre del negocio, así que completa el perfil del negocio después. Pasa una idempotency_key para que un reintento tras un tiempo de espera no pueda crear un segundo espacio de trabajo.

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)

La incorporación durante la creación se realiza según el mejor esfuerzo: si falla, onboarding_completed_at_unix es null y puedes reintentarlo con complete_onboarding.

Aprovisionar clientes desde tu CRM

Deriva cada idempotency_key de tu propio ID de cliente para que, al ejecutar la importación de nuevo, se devuelvan los espacios de trabajo que ya creó en vez de crear otros nuevos. La misma clave con un cuerpo diferente se rechaza con 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

Completar la incorporación de espacios de trabajo que aún están en configuración

workspaces.list muestra qué espacios de trabajo no han terminado la incorporación. Se puede reintentar complete_onboarding con seguridad, por lo que puedes ejecutarlo de forma programada.

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

Describir el negocio

Añade las ubicaciones, el personal, los servicios y los cierres del negocio antes de completar la incorporación para que la recepcionista se cree a partir de ellos. También puedes añadirlos o modificarlos en cualquier momento después.

Hasta que se complete la incorporación, el asistente de configuración que ve el propietario del negocio al iniciar sesión puede sustituir o eliminar estos datos. Completa la incorporación antes de que el propietario inicie sesión.

Añadir una ubicación

Cada ubicación tiene su propio horario. Los días van de 0 (lunes) a 6 (domingo), y un día sin entrada está cerrado.

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}),
)

Añadir un miembro del personal

Un miembro del personal en una ubicación sigue el horario de esa ubicación, a menos que le asignes su propio working_hours. customer_facing_name es lo que escuchan quienes llaman; name se mantiene como etiqueta interna.

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)},
),
)

Añadir servicios

Un servicio tiene una o más variants, cada una con su propia duración y precio; la primera es la predeterminada. Configura any_staff_member como false para limitar quién puede prestarlo.

Cuando el precio depende del trabajo, usa pricing_mode="quote" y añade intake_questions. La recepcionista las pregunta y recibe una solicitud de presupuesto en lugar de indicar un precio.

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),
],
)

Cerrar por vacaciones

Un cierre cubre días completos, desde start_date hasta end_date. Usa time_off_type="location" para el negocio o "staff" con el ID del miembro del personal en resource_id para la ausencia de una persona.

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,
)

Subir un documento

Proporciona a la recepcionista un documento del que pueda responder, como unas preguntas frecuentes o una lista de precios. Usa knowledge_sources.add_url para un sitio web, como en el inicio rápido.

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

Configurar la recepcionista

Estas llamadas necesitan el ID de la recepcionista: customer_facing_agent_id de complete_onboarding o agent_id de receptionists.list.

Configurar el saludo, los idiomas y qué recopilar

Solo cambian los ajustes que envíes.

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 llamadas y añadir reglas

Una regla de transferencia pasa la llamada a una persona cuando se cumple su condition. Las transferencias dependen del plan: primero comprueba is_transfer_allowed en la recepcionista. Una regla indica a la recepcionista cómo debe comportarse; una regla strict se sigue siempre y una suggestion sirve de orientación.

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.",
)

Invitar al equipo

Invita a personas en cualquier momento después de crear el espacio de trabajo. Una invitación pendiente ocupa una plaza, por lo que se rechaza una invitación cuando los miembros y las invitaciones alcanzan el tamaño de equipo del plan.

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