Passer à la navigation

Guide de démarrage de l’API Reception

Créez le Workspace d’un client, vendez-lui un forfait et attribuez un numéro de téléphone à sa réceptionniste.

Ce guide configure un client de bout en bout avec l’API Reception : un Workspace avec un forfait payant, un profil d’entreprise sur lequel la réceptionniste s’appuie pour répondre et un numéro de téléphone qui lui transfère les appels.

Prérequis

  • Une clé API issue du panneau d’administration du revendeur, définie comme ELEVENLABS_API_KEY. Le panneau d’administration est réservé aux partenaires Reception.ai ; pour le devenir, contactez notre équipe commerciale.
  • Une carte enregistrée pour votre compte revendeur. L’abonnement d’un Workspace est facturé sur cette carte.
  • Le SDK Python (pip install elevenlabs) ou le SDK TypeScript (npm install @elevenlabs/elevenlabs-js).

Provisionner un client

1

Choisir un forfait

Listez les niveaux que vous vendez. Ils sont classés du moins cher au plus cher, et le premier correspond à l’essai.

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

Créer le Workspace

Créez le Workspace du client, abonnez-le à un niveau payant et invitez le propriétaire de l’entreprise. Les invitations sont effectuées au mieux : le résultat de chacune figure dans 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

Omettez subscription pour créer un Workspace sans forfait et en attribuer un plus tard.

3

Décrire l’entreprise

La réceptionniste répond à partir du profil de l’entreprise. À partir de maintenant, chaque appel agit sur le nouveau Workspace et transmet donc l’en-tête xi-workspace-id. Les jours dans operating_hours vont de 0 (lundi) à 6 (dimanche), et un jour sans entrée est fermé.

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

Les services, le personnel, les établissements et les jours fériés s’ajoutent de la même manière, avec les groupes services, staff, locations et holidays.

4

Terminer l’intégration

Terminer l’intégration crée la réceptionniste du Workspace à partir du profil de l’entreprise. Vous pouvez réessayer sans risque. Vous pouvez également transmettre complete_onboarding=True lorsque vous créez le Workspace, mais la réceptionniste est alors créée à partir du seul nom de l’entreprise.

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

Attribuer un numéro de téléphone à la réceptionniste

Aux États-Unis et au Canada, un numéro utilisant l’un des indicatifs régionaux demandés est prélevé dans le pool ou acheté, avec recours à n’importe quel numéro du pays de l’entreprise si nécessaire.

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 réceptionniste répond désormais aux appels vers phone_number.

Étapes suivantes