Autenticação

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

Entre na plataforma

Acesse chat.lfautomatiza.com com sua conta.

Abra seu perfil

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

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"

const res = await fetch(
  'https://chat.lfautomatiza.com/api/v1/accounts/1/conversations',
  {
    headers: {
      'api_access_token': process.env.LF_CONNECT_TOKEN,
      'Content-Type': 'application/json'
    }
  }
);
const data = await res.json();

import os, requests

r = requests.get(
    'https://chat.lfautomatiza.com/api/v1/accounts/1/conversations',
    headers={
        'api_access_token': os.environ['LF_CONNECT_TOKEN'],
        'Content-Type': 'application/json'
    }
)
print(r.json())

$ch = curl_init('https://chat.lfautomatiza.com/api/v1/accounts/1/conversations');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'api_access_token: ' . getenv('LF_CONNECT_TOKEN'),
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

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

Tipo	Quem gera	Escopo	Quando usar
User Access Token	Cada agente em Perfil	Tudo que o agente pode fazer pela UI	Integração padrão
Agent Bot Access Token	Admin em Configurações → Agent Bots	Apenas inbox vinculada ao bot	Bots externos (n8n, Make)
Platform App API Key	Super-admin	Multi-conta (lê/cria contas)	Apenas casos enterprise

5. Respostas de erro

Código	Significado	O que checar
`401 Unauthorized`	Token ausente ou inválido	Confira header `api_access_token`
`403 Forbidden`	Sem permissão na ação	O usuário do token tem permissão pra esse recurso?
`404 Not Found`	Recurso não existe	`account_id` ou `id` corretos?

Exemplo de erro 401

{
  "error": "You need to sign in or sign up before continuing."
}

Comece aqui

Funcionalidades

1. Obter o token

2. Enviar nas requisições

3. Estrutura das URLs

4. Tipos de token

5. Respostas de erro

​1. Obter o token

​2. Enviar nas requisições

​3. Estrutura das URLs

​4. Tipos de token

​5. Respostas de erro

1. Obter o token

2. Enviar nas requisições

3. Estrutura das URLs

4. Tipos de token

5. Respostas de erro