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 (JSON Payload):
{
  "message": "Como combater nematoides no cafezal?"
}
Resposta do Servidor (JSON):
{
  "status": "success",
  "reply": "Olá! A prevenção e o manejo integrado são as melhores formas de combater os nematoides no cafezal:\n\n- *Uso de mudas sadias*: Adquira mudas livres de nematoides (*Fonte: BT-111, p. 35*).\n- *Manejo de enxurradas*: Faça curvas de nível (*Fonte: BT-111, p. 35*).",
  "sources": [
    { "source": "BT-111-Nematoides.pdf", "page": 35, "similarity": 0.71 }
  ]
}

🔗 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"])