Pular para conteúdo

Bem-vindo ao EcomSmart Hub

O EcomSmart Hub é um ecossistema unificado para automação, vendas conversacionais e gestão de e-commerce. Integrando inteligência artificial generativa, conectores oficiais da Meta (WhatsApp Business Cloud API) e sincronização bidirecional com o WooCommerce, a plataforma transforma conversas em vendas sem sair do WhatsApp.

graph LR
    subgraph Cliente["Cliente Final"]
        WPP["WhatsApp"]
    end

    subgraph Hub["EcomSmart Hub Core"]
        GW["Gateway Nginx"]
        WE["WhatsApp Entrypoint"]
        B2C["Agente B2C (Vendas)"]
        GENAI["GenAI Wrapper (LLM)"]
        WCW["WooCommerce Wrapper"]
    end

    subgraph Loja["Infraestrutura da Loja"]
        WC["WooCommerce / WordPress"]
        WV["Weaviate (Busca Vetorial)"]
    end

    WPP <-->|Cloud API| GW
    GW <--> WE
    WE <--> B2C
    B2C <--> GENAI
    GENAI <--> WV
    B2C <--> WCW
    WCW <--> WC

Módulos da Plataforma

  • :material-robot: Agente B2C (b2c_handler)

    Agente de vendas conversacional no WhatsApp. Opera sob uma Máquina de Estados Finitos (FSM) rigorosa para catálogo, carrosséis interativos, carrinho dinâmico, cálculo de frete e checkout.

  • :material-store: Agente B2B (b2b_handler)

    Assistente voltado aos administradores e lojistas. Permite consultas de faturamento, pedidos recentes, métricas de vendas e alertas operacionais via WhatsApp.

  • :material-view-dashboard: Painel Administrativo (panel)

    Single Page Application construída com React, TypeScript e Vite. Centraliza a parametrização dos agentes, personalização de tom de voz, FAQs, catálogo e métricas financeiras.

  • :material-api: Frontend Entrypoint (frontend_entrypoint)

    Serviço central de autenticação, provisionamento de WhatsApp Flows e Templates na Meta, gestão de planos e métricas analíticas.

  • :material-brain: GenAI Wrapper (genai_wrapper)

    Camada de inteligência artificial unificada. Conecta modelos de linguagem (LLMs) e orquestra a busca semântica vetorial através do Weaviate.

  • :material-cart: WooCommerce Wrapper (woocommerce_wrapper)

    Conector de alta performance com a Store API do WooCommerce. Responsável pela indexação de produtos, variações e simulação de frete em tempo real.

  • :material-whatsapp: WhatsApp Entrypoint (whatsapp_entrypoint)

    Receptor de webhooks da Meta, proxy criptográfico para WhatsApp Flows e despachante de mensagens com controle de concorrência e sessão.

  • :material-bullhorn: Marketing Campaigns (marketing_campaigns)

    Motor de disparos em lote, disparo de templates de reengajamento, campanhas promocionais e tracking de conversão por mensagem.

Stack Tecnológica

Componente Tecnologia Principal Finalidade
Backend Python 3.12+ / FastAPI / Pydantic v2 Microsserviços assíncronos de alta performance
Frontend React 19 / TypeScript / Vite Painel de controle responsivo para lojistas e staff
Bancos de Dados PostgreSQL 16 (Relacional) / Weaviate (Vetorial) Persistência transacional e busca semântica
Mensageria & Cache Redis 7 Alpine Gerenciamento de sessões, semáforos distribuídos e cache
Armazenamento MinIO (S3 Compatible) Mídia de catálogos, carrosséis e comprovantes
Gateway & Proxy Nginx + Cloudflare Tunnel Roteamento HTTPS seguro sem portas expostas

Primeiros Passos