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
/api/chatbot/resumoResumo 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/api/chatbot/buscarBusca 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/api/veiculosListagem 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/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/api/lojasDados 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/api/syncAtualizar / 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!