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.
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.
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.
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.
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:
Una solicitud que supera el límite devuelve 429. Espera y vuelve a intentarlo.
Siguientes pasos
- Inicio rápido: crea el espacio de trabajo de un cliente y asigna su recepcionista a un número de teléfono.
- Aprovisionamiento e incorporación: 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: cambia el plan de un cliente y consulta los cargos realizados a tu tarjeta.