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 Workspace Token es un token vinculado directamente a un área de trabajo específica. Es la forma más práctica y robusta de autenticación para integraciones y automatizaciones.

Principales ventajas:

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

• No expira.

• Puede usarse de forma segura en entornos automatizados.

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

Cómo obtenerlo

Puedes capturar el workspace token al ejecutar un flujo en Hablla que utiliza un componente de la API. En la respuesta de la solicitud, estará disponible en el encabezado Authorization.

📌 Ejemplo visual:

El campo Authorization contiene el token que deberás utilizar. Importante: sustitúyelo siempre por token_aquí al compartir ejemplos públicos para evitar filtraciones.

Identificando el ID de la Workspace

El ID de la 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_DE_LA_WORKSPACE>

Ejemplo de solicitud

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

Conclusión

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