Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lfautomatiza.com/llms.txt

Use this file to discover all available pages before exploring further.

A API do LF Connect usa token estático enviado no header de cada requisição. Não há OAuth, JWT renovável ou expiração automática — você gera, copia e usa.

​
1. Obter o token

1

Entre na plataforma

Acesse chat.lfautomatiza.com com sua conta.
2

Abra seu perfil

Clique no avatar no canto inferior esquerdo → Configurações do perfil.
3

Copie o Access Token

Role até a seção Access Token e clique em Copiar. Esse é o token de usuário.
Trate o token como senha. Nunca commitar em repositório público, nunca expor em código front-end (use proxy backend). Se vazar, vá em Reset Access Token pra invalidar o anterior.

​
2. Enviar nas requisições

Use o header api_access_token em toda chamada: 
curl https://chat.lfautomatiza.com/api/v1/accounts/1/conversations \
  -H "api_access_token: SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json"

​
3. Estrutura das URLs

Quase todos os endpoints são escopados por conta (workspace). A URL segue o padrão: 
https://chat.lfautomatiza.com/api/v1/accounts/{account_id}/{recurso}
O account_id aparece na URL da plataforma assim que você entra na conta: chat.lfautomatiza.com/app/accounts/1/dashboard → seu account_id é 1.

​
4. Tipos de token

TipoQuem geraEscopoQuando usar
User Access TokenCada agente em PerfilTudo que o agente pode fazer pela UIIntegração padrão
Agent Bot Access TokenAdmin em Configurações → Agent BotsApenas inbox vinculada ao botBots externos (n8n, Make)
Platform App API KeySuper-adminMulti-conta (lê/cria contas)Apenas casos enterprise

​
5. Respostas de erro

CódigoSignificadoO que checar
401 UnauthorizedToken ausente ou inválidoConfira header api_access_token
403 ForbiddenSem permissão na açãoO usuário do token tem permissão pra esse recurso?
404 Not FoundRecurso não existeaccount_id ou id corretos?
Exemplo de erro 401
{
  "error": "You need to sign in or sign up before continuing."
}