Saltar a la navegación

Inicio rápido de la API de Reception

Crea el espacio de trabajo de un cliente, véndele un plan y asigna su recepcionista a un número de teléfono.

Esta guía aprovisiona un cliente de principio a fin con la API de Reception: un espacio de trabajo con un plan de pago, un perfil de negocio desde el que responde la recepcionista y un número de teléfono que la conecta con las llamadas.

Requisitos previos

  • Una clave de API del panel de administración de distribuidores, configurada como ELEVENLABS_API_KEY. El panel de administración está disponible solo para socios de Reception.ai; para convertirte en uno, contacta con nuestro equipo de ventas.
  • Una tarjeta registrada para tu cuenta de distribuidor. Al suscribir un espacio de trabajo, se realiza un cargo.
  • El SDK de Python (pip install elevenlabs) o el SDK de TypeScript (npm install @elevenlabs/elevenlabs-js).

Aprovisionar un cliente

1

Elegir un plan

Enumera los niveles que vendes. Se muestran primero los más baratos y el primero es la prueba.

from elevenlabs import ElevenLabs
elevenlabs = ElevenLabs()
tiers = elevenlabs.reception.tiers.list()
for tier in tiers:
print(tier.tier_id, tier.display_name, tier.tier_economics.monthly_price_usd)
2

Crear el espacio de trabajo

Crea el espacio de trabajo del cliente, suscríbelo a un nivel de pago e invita al propietario del negocio. Las invitaciones se realizan según el mejor esfuerzo: el resultado de cada una está en member_results.

from elevenlabs import ProvisionResellerWorkspaceSubscription, TeamInviteRequest
workspace = elevenlabs.reception.workspaces.create(
business_name="Bright Smile Dental",
subscription=ProvisionResellerWorkspaceSubscription(
tier_id=tiers[1].tier_id,
billing_period="monthly_period",
),
members=[
TeamInviteRequest(email="owner@brightsmiledental.com", role="workspace_admin"),
],
)
workspace_id = workspace.workspace_id

Omite subscription para crear un espacio de trabajo sin plan y asignarle uno más tarde.

3

Describir el negocio

La recepcionista responde a partir del perfil del negocio. A partir de aquí, cada llamada actúa sobre el nuevo espacio de trabajo, por lo que incluye la cabecera xi-workspace-id. Los días de operating_hours van de 0 (lunes) a 6 (domingo), y un día sin entrada está cerrado.

from elevenlabs import TimeRangeModel, WorkingHours
weekday = [TimeRangeModel(start_hour=8, start_minute=0, end_hour=17, end_minute=0)]
elevenlabs.reception.business_profile.update(
xi_workspace_id=workspace_id,
business_country="US",
business_description="Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
timezone="America/Los_Angeles",
operating_hours=WorkingHours(hours={str(day): weekday for day in range(5)}),
)
elevenlabs.reception.knowledge_sources.add_url(
xi_workspace_id=workspace_id,
url="https://brightsmiledental.com",
crawl_entire_site=True,
)

Los servicios, el personal, las ubicaciones y los festivos se añaden de la misma manera, con los grupos services, staff, locations y holidays.

4

Completar la incorporación

Al completar la incorporación se crea la recepcionista del espacio de trabajo a partir del perfil del negocio. Puedes reintentarlo con seguridad. También puedes pasar complete_onboarding=True al crear el espacio de trabajo, pero en ese caso la recepcionista se crea solo a partir del nombre del negocio.

onboarding = elevenlabs.reception.workspaces.complete_onboarding(workspace_id)
receptionist_id = onboarding.customer_facing_agent_id
5

Asignar un número de teléfono a la recepcionista

En Estados Unidos y Canadá, se toma del conjunto o se compra un número con uno de los códigos de área solicitados, recurriendo a cualquier número del país del negocio si es necesario.

assignment = elevenlabs.reception.phone_numbers.create(
xi_workspace_id=workspace_id,
customer_facing_agent_id=receptionist_id,
area_codes=["415", "628"],
)
print(assignment.phone_number)

La recepcionista ya responde las llamadas a phone_number.

Siguientes pasos