Pular para o conteúdo principal

Automatize o Leankeep com sua IA

Este guia mostra como usar uma IA (ChatGPT, Claude ou similar) para criar automações e integrações com a LightHouse API — sem precisar ser programador. Você descreve o que quer em português, a IA lê esta documentação e monta as chamadas para você.

Há dois caminhos abaixo. Comece pelo Nível 1 se você nunca integrou uma API; pule para o Nível 2 se já se vira com código.

O que dá para fazer​

Alguns exemplos reais que gestores pedem:

  • "Quantas ocorrências o técnico João resolveu em maio? Foi mais ou menos que abril?"
  • "Liste as atividades preventivas pendentes da unidade Shopping Centro."
  • "Crie uma ocorrência de vazamento no 3º andar e atribua prioridade alta."
  • "Gere um resumo mensal de produtividade de toda a equipe."

A IA transforma esses pedidos em chamadas de API — desde que você dê a ela os arquivos certos desta documentação.

Nível 1 — Gestor (sem experiência técnica)​

Passo 1 — Escolha sua IA​

Use ChatGPT (pago, versão com acesso a arquivos) ou Claude. Ambos conseguem ler documentação técnica e gerar instruções.

Passo 2 — Dê a documentação para a IA​

Cole esta mensagem no início da conversa com a IA, trocando o texto entre colchetes pelo seu caso:

Você é meu assistente de integração com a LightHouse API do Leankeep. A especificação completa da API está em: https://docs.leankeep.com/openapi/lighthouse.json O guia de fluxos está em: https://docs.leankeep.com/llms.txt Leia esses materiais. Depois me ajude a: [DESCREVA O QUE QUER, ex: "consultar quantas ocorrências o usuário 42 resolveu em maio de 2026"]. Sempre me explique em português o que cada passo faz, e me diga exatamente o que preciso preencher (token, IDs, datas).

Passo 3 — Obtenha seu token de acesso​

A IA vai pedir um token (sua credencial de acesso). Para obtê-lo, você faz login na API. Peça à IA:

Me mostre o comando exato para gerar meu token, usando meu usuário e senha do Leankeep.

Ela vai te dar algo baseado no guia de Autenticação — o endpoint POST /v1/auth/ com Plataform=6 (API). Nunca compartilhe seu token publicamente.

Passo 4 — Siga as instruções da IA​

Com o token e os IDs (empresa, usuário, unidade), a IA monta as chamadas. Você pode:

  • Pedir para ela explicar cada chamada antes de executar.
  • Testar direto no portal: cada endpoint tem um botão Send API Request (veja o painel direito na Referência).

Dica de ouro​

Comece sempre no ambiente Sandbox (https://lighthouse.lkp.dev.br) — é um ambiente de testes que não afeta dados reais. Só use produção quando tiver certeza.

Nível 2 — Vibecoder (quer ir rápido)​

Materiais para dar à IA​

Em ordem de prioridade:

  1. https://docs.leankeep.com/openapi/lighthouse.json — spec OpenAPI 3.0 completo (277 operações, 256 schemas). É a fonte de verdade para gerar código.
  2. https://docs.leankeep.com/llms.txt — índice para IA, aponta para tudo.
  3. Receitas de fluxo (passo a passo com endpoints reais):
  4. Glossário de IDs e enums — significado dos códigos.
  5. Autenticação — fluxo do token.

Prompt inicial recomendado​

Contexto: vou integrar com a LightHouse API do Leankeep (gestão de manutenção predial).
Spec OpenAPI: https://docs.leankeep.com/openapi/lighthouse.json
Índice: https://docs.leankeep.com/llms.txt

Regras da API que você DEVE respeitar:
- Autenticação: POST https://auth.lkp.app.br/v1/auth/ (multipart/form-data),
  com login, Password e Plataform=6 (6 = API). Retorna um JWT.
- Envie o JWT em Authorization: Bearer <token> nas chamadas.
- Alguns endpoints (relatórios) exigem o header EmpresaId (não é query param).
- O campo "plataforma" no corpo das requisições também é 6 (API).
- Versione o path: use v3 para ocorrências/correções, v1 para o resto.
- Produção: https://lighthousev2.lkp.app.br | Sandbox: https://lighthouse.lkp.dev.br
- Respeite o rate limit: 1200 requisições/hora.

Tarefa: [DESCREVA]. Gere o código em [linguagem] e explique cada passo.

Armadilhas comuns (avise sua IA)​

ArmadilhaO certo
EmpresaId como query paramVai no header HTTP
plataforma: "WEB" (string)É numérico: 6 (API)
URL de produção sem v2Produção é lighthousev2.lkp.app.br (sandbox é sem v2)
Baixar lista inteira para contarUse os endpoints /count
Loop de baixas individuaisUse tarefasIds: [] (baixa em lote numa chamada)

Testar sem escrever código​

O portal tem try it out embutido: em cada endpoint, no painel direito, abra Auth, cole o token, preencha os parâmetros e clique Send API Request. Ambiente Sandbox é o padrão.

Usando GPT Actions​

Se sua IA for um GPT customizado com Actions (não uma conversa comum), atenção: o spec completo (openapi/lighthouse.json) tem ~1.3MB, e o GPT Actions rejeita specs acima de 1MB. Use um dos specs reduzidos por caso de uso (reports.json, ocorrencias.json, atividades.json, cada um bem menor) em vez do spec completo. O guia Perguntas de negócio tem o fluxo testado ponta a ponta (nome → ID → relatório) e a regra de qual ID usar em cada pergunta.

Checklist de validação​

Antes de rodar qualquer automação em produção, confirme:

  • Testei primeiro no Sandbox (lighthouse.lkp.dev.br)
  • O token está válido e não está exposto em código público
  • Usei Plataform=6 no login e plataforma: 6 nos corpos
  • EmpresaId está no header onde exigido
  • Respeitei o rate limit (1200 req/h)
  • Endpoints de escrita (POST/PUT/DELETE) foram revisados — eles alteram dados reais
  • Confirmei os valores de código (status, tipo) no glossário ou nos endpoints de referência

Precisa de ajuda?​