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 | 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-entrypointrecebe eventos da Meta e envia respostas. Os agentes B2C e B2B decidem o próximo passo de cada conversa. -
Operação comercial
O
woocommerce-wrapperconcentra 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-wrapperfornece 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
- Arquitetura e Comunicação: como os serviços se conectam.
- Dados, Segurança e Configuração: onde cada tipo de dado vive e como configurar o ambiente.
- Referência de Serviços: escopo técnico de cada serviço de aplicação.