> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# API Reception

L'API Reception consente a un rivenditore Reception.ai di fare via codice ciò che il pannello di amministrazione del rivenditore fa manualmente: creare un workspace per ogni cliente, assegnargli uno dei tuoi piani, configurare la sua receptionist e monitorare gli addebiti sulla tua carta. Ogni endpoint è disponibile in `https://api.elevenlabs.io/v1/reception` e negli SDK Python e TypeScript come `reception`.

> **Note**
>
> Il pannello di amministrazione del rivenditore e, con esso, l'API Reception sono disponibili solo per i partner Reception.ai. Se
> ti interessa collaborare con noi, [contatta il nostro team commerciale](https://www.reception.ai/contact-sales).

## Autenticazione

Crea una chiave API nel pannello di amministrazione del rivenditore. Solo le chiavi create lì possono chiamare l'API Reception; qualsiasi altra chiave API ElevenLabs viene rifiutata con `not_a_reseller_api_key`. La chiave viene mostrata una sola volta, quindi salvala in un secret manager.

Invia la chiave nell'header `xi-api-key` oppure imposta `ELEVENLABS_API_KEY` e lascia che l'SDK la legga.

## Endpoint del rivenditore e del workspace

L'API opera su due livelli.

| Livello     | Opera su                                                  | Gruppi SDK                                                                                                                                            |
| ----------- | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rivenditore | Il tuo account rivenditore                                | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| Workspace   | Il workspace di un cliente, indicato in `xi-workspace-id` | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

Gli endpoint del workspace richiedono l'header `xi-workspace-id`, impostato sull'ID di un workspace che hai creato. Una richiesta senza questo header, o relativa a un workspace che appartiene a un altro rivenditore, viene rifiutata. Negli SDK, l'header corrisponde all'argomento `xi_workspace_id` in Python e al campo `xiWorkspaceId` in TypeScript.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
    print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)

staff = elevenlabs.reception.staff.list(
    xi_workspace_id=workspaces.workspaces[0].workspace_id,
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const { workspaces } = await elevenlabs.reception.workspaces.list({ pageSize: 50 });
for (const workspace of workspaces) {
  console.log(workspace.workspaceId, workspace.businessName, workspace.billingTier);
}

const staff = await elevenlabs.reception.staff.list({
  xiWorkspaceId: workspaces[0].workspaceId,
});
```

```bash
elevenlabs reception workspaces list --page-size 50
```

## Paginazione

`workspaces.list` e `billing.list_invoices` restituiscono una pagina alla volta. Passa il `next_cursor` di una risposta come `cursor` per ottenere la pagina successiva e interrompi quando `has_more` è `false`.

## Limiti di frequenza

I limiti si applicano per rivenditore, su tutte le sue chiavi API:

| Richieste                          | Limite        |
| ---------------------------------- | ------------- |
| Letture (`GET`)                    | 600 al minuto |
| Scritture (tutti gli altri metodi) | 120 al minuto |

Una richiesta oltre il limite restituisce `429`. Attendi e riprova.

## Passaggi successivi

* [Guida rapida](/docs/it/reception-ai/reception-api/quickstart): crea il workspace di un cliente e assegna un numero di telefono alla sua receptionist.
* [Provisioning e onboarding](/docs/it/reception-ai/reception-api/provisioning-and-onboarding): esempi per creare workspace in blocco e aggiungere sedi, personale, servizi e impostazioni della receptionist di un'attività.
* [Abbonamenti e fatturazione](/docs/it/reception-ai/reception-api/subscriptions-and-billing): modifica il piano di un cliente e verifica gli addebiti sulla tua carta.