# 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:**

<figure><img src="/files/af18ebd5b86db2bdfd5dce9bb3aec85823578b2d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
[*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.*](#user-content-fn-1)[^1]
{% endhint %}

#### 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

```http
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í          |

[^1]:


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hablla.com/hablla-docs-es/api/autenticacion-en-la-api-de-hablla.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.