Documentação · RAImundo (IA/WhatsApp)

O RAImundo

O RAImundo é o assistente de IA que leva o marketplace para onde o produtor já está: o WhatsApp. O site é o sistema de registro; o RAImundo é a interface humana, que orienta a variedade certa, avisa quem tem anúncio compatível e conduz a negociação.

Tecnologia cocriada em parceria com a Embrapa Arroz e Feijão

Como o agente se conecta

Produtor no WhatsApp

Texto, áudio ou foto

RAImundo (IA)

Entende e orienta

Ferramentas do Marketplace

Busca, rascunho de anúncio, meus anúncios e pedidos, negociação

Marketplace

Ofertas, demandas, negociações, pedidos

Para desenvolvedores

O agente conversa com o site por ferramentas de servidor, autenticadas por chave interna. Em linhas gerais:

GET /api/agente/ferramentas devolve o catálogo de ferramentas (nome, descrição e parâmetros), no formato que o modelo entende.
POST /api/agente/ferramentas/<nome> executa uma ferramenta; a chave vai no cabeçalho x-azap-key. A identidade de quem fala (o número do WhatsApp) vem do gateway, não do corpo da chamada: ninguém age em nome de outro produtor.
As ferramentas de escrita só criam rascunhos e registros do próprio produtor — rascunho de anúncio, proposta, resposta a uma negociação. O anúncio só vai ao ar quando ele revisa e publica no site.
Limite de 60 chamadas por hora por conversa.
A API antiga /api/agent/listings continua só para leitura; o POST foi desligado (responde 410).

As chaves não aparecem nesta página nem no código do site: ficam na configuração do servidor.

Transparência

O RAImundo é um assistente de IA cocriado com a Embrapa Arroz e Feijão. As informações têm caráter de apoio e não substituem a orientação de um especialista.