Pular para conteúdo

Visão da Plataforma

O EcomSmart Agents conecta a operação de uma loja ao WhatsApp. A plataforma atende dois públicos: o cliente final, que compra conversando, e o lojista, que administra o catálogo e acompanha a operação pelo painel ou pelo WhatsApp.

O objetivo não é substituir o e-commerce. O WooCommerce continua como sistema comercial da loja; o EcomSmart Agents torna seus dados e ações acessíveis pelos canais conversacionais.

flowchart TB
    client[Cliente final] --> b2c[Vendas B2C]
    merchant[Lojista] --> b2b[Gestão B2B]
    merchant --> panel[Painel]

    b2c --> wpp[Canal WhatsApp]
    b2b --> wpp
    wpp --> commerce[Operação comercial]
    panel --> commerce

    commerce --> wc[WooCommerce]
    commerce --> ai[Recursos de IA]
    commerce --> platform[Configuração e dados da plataforma]

O que cada pessoa consegue fazer

Pessoa Canal principal Resultado esperado
Cliente final WhatsApp Encontrar produtos, montar o carrinho, escolher entrega e concluir o pedido.
Lojista WhatsApp e painel Cadastrar e ajustar produtos, trabalhar imagens e descrições e configurar a loja.
Equipe de operação Painel e ferramentas internas Provisionar lojas, acompanhar integrações, publicar alterações e diagnosticar incidentes.

Os quatro blocos da plataforma

  • Experiência conversacional

    O whatsapp-entrypoint recebe eventos da Meta e envia respostas. Os agentes B2C e B2B decidem o próximo passo de cada conversa.

  • Operação comercial

    O woocommerce-wrapper concentra o acesso ao WooCommerce: catálogo, produtos, frete, pedido e pagamento. Cada loja mantém suas próprias credenciais e dados comerciais.

  • Inteligência e descoberta

    O genai-wrapper fornece classificações, textos, imagens e busca semântica. Ele também registra o uso de IA por loja.

  • Plataforma e administração

    O frontend-entrypoint, o painel e os serviços de suporte cuidam de usuários, lojas, configurações, onboarding e recursos administrativos.

Jornadas principais

Comprar pelo WhatsApp

flowchart LR
    A[Mensagem ou catálogo] --> B[Agente B2C]
    B --> C[Busca e regras da conversa]
    C --> D[Produtos e frete no WooCommerce]
    D --> E[Carrinho, pedido e pagamento]
    E --> F[Resposta ao cliente]

O B2C usa uma máquina de estados para não perder o contexto entre busca, carrinho, endereço, frete e pagamento. A jornada B2C detalhará esses estados.

Administrar a loja pelo WhatsApp

flowchart LR
    A[Mensagem ou Flow] --> B[Agente B2B]
    C[Dados do produto] --> D[IA opcional para imagem ou descrição]
    D --> E[Validação e gravação no WooCommerce]
    E --> F[Confirmação ao lojista]
    B --> C

O B2B combina mensagens e WhatsApp Flows. Os Flows apresentam formulários e telas; a conversa trata confirmações, decisões e exceções. Veja a jornada de catálogo.

Princípios que orientam o desenho

  • Cada serviço tem uma responsabilidade clara. Um agente orquestra a conversa; integrações externas ficam nos serviços especializados.
  • A loja é o limite de dados. O identificador da loja acompanha operações, configurações e índices de busca para evitar mistura de contextos.
  • O canal não define a regra de negócio. WhatsApp e painel disparam ações; as regras permanecem nos serviços da plataforma e no WooCommerce.
  • A infraestrutura é compartilhada, os dados não. Os serviços usam a mesma rede e componentes de suporte, mas mantêm separação lógica por loja quando aplicável.

Próximas leituras