Autenticación en la API de Hablla

La API de Hablla utiliza autenticación mediante Workspace Token, un enfoque recomendado para integraciones, automatizaciones y robots.

Autenticación mediante Workspace Token (Recomendado)

El Token de Workspace es un token vinculado directamente a un espacio de trabajo específico. Es la forma más práctica y robusta de autenticación para integraciones y automatizaciones.

Principales ventajas:

• Permite acceso a la mayoría de las rutas de la API.

• No expira.

• Puede usarse con seguridad en entornos automatizados.

• Ofrece trazabilidad (las acciones quedan registradas en el historial como ejecutadas mediante automatización).

Cómo obtener

Puedes obtener el token de workspace accediendo https://studio.hablla.com/ como administrador. Después de entrar, accede al menú de configuración a través del engranaje en la esquina superior derecha. Dentro de la información de la empresa se mostrará el token.

📌 Ejemplo visual:

Solo el usuario de tipo Administrador tiene acceso para obtener esta información. Importante: sustituye siempre por token_aqui al compartir ejemplos públicos para evitar filtraciones.

Identificando el ID del Workspace

El ID del workspace (ejemplo: 64e683e59a0a699241b5222c) es único por cliente. Puedes encontrarlo directamente en la URL del navegador al acceder a tu entorno en Hablla Studio:

https://studio.hablla.com/workspaces/<ID_DA_WORKSPACE>

Ejemplo de solicitud

curl "https://api.hablla.com/v2/workspaces/<ID_DA_WORKSPACE>/persons?page=1&limit=50" \
  -H "authorization: <SEU_TOKEN_AQUI>" \
  -H "accept: application/json"

Conclusión

Tipo de token	Ideal para	¿Acciones rastreables?	Expiración	¿Recomendado?
Token de Workspace	Integraciones, automatizaciones, robots	✅ Sí (como robot)	❌ No	✅ Sí