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

# API de Reception

La API de Reception permite a un distribuidor de Reception.ai hacer mediante código lo que el panel de administración de distribuidores hace manualmente: crear un espacio de trabajo para cada cliente, venderle uno de tus planes, configurar su recepcionista y consultar los cargos realizados a tu tarjeta. Todas las rutas de API se encuentran bajo `https://api.elevenlabs.io/v1/reception` y están disponibles en los SDK de Python y TypeScript como `reception`.

> **Note**
>
> El panel de administración de distribuidores, y con él la API de Reception, está disponible solo para socios de Reception.ai. Si
> te interesa colaborar con nosotros, [contacta con nuestro equipo de ventas](https://www.reception.ai/contact-sales).

## Autenticación

Crea una clave de API en el panel de administración de distribuidores. Solo las claves creadas allí pueden llamar a la API de Reception; cualquier otra clave de API de ElevenLabs se rechaza con `not_a_reseller_api_key`. La clave se muestra una sola vez, así que guárdala en un gestor de secretos.

Envía la clave en la cabecera `xi-api-key` o configura `ELEVENLABS_API_KEY` para que el SDK la lea.

## Rutas de API de distribuidores y espacios de trabajo

La API actúa en dos niveles.

| Nivel              | Actúa sobre                                                        | Grupos del SDK                                                                                                                                        |
| ------------------ | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Distribuidor       | Tu cuenta de distribuidor                                          | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| Espacio de trabajo | El espacio de trabajo de un cliente, indicado en `xi-workspace-id` | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

Las rutas de API de espacios de trabajo necesitan la cabecera `xi-workspace-id`, configurada con el ID de un espacio de trabajo que hayas creado. Se rechaza una solicitud sin ella o para un espacio de trabajo que pertenezca a otro distribuidor. En los SDK, la cabecera es el argumento `xi_workspace_id` en Python y el campo `xiWorkspaceId` en 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
```

## Paginación

`workspaces.list` y `billing.list_invoices` devuelven una página cada vez. Pasa el `next_cursor` de una respuesta como `cursor` para obtener la página siguiente y detente cuando `has_more` sea `false`.

## Límites de velocidad

Los límites se aplican por distribuidor, en todas sus claves de API:

| Solicitudes                          | Límite         |
| ------------------------------------ | -------------- |
| Lecturas (`GET`)                     | 600 por minuto |
| Escrituras (todos los demás métodos) | 120 por minuto |

Una solicitud que supera el límite devuelve `429`. Espera y vuelve a intentarlo.

## Siguientes pasos

* [Inicio rápido](/docs/es/reception-ai/reception-api/quickstart): crea el espacio de trabajo de un cliente y asigna su recepcionista a un número de teléfono.
* [Aprovisionamiento e incorporación](/docs/es/reception-ai/reception-api/provisioning-and-onboarding): ejemplos para crear espacios de trabajo en bloque y añadir las ubicaciones, el personal, los servicios y la configuración de la recepcionista de un negocio.
* [Suscripciones y facturación](/docs/es/reception-ai/reception-api/subscriptions-and-billing): cambia el plan de un cliente y consulta los cargos realizados a tu tarjeta.