API do Chatbot — Feirão 4 Lojas

Endpoints REST JSON prontos para WhatsApp (n8n, Typebot, IA, Manychat, Evolution API)

Voltar ao Feirão

Testar API ao Vivo

Experimente consultar o estoque real das 4 lojas exatamente como o seu chatbot do WhatsApp vai fazer.

Referência dos Endpoints

GET/api/chatbot/resumo

Resumo Geral + Catálogo Compacto (Todos os Carros)

Retorna o total de carros, contagem por loja, marcas, categorias, faixa de preços, resumo em texto natural e a lista enxuta de TODOS os veículos das 4 lojas. Perfeito para o chatbot saber tudo o que existe no feirão.

/api/chatbot/resumo
GET/api/chatbot/buscar

Busca Inteligente para Chatbot de WhatsApp

Busca por palavra-chave (q), código (codigo), orçamento máximo (orcamento), marca, categoria, câmbio, combustível ou loja. Já devolve os veículos com fotos + uma mensagem pronta formatada para WhatsApp (mensagemProntaWhatsapp).

/api/chatbot/buscar?categoria=suv&orcamento=150000&limit=5
GET/api/veiculos

Listagem Completa com Filtros e Paginação

Lista todos os veículos com filtros combinados (q, loja, marca, modelo, categoria, cambio, combustivel, precoMin, precoMax, anoMin, anoMax, kmMax, ordenar, page, limit). Use ?formato=compacto para payloads menores.

/api/veiculos?formato=compacto&limit=10
GET/api/veiculos/[codigo-ou-id]

Ficha 100% Completa de um Carro Específico

Aceita o código curto que vai na mensagem do WhatsApp (ex: NA-001, V3-001, MV-001, RA-001) ou o ID completo. Retorna todas as fotos, todos os opcionais, descrição, dados da loja e texto formatado para WhatsApp.

/api/veiculos/NA-001
GET/api/lojas

Dados das 4 Lojas Participantes

Retorna nome, endereço, cidade, logo e quantidade atual de veículos de cada uma das 4 lojas do feirão.

/api/lojas
POST/api/sync

Atualizar / Re-extrair Estoque das 4 Lojas

Dispara o extrator em tempo real nos 4 sites e atualiza a base do feirão. Pode ser agendado via cron (ex: a cada 1 hora) enviando Authorization: Bearer <SYNC_SECRET>.

Como o Chatbot identifica o carro automaticamente

Cada botão de WhatsApp da página do Feirão envia automaticamente o código único do veículo na mensagem inicial do cliente, por exemplo: [Cód: V3-001]. No seu fluxo do chatbot (n8n, Typebot ou Agente de IA), basta extrair esse código (regex /[A-Z0-9]{2}-\d{3}/) e fazer um GET /api/veiculos/V3-001 para obter na hora todas as fotos, opcionais, preço, loja e resposta pronta para enviar ao cliente!