Assistente do Produtor

Tire suas dúvidas sobre pragas, doenças, cultivares e manejo com base nos manuais técnicos.

Bem-vindo ao AgroAssist!

Olá! Sou o seu assistente inteligente baseado em inteligência artificial e treinado com os manuais de cafeicultura da EPAMIG e outras instituições de pesquisa. Estou pronto para ajudar você a cuidar da sua lavoura de café.

Como combater nematoides no cafezal?
Quais cultivares a EPAMIG recomenda?
Como identificar e controlar ácaros do café?
Quais são as principais doenças do cafeeiro?

Documentação de Integração da API

Conecte o AgroAssist com WhatsApp, Make.com, n8n, Typebot, Z-API ou seu sistema próprio

🚀 Endpoint Universal do Webhook

Utilize esta rota para integrar com qualquer plataforma de WhatsApp ou bot conversacional. O AgroAssist responde com o texto formatado para o WhatsApp e citações dos manuais.

POST / GET /api/webhook/whatsapp
Exemplo de Requisição com Foto (JSON Payload):
{
  "message": "O que é essa mancha na folha do cafeeiro?",
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}
Resposta do Servidor (JSON):
{
  "status": "success",
  "reply": "Olá! Analisando a foto enviada, os sintomas visuais (manchas circulares alaranjadas na face inferior) indicam a presença de *Ferrugem-do-cafeeiro* (*Hemileia vastatrix*):\n\n- *Manejo Recomendado*: Aplicação de fungicidas sistêmicos nos meses de maior umidade e uso de cultivares resistentes (*Fonte: doencas.pdf, p. 12*).",
  "sources": [
    { "source": "doencas.pdf", "page": 12, "similarity": 0.88 }
  ]
}

🔗 Integração com Make.com e n8n

Siga os passos abaixo para conectar em menos de 2 minutos:

  1. Passo 1: No seu fluxo do Make ou n8n, adicione o módulo HTTP (Make Request).
  2. Passo 2: Configure o método para POST e a URL para a rota do AgroAssist: /api/webhook/whatsapp
  3. Passo 3: Defina o formato para JSON e envie o corpo: 
    { "message": "{{1.mensagem_whatsapp}}" }
  4. Passo 4: No módulo seguinte que envia a mensagem de volta no WhatsApp, use o campo retornado {{reply}}.

📱 Typebot, Evolution API e Z-API

Configuração rápida para plataformas de automação de WhatsApp:

Typebot:

Adicione um bloco Webhook HTTP no seu fluxo. Envie o JSON {"message": "{{user_input}}"} e atribua o retorno do campo reply a uma variável para exibir no balão de conversa.

Evolution API / Z-API / WhatsApp API:

Cadastre a URL do AgroAssist no campo de Webhook de Entrada de Mensagens da sua instância do WhatsApp. As respostas serão formatadas automaticamente com negritos *texto* do WhatsApp.

💻 Exemplos de Código

Exemplo cURL (Terminal / Bash):
curl -X POST /api/webhook/whatsapp \
  -H "Content-Type: application/json" \
  -d '{"message": "Quais cultivares a EPAMIG recomenda?"}'
Exemplo JavaScript (Node.js / Fetch):
const response = await fetch("/api/webhook/whatsapp", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ message: "Como combater nematoides?" })
});
const data = await response.json();
console.log("Resposta do Bot:", data.reply);
Exemplo Python (Requests):
import requests

url = "/api/webhook/whatsapp"
payload = {"message": "Como identificar ácaros no cafezal?"}
response = requests.post(url, json=payload)

print("Resposta:", response.json()["reply"])