Guia completo de uso da plataforma DocuAgro para produtores rurais e cooperativas. Compliance EUDR via Bot Telegram + Inteligência Artificial + Painel Web.
| 01 | O que é o DocuAgro | Pág. 03 |
| 02 | Para quem é | Pág. 03 |
| 03 | Guia do Produtor — Bot Telegram | Pág. 04 |
| 04 | Exemplo Completo de Uso | Pág. 06 |
| 05 | Documentos Coletados (8) | Pág. 07 |
| 06 | Inteligência Artificial | Pág. 08 |
| 07 | Guia da Cooperativa — Painel Web | Pág. 09 |
| 08 | API REST | Pág. 10 |
| 09 | Dossiê PDF | Pág. 11 |
| 10 | Instalação e Configuração | Pág. 12 |
| 11 | Arquitetura Técnica | Pág. 13 |
| 12 | FAQ e Troubleshooting | Pág. 14 |
O DocuAgro é uma plataforma que automatiza a coleta, validação e organização de documentação de produtores rurais para compliance com o EUDR (Regulamento da União Europeia contra Desmatamento — EU 2023/1115).
A plataforma combina três componentes:
O Regulamento (UE) 2023/1115 proíbe a importação na UE de commodities produzidas em áreas desmatadas após 31/12/2020. Afeta: Soja, Café, Cacau, Óleo de Palma, Madeira, Gado e Borracha. Produtores brasileiros que exportam precisam comprovar geolocalização, ausência de desmatamento e conformidade ambiental.
Qualquer produtor que cultive commodities afetadas pelo EUDR e exporte (direta ou indiretamente via cooperativa/trading) para a Europa. O produtor interage 100% pelo Telegram, sem precisar instalar nenhum aplicativo novo.
Organizações que precisam comprovar a conformidade de dezenas a milhares de produtores associados. Acompanham tudo pelo Painel Web com dashboard, busca, dossiês e exportação CSV.
O produtor acessa o DocuAgro pelo Telegram, buscando por @docuagro_bot. Todo o processo é guiado por inteligência artificial em linguagem simples.
| Comando | Função | Quando usar |
|---|---|---|
| /start | Iniciar cadastro | Primeira vez no bot |
| /status | Ver progresso | A qualquer momento |
| /dossie | Gerar dossiê PDF | Após enviar documentos |
| /pular | Pular documento | Se não tem o doc agora |
| /ajuda | Menu de ajuda | Se tiver dúvidas |
Ao enviar /start, a IA faz perguntas simples para conhecer o produtor:
Após o cadastro, a IA pede um documento por vez, na seguinte ordem:
Quando todos os documentos forem enviados, o produtor pode gerar o dossiê com /dossie. O bot gera um PDF profissional e envia direto no chat.
A qualquer momento, o produtor pode enviar /status para ver como está sua documentação:
Legenda dos ícones:
| Ícone | Significado |
|---|---|
| ✅ | Documento aprovado |
| 🟡 | Enviado, em análise |
| ❌ | Rejeitado (precisa reenviar) |
| ⚠️ | Vencido |
| ⬜ | Não enviado ainda |
Se o produtor não tem um documento no momento, pode usar /pular para ir ao próximo. Ele poderá enviar o documento pulado depois.
O comando /ajuda mostra todos os comandos disponíveis e dicas de envio. Além disso, o produtor pode fazer qualquer pergunta em texto e a IA responderá com orientações sobre o que é cada documento e onde obtê-lo.
Veja abaixo uma conversa típica entre um produtor e o DocuAgro:
O DocuAgro coleta e valida 8 documentos obrigatórios para compliance EUDR:
| # | Documento | O que é | Onde obter | Validação OCR |
|---|---|---|---|---|
| 1 | CAR | Cadastro Ambiental Rural | car.gov.br (SICAR) | Número SICAR |
| 2 | CCIR | Certificado Imóvel Rural | sncr.serpro.gov.br (INCRA) | Código INCRA |
| 3 | ITR | Imposto Territorial Rural | Receita Federal | CPF/CNPJ |
| 4 | Geo | Georreferenciamento | Técnico agrimensor | Coordenadas GPS |
| 5 | Licença | Licença Ambiental | Órgão estadual (SEMA/IMA) | Validade + OCR |
| 6 | Contrato | Contrato de Arrendamento | Cartório (se não for dono) | OCR geral |
| 7 | NF | Nota Fiscal de Venda | Última NF-e ou NF produtor | CPF/CNPJ + dados |
| 8 | Declaração | Não Desmatamento | Gerada automaticamente | Automática ✅ |
Cada documento enviado passa por um pipeline de validação:
Este documento só é necessário se o produtor não for proprietário da terra. Se for dono, pode usar /pular para ir ao próximo.
Este documento é gerado automaticamente pelo sistema. O produtor não precisa providenciar — o DocuAgro cria a autodeclaração com base nos dados cadastrados.
O DocuAgro utiliza o modelo GPT-4o-mini da OpenAI, configurado como um especialista em documentação agrícola brasileira e compliance EUDR.
A cada mensagem, a IA recebe o contexto completo do produtor:
Durante o onboarding, a IA usa uma segunda chamada ao GPT para extrair dados estruturados das mensagens do produtor (nome, CPF, município, etc.) e salvar automaticamente no banco.
A IA sabe orientar o produtor sobre como e onde obter cada documento:
| Parâmetro | Valor | Motivo |
|---|---|---|
| Modelo | gpt-4o-mini | Custo baixo, boa qualidade |
| Temperature | 0.7 | Respostas naturais mas consistentes |
| Max tokens | 800 | Respostas curtas e diretas |
| Presence penalty | 0.1 | Evita repetição |
A cooperativa ou trading acompanha todos os produtores pelo Painel Web, acessível de qualquer navegador.
A tela inicial mostra 5 indicadores em tempo real:
| Indicador | Descrição |
|---|---|
| 👥 Total de Produtores | Quantos produtores estão cadastrados |
| ✅ Completos | Produtores com todos os docs aprovados |
| 📋 Em Andamento | Produtores enviando documentos |
| ⚠️ Pendentes | Produtores que não iniciaram ou pararam |
| 📄 Documentos Recebidos | Total de documentos no sistema |
Abaixo do dashboard há a barra de Compliance EUDR Geral — mostra o percentual de produtores em conformidade.
Tabela com todos os produtores cadastrados, mostrando:
Campo de busca no topo da lista permite filtrar por nome, CPF, propriedade ou município.
Ao clicar em "Dossiê" na lista de produtores, o sistema gera um PDF profissional com:
O botão "Exportar CSV" gera uma planilha com todos os produtores — nome, CPF, propriedade, município, estado, área, cultura, status e progresso. Ideal para importar em ERPs ou planilhas.
Todos os dados do DocuAgro são acessíveis via API REST para integração com sistemas externos.
| Endpoint | Método | Descrição | Retorno |
|---|---|---|---|
| /api/health | GET | Health check do sistema | Status, versão, timestamp |
| /api/dashboard | GET | Estatísticas gerais | Total produtores, completos, pendentes, docs |
| /api/produtores | GET | Listar todos os produtores | Array com dados e status de cada um |
| /api/produtores/:id | GET | Detalhe de um produtor | Dados + documentos + último dossiê |
| /api/produtores/:id/dossie | POST | Gerar dossiê PDF | Caminho do arquivo gerado |
| /api/dossie/download/:arquivo | GET | Download do dossiê | Arquivo PDF |
| /api/exportar/csv | GET | Exportar todos em CSV | Arquivo CSV |
No MVP, a API não possui autenticação. Para produção, será necessário implementar JWT, rate limiting e HTTPS. Consulte o roadmap de segurança.
O dossiê é o produto final do DocuAgro — um PDF profissional que reúne toda a documentação do produtor para fins de compliance EUDR.
| Seção | Conteúdo |
|---|---|
| Capa | Logo DocuAgro, nome do produtor, propriedade, status de compliance, data |
| Dados do Produtor | Nome, CPF, propriedade, município, estado, área, cultura, data de cadastro |
| Resumo dos Documentos | Tabela com todos os 8 documentos, status e data de envio |
| Detalhes (por doc) | Status, arquivo, dados extraídos pelo OCR, resultado da validação, miniatura |
| Declaração Final | Declaração de conformidade EUDR com espaço para assinatura |
| Rodapé | Número da página em todas as páginas |
O dossiê usa um tema profissional verde com:
O dossiê pode ser gerado de 3 formas:
O PDF é gerado com PDFKit e salvo em uploads/dossies/. O nome do arquivo segue o padrão: dossie_[CPF]_[data_hora].pdf
| Tabela | Função | Campos principais |
|---|---|---|
| cooperativas | Cooperativas cadastradas | id, nome, cnpj, contato |
| produtores | Produtores rurais | id, nome, cpf, propriedade, município, cultura, etapa_atual, status |
| documentos | Documentos enviados | id, produtor_id, tipo, status, arquivo_path, dados_extraidos |
| conversas | Histórico de mensagens | id, produtor_id, role, conteudo, timestamp |
| dossies | Dossiês gerados | id, produtor_id, arquivo_path, docs_incluidos |
Não. O DocuAgro funciona 100% pelo Telegram, que a maioria já tem instalado.
No momento não. O WhatsApp está no roadmap (v2.0). Atualmente funciona apenas pelo Telegram.
O modelo é B2B — a cooperativa paga e oferece o serviço aos seus associados. O produtor não paga nada.
Sim. São armazenados em servidor próprio, em diretórios isolados por produtor. Não são enviados para cloud pública.
O progresso é salvo automaticamente. Ele pode voltar a qualquer momento e continuar de onde parou.
O OCR faz validação inicial automatizada. Documentos com confiança baixa são marcados como "Em análise" para verificação manual pela cooperativa.
O SQLite suporta até centenas de milhares de registros. Para escala maior (10k+ produtores simultâneos), recomenda-se migrar para PostgreSQL.
| Problema | Solução |
|---|---|
| Bot não responde | Verificar se o processo está rodando: npx pm2 status |
| Erro 409 (Conflict) | Duas instâncias rodando. Matar todas e reiniciar: npx pm2 delete docuagro && npx pm2 start src/index.js --name docuagro |
| Token inválido (401) | Verificar TELEGRAM_BOT_TOKEN no arquivo .env |
| IA não responde | Verificar OPENAI_API_KEY e saldo da conta OpenAI |
| OCR com confiança baixa | Pedir ao produtor foto com melhor iluminação e enquadramento |
| Painel não carrega | Verificar se a porta 3100 está acessível: curl localhost:3100/api/health |
| Banco corrompido | Fazer backup e recriar: npm run setup |
🌱 DocuAgro
Compliance do produtor, na palma da mão.
AI Vertice • aivertice.com • 2026
Dúvidas? Suporte técnico disponível.