Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wekall.co/llms.txt

Use this file to discover all available pages before exploring further.

La API de WeKall usa tokens JWT de tipo Bearer. El flujo tiene dos pasos: obtener un token y luego incluirlo en cada request.

1. Obtener un access token

Llama a POST /api/v1/auth/token con tus credenciales (client_id y client_secret):
curl -X POST https://apis.wekall.co/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "tu-client-id",
    "client_secret": "tu-client-secret"
  }'
La respuesta incluye el access_token que debes usar en los siguientes requests.

2. Usar el token

Incluye el token en el header Authorization de cada request:
curl https://apis.wekall.co/api/v1/vicky/agents \
  -H "Authorization: Bearer {access_token}"
El token tiene una vigencia limitada. Cuando expire, vuelve a generarlo con el mismo endpoint. Las respuestas 401 indican un token invalido o expirado.

Roles y acceso a productos

Cada token esta asociado a un workspace y a los productos contratados. Si intentas acceder a un producto sin permiso, la API responde 403. Por ejemplo, los endpoints de Vicky AI requieren el rol voicebot.