Guia: Marketplace público

Como funciona

• Toda carga publicada com visibilidade público ganha um link curto /f/:slug e aparece na vitrine /fretes (sem login).
• Motoristas sem cadastro enviam interesse por um formulário curto (nome, WhatsApp, CPF/placa opcional).
• Cada interesse vira um lead em Marketplace → Leads recebidos.

1. 1

   Crie ou edite um frete

   Em Fretes → Novo, preencha origem, destino, carga, veículo, valor e janela de coleta. Em Visibilidade, escolha Público.
2. 2

   Publique o frete

   Mude o status para Publicado. O public_slug é gerado automaticamente.
3. 3

   Compartilhe o link

   No detalhe do frete aparece o bloco Compartilhar carga. Copie o link /f/:slug ou clique em WhatsApp — a mensagem já vem com rota, código e valor.
4. 4

   Receba leads

   Quando alguém preenche o formulário, o lead aparece em Marketplace → Leads recebidos com badge no menu.
5. 5

   Trate o lead

   Clique em WhatsApp para falar direto com o motorista. Atualize o status conforme avança: novo → contatado → convertido / descartado.

Boas práticas

• Mantenha preço e data de coleta sempre preenchidos — leads convertem muito mais quando há clareza.
• Despublique (volte para rascunho) cargas já fechadas — a página pública volta a 404 e o link some da vitrine.
• Use regras para notificar sua equipe quando chegar um lead novo.

Webhook

Cada lead dispara o evento marketplace.lead.created. Veja o payload completo em catálogo de eventos.

{
  "type": "marketplace.lead.created",
  "data": {
    "id": "lead_...",
    "freight_id": "frt_...",
    "driver_name": "Carlos Oliveira",
    "driver_phone": "(11) 99999-0000",
    "vehicle_plate": "ABC1D23",
    "source": "public_marketplace"
  }
}

Privacidade

A vitrine pública só expõe campos de carga (origem, destino, peso, veículo, preço sugerido, janelas e nome da empresa embarcadora). Nunca expomos endereço completo, contatos do embarcador ou IDs internos.