Jornada de vendas B2C

O agente B2C coordena o atendimento ao consumidor pelo WhatsApp. O código do domínio fica em modules/b2c_handler; os estados e transições de conversa devem ser consultados na implementação da FSM dessa versão.

flowchart LR
    M[Mensagem ou interação] --> C[Identificar loja e contexto]
    C --> B[Buscar e apresentar produtos]
    B --> I[Selecionar item e variações]
    I --> K[Montar carrinho]
    K --> A[Coletar endereço]
    A --> F[Consultar frete]
    F --> P[Criar pedido e encaminhar pagamento]

Esse é o caminho principal; cancelamentos, retorno ao menu, erros e interações intermediárias dependem do estado da conversa.

Dependências

• whatsapp-entrypoint: recebe eventos, transmite mensagens e processa interações de Flows.
• woocommerce-wrapper: consulta produtos e executa operações comerciais na loja.
• genai-wrapper: interpreta solicitações, busca produtos e gera recomendações.
• Redis: guarda contexto temporário e coordena bloqueios.
• PostgreSQL: mantém registros persistentes e configurações.

Validação de uma alteração

Teste entrada pelo menu, busca com e sem resultado, produto com variação, carrinho, endereço, frete e pedido. Confira também repetição de mensagens, retorno a etapas anteriores e falhas da integração afetada.

Para testar pagamentos e mensagens sem efeitos reais, utilize HML isolada. O sucesso do login no painel não comprova funcionamento da jornada B2C.

Como investigar

Comece pelo recebimento do evento em whatsapp-entrypoint, encontre o request_id e acompanhe B2C, WooCommerce e IA. Uma busca vazia pode vir de catálogo não sincronizado, loja/contexto incorreto ou falha de embeddings; consulte IA e busca.