Sistema LUVA CRM

LUVA CLI e API

LUVA CLI e API

O seu CRM no terminal e nos agentes de IA.

Claude Code, Codex, Claude Desktop e os seus scripts trabalham no LUVA com as mesmas permissões que você tem no painel.

  • Mais de 2.300 comandos

    Pessoas, tarefas, oportunidades, WhatsApp, landing pages e mais. O que o painel faz, o terminal também faz.

  • Claude Code e Codex

    Um comando instala a skill, e o agente passa a trabalhar no seu LUVA.

  • Claude Desktop

    Extensão pronta para instalar, com o token que você mesmo cria e pode revogar.

  • As suas permissões

    Seu acesso, o limite do plano e os módulos ativos valem em cada comando.

Em uma frase

Uma landing page com agenda, criada e publicada sem abrir o painel. Você, o seu script ou o seu agente cria a página a partir de um modelo, liga a agenda e publica. Publicar é uma ação externa, e por isso pede a confirmação --yes.

Entre a criação e a publicação ainda cabem tema, textos, campos do formulário, revisão e prévia. O guia da CLI traz o passo a passo completo.

luvacrm landing-pages create --name "Promo outubro" --template-id service-inquiry --mutation-id "$(uuidgen)"
luvacrm landing-pages scheduling set --page-id <page-id> --agenda 234
luvacrm landing-pages publish --page-id <page-id> --expected-draft-revision 15 --expected-lifecycle-version 1 --mutation-id "$(uuidgen)" --yes

Instalar e entrar

Passo 1

Baixe o programa

Há binários para Windows, macOS (Intel e Apple Silicon) e Linux, na página app.luvacrm.com.br/cli. Eles não são assinados, então o Windows e o macOS vão avisar. Confira o arquivo SHA256SUMS antes de abrir.

Passo 2

Entre pelo navegador

O comando luvacrm login abre a página Autorize o acesso da CLI. Você confere o nome do computador, escolhe até que nível a CLI pode ir e clica em Autorizar. Sem navegador no computador, como num acesso por SSH, o modo de código resolve.

Passo 3

Em servidor, use um token

Onde ninguém pode autorizar, crie um token pessoal. Ele começa com luva_pat_, aparece uma única vez e vale 90 dias, se você não definir outra validade.

luvacrm token create --name relatorio-diario --max-risk read --expires 30d

No servidor, o token vai na variável LUVACRM_TOKEN. Escolha o menor nível que o script precisa: um relatório diário pede só leitura.

Com as suas permissões

Quem decide até onde a CLI vai é você, no login.

Leitura

Só consulta. Nada é criado nem alterado.

Escrita

Consulta, cria e altera dados do CRM. É o padrão do login.

Destrutivo

Também exclui, sobrescreve em massa e muda permissões e configurações.

Externo

Também envia mensagens a quem é de fora e movimenta dinheiro.

Um comando acima do nível autorizado falha e diz qual nível falta. Exclusões e publicações pedem confirmação explícita. O acesso expira sozinho e você revoga quando quiser. Prefere pedir em conversa, dentro do próprio CRM? Conheça a LARA.

Para quem integra

Quando o outro lado é um sistema, não uma pessoa.

API pública

Chave criada em Configurações, com documentação OpenAPI. Cobre pessoas, empresas, oportunidades, tarefas, tags, disponibilidade de agenda e webhooks.

Webhooks assinados

O LUVA envia um aviso assinado ao seu sistema quando algo acontece com uma pessoa, empresa, oportunidade, tarefa, ticket ou fatura. Os avisos trazem identificadores, sem telefone, e-mail ou texto de mensagem.

MCP com 16 ferramentas

Capte leads sem duplicar quando o pedido se repete, trabalhe com tarefas e consulte funis, produtos, pessoas e oportunidades. Cada empresa precisa ser liberada: peça ao suporte.

n8n com fluxos prontos

Cinco fluxos para importar: captar lead, captar lead com tarefa de acompanhamento, receber o aviso de lead registrado, receber tarefa concluída e listar tarefas atrasadas.

O MCP local, que o Claude Desktop usa pelo comando luvacrm mcp, é outro caminho e roda no seu computador. O MCP remoto, para servidores e automações, é o que precisa de liberação.

Perguntas sobre a CLI e as integrações

Para usar a CLI você digita comandos, então ajuda estar à vontade com o terminal. Escrever código não é preciso: com a skill instalada, o Claude Code ou o Codex rodam os comandos a partir do que você pede. E se você só usa o LUVA pelo navegador, pode seguir assim, a CLI é opcional.
Não. Cada comando segue as mesmas regras do painel: as suas permissões, o limite do plano e os módulos ativos continuam valendo. No login, você ainda escolhe até que nível a CLI pode ir (leitura, escrita, destrutivo ou externo), e um comando acima disso falha e diz qual nível falta. O acesso expira e pode ser revogado em Configurações, na página Acesso CLI.
Sim. Cada versão da CLI traz uma extensão do Claude Desktop, um arquivo que você abre com duplo clique. Você cria um token pessoal em Configurações, na página Acesso CLI, e cola nas configurações da extensão. A IA age com o acesso que você autorizou no token, e a extensão usa o Node.js que já vem com o Claude Desktop.
Tem. A API pública usa uma chave que você cria em Configurações e cobre pessoas, empresas, oportunidades, tarefas, tags, disponibilidade de agenda e webhooks. Os webhooks avisam o seu sistema, com assinatura, quando algo acontece no CRM. O MCP remoto, que é o endereço na internet para ferramentas como o n8n, precisa ser liberado para a sua empresa: peça ao suporte.

O LUVA onde você já trabalha.

Terminal, agentes de IA e integrações, com as permissões da sua conta.

Conteúdo revisado em .