Autenticação na API do Hablla

A API do Hablla oferece dois métodos de autenticação. Cada um é indicado para diferentes finalidades, variando entre integrações automatizadas e ações rastreáveis por usuários humanos.

1. Autenticação via Workspace Token (Recomendado)

O Workspace Token é um token vinculado diretamente a uma área de trabalho específica. Ele é a forma mais prática e robusta de autenticação para integrações e automações.

Principais Vantagens:

• Permite acesso à maioria das rotas da API.

• Não expira.

• Pode ser usado em ambientes automatizados com segurança.

• Oferece rastreabilidade (as ações ficam registradas no histórico como executadas via automação).

Como obter

Você pode capturar o workspace token ao executar um fluxo no Hablla que utiliza um componente da API. No retorno da requisição, ele estará disponível no cabeçalho Authorization.

📌 Exemplo visual:

O campo Authorization contém o token que você deverá utilizar. Importante: substitua sempre por token_aqui ao compartilhar exemplos públicos para evitar vazamentos.

Identificando o ID da Workspace

O ID da workspace (exemplo: 64e683e59a0a699241b5727c) é único por cliente. Você pode encontrá-lo diretamente na URL do navegador ao acessar seu ambiente no Hablla Studio:

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

Exemplo de requisição

GET [https://api.hablla.com/v1/workspaces/](https://api.hablla.com/v1/workspaces/)<ID_DA_WORKSPACE>/persons?page=1&limit=50

Headers:
Authorization: <SEU_TOKEN_AQUI>

2. Autenticação via User Token (opcional)

O User Token representa um usuário humano autenticado. É utilizado quando se deseja que as ações da API apareçam no histórico como realizadas por um colaborador específico.

Como funciona

Esse token é gerado após o login do usuário.

⚠️ Atenção: Este token expira em aproximadamente 1 hora. Após esse tempo, é necessário reautenticar.

Exemplo de requisição com User Token

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

Conclusão

Tipo de Token	Ideal para	Ações rastreáveis?	Expiração	Recomendado?
Workspace Token	Integrações, automações, robôs	✅ Sim (como robô)	❌ Não	✅ Sim
User Token	Ações atribuídas a usuários específicos	✅ Sim (por usuário)	✅ Sim (~1h)	Opcional