Autenticação na API do Hablla

A API do Hablla utiliza autenticação via Workspace Token, uma abordagem recomendada para integrações, automações e robôs.

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 obter o workspace token acessando https://studio.hablla.com/ como administrador. Após entrar, acesse o menu de configurações através da engrenagem no canto superior direito. Dentro das informações da empresa será exibido o token.

📌 Exemplo visual:

Somente o usuário do tipo Administrador tem acesso a obter essa informação. Importante: substitua sempre por token_aqui ao compartilhar exemplos públicos para evitar vazamentos.

Identificando o ID da Workspace

O ID da workspace (exemplo: 64e683e59a0a699241b5222c) é ú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

curl "https://api.hablla.com/v2/workspaces/<ID_DA_WORKSPACE>/persons?page=1&limit=50" \
  -H "authorization: <SEU_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