# Diligens

> Coloque no seu ERP, checkout, gateway ou e-commerce um assistente de IA com a sua marca, que responde com os números de cada cliente, executa ações no seu sistema e manda dicas sobre as vendas.

A Diligens é um assistente de IA white label para plataformas que processam pedidos: ERPs e sistemas de gestão, checkouts, gateways de pagamento e plataformas de e-commerce, além de fintechs e bancos. A empresa dona do sistema coloca o chat dentro do próprio produto, com a própria marca, e cada cliente dela pergunta em português ("Quanto vendi em setembro?", "Por que meu caixa caiu?", "Qual produto me dá mais margem?") e recebe a resposta calculada com os próprios pedidos e contas. Feita para o mercado brasileiro: Pix, boleto, cartão, NF-e, contas a pagar e a receber.

O que o assistente faz:

- Responde com os números de cada usuário final: vendas, canais, formas de pagamento e a conversão de cada uma (Pix e boleto expirados, cartão recusado, estornos), taxas do gateway ou do marketplace, margem por produto e fluxo de caixa, explicando o que mudou.
- Executa ações no sistema do cliente (por exemplo, criar um cupom) a partir da documentação da API dele (OpenAPI, Postman, Markdown ou texto livre), que vira um catálogo de ações revisável no painel. Toda ação que altera dados mostra um resumo e espera a confirmação do usuário.
- Manda dicas curtas sobre as vendas ao longo do dia.

Como a integração funciona:

1. Depois da primeira recarga de créditos paga, a empresa gera uma API key no painel da Diligens (uma por conta) e a guarda no backend.
2. O backend dela chama `POST /chat/token` com o `external_id` do usuário logado e recebe um token de chat que vale 5 minutos.
3. O SDK JavaScript do chat, no front, usa esse token para conversar com a IA e executa as ações no navegador, com a sessão que o usuário já tem no sistema.
4. O backend envia os pedidos com `PUT /orders`, o catálogo de produtos com `PUT /products` e as contas a receber e a pagar com `PUT /financial-entries` (lotes de até 300 pedidos, 500 produtos e 200 contas, idempotente): o histórico uma vez e depois cada mudança.

Segurança e privacidade: a IA nunca chama o sistema do cliente diretamente e a Diligens não guarda senha nem token dele. Documento, e-mail e telefone são gravados encriptados. O histórico das conversas é apagado depois de 7 dias, e o painel mostra métricas de uso sem o texto das conversas. O tratamento de dados segue a LGPD.

Preço: uso pré-pago em reais. A empresa recarrega créditos no painel (de R$ 50 a R$ 5.000 por recarga, por Pix, boleto ou cartão) e cada resposta da IA desconta do saldo. Conta nova começa sem saldo: a API e o chat funcionam depois da primeira recarga paga.

A documentação técnica é pública, em https://docs.diligensai.com.br/: guias de integração e a referência de cada rota da API, com exemplos em cURL, Node.js, Python e PHP.

Para agentes de IA que vão fazer a integração: a documentação inteira em Markdown, num arquivo só, está em https://docs.diligensai.com.br/llms-full.txt. Cada página da documentação também tem a versão em Markdown, nos links abaixo (a URL da página com `.md` no fim).

## Produto

- [Página inicial](https://app.diligensai.com.br/): Coloque no seu ERP, checkout, gateway ou e-commerce um assistente de IA com a sua marca, que responde com os números de cada cliente, executa ações no seu sistema e manda dicas sobre as vendas.
- [Criar conta](https://app.diligensai.com.br/register): Crie a conta da sua empresa na Diligens e coloque um assistente de IA com a sua marca dentro da sua plataforma.

## Documentação: Guias

- [Introdução](https://docs.diligensai.com.br/guias/introducao.md): Conheça a Diligens, o que o assistente faz dentro do seu produto e como os componentes da integração se relacionam.
- [Quickstart](https://docs.diligensai.com.br/guias/quickstart.md): Integre o chat do zero até as respostas com os números do seu usuário: API key, rota de token, SDK e envio dos pedidos.
- [Integrar com IA](https://docs.diligensai.com.br/guias/integrar-com-ia.md): Faça a integração com o Claude Code, o Cursor ou o Codex: a documentação em Markdown para agentes e um prompt pronto para começar.
- [Autenticação](https://docs.diligensai.com.br/guias/autenticacao.md): A API key do seu backend e o token de chat usado pelo SDK: onde cada um fica e quanto tempo vale.
- [SDK do chat](https://docs.diligensai.com.br/guias/sdk.md): Adicione o chat ao seu site com uma tag script e o Diligens.init: rota de token, opções, ações, personalização e modo na página.
- [Usuário final (external_id)](https://docs.diligensai.com.br/guias/usuario-final.md): O identificador que vincula o histórico do chat aos pedidos e às contas de cada usuário do seu sistema.
- [Erros](https://docs.diligensai.com.br/guias/erros.md): O formato padrão de erro da API, os códigos estáveis e como tratar cada um deles.
- [Limites de chamadas](https://docs.diligensai.com.br/guias/limites.md): O número de chamadas por minuto aceito por cada rota e como tratar o status 429 com o header Retry-After.
- [Créditos](https://docs.diligensai.com.br/guias/creditos.md): Como o uso da IA é cobrado e o que funciona sem saldo.
- [Privacidade (LGPD)](https://docs.diligensai.com.br/guias/lgpd.md): Os dados armazenados com criptografia, a retenção do histórico e como apagar todos os dados de um usuário final.

## Documentação: Referência da API

- [Introdução à API](https://docs.diligensai.com.br/referencia/introducao.md): A URL base, a autenticação por API key e as convenções comuns a todas as rotas.
- [Criar token de chat](https://docs.diligensai.com.br/referencia/token-chat.md): Gera, no seu backend, o token de curta duração que o SDK usa para abrir o chat de um usuário final.
- [Enviar pedidos](https://docs.diligensai.com.br/referencia/pedidos.md): Sincroniza os pedidos de um usuário final, na carga do histórico ou por webhook. A operação é idempotente e aceita lotes de até 300 pedidos.
- [Enviar catálogo de produtos](https://docs.diligensai.com.br/referencia/produtos.md): Sincroniza o cadastro dos produtos de um usuário final, sem estoque, para a IA opinar sobre um produto antes da primeira venda. A operação é idempotente e aceita lotes de até 500 produtos.
- [Enviar contas](https://docs.diligensai.com.br/referencia/contas.md): Sincroniza as contas a receber e a pagar de um usuário final, para que o chat responda sobre caixa e vencimentos.
- [Apagar usuário final](https://docs.diligensai.com.br/referencia/apagar-usuario.md): Apaga o usuário final e todos os seus dados: histórico, pedidos, compradores, catálogo de produtos e contas. A operação é irreversível.

## Legal

- [Termos de Uso](https://app.diligensai.com.br/terms): Termos de Uso da Diligens: conta, créditos pré-pagos, reembolso, uso da IA, responsabilidades e LGPD.
- [Política de Privacidade](https://app.diligensai.com.br/privacy): Como a Diligens trata os dados pessoais: o que coletamos, para quê, com quem compartilhamos, por quanto tempo e os seus direitos pela LGPD.

## Optional

- [Documentação completa](https://docs.diligensai.com.br/llms-full.txt): todas as páginas da documentação em Markdown, num arquivo só.
- [Sitemap](https://app.diligensai.com.br/sitemap.xml): lista das páginas públicas.
