Ir para a navegação

Início rápido da API do Reception

Crie o espaço de trabalho de um cliente, venda um plano a ele e coloque sua recepcionista em um número de telefone.

Este guia provisiona um cliente de ponta a ponta com a API do Reception: um espaço de trabalho em um plano pago, um perfil comercial para a recepcionista responder e um número de telefone que toca para ela.

Pré-requisitos

  • Uma chave de API do painel de administração do revendedor, definida como ELEVENLABS_API_KEY. O painel de administração está disponível apenas para parceiros do Reception.ai; para se tornar um, entre em contato com nossa equipe de vendas.
  • Um cartão cadastrado na sua conta de revendedor. Assinar um plano para um espaço de trabalho gera cobranças nele.
  • O SDK de Python (pip install elevenlabs) ou o SDK de TypeScript (npm install @elevenlabs/elevenlabs-js).

Provisionar um cliente

1

Escolher um plano

Liste os níveis que você vende. Eles vêm do mais barato para o mais caro, e o primeiro é o teste.

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

Criar o espaço de trabalho

Crie o espaço de trabalho do cliente, assine um nível pago para ele e convide o proprietário da empresa. Os convites são feitos conforme possível: o resultado de cada um fica em 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

Omita subscription para criar um espaço de trabalho sem plano e atribuir um depois.

3

Descrever a empresa

A recepcionista responde com base no perfil comercial. A partir daqui, todas as chamadas atuam no novo espaço de trabalho, portanto incluem o cabeçalho xi-workspace-id. Os dias em operating_hours vão de 0 (segunda-feira) a 6 (domingo), e um dia sem entrada está fechado.

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

Serviços, equipe, locais e feriados são adicionados da mesma forma, com os grupos services, staff, locations e holidays.

4

Concluir a integração

Concluir a integração cria a recepcionista do espaço de trabalho a partir do perfil comercial. É seguro tentar novamente. Você também pode passar complete_onboarding=True ao criar o espaço de trabalho, mas nesse caso a recepcionista será criada apenas com base no nome da empresa.

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

Dar um número de telefone à recepcionista

Nos EUA e no Canadá, um número com um dos códigos de área solicitados é selecionado do conjunto disponível ou comprado, com alternativa para qualquer número no país da empresa.

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)

A recepcionista agora atende chamadas para phone_number.

Próximas etapas