Fluxos ponta a ponta

Os diagramas mostram caminhos de sucesso simplificados. Erros, retries, locks e estados intermediários dependem da operação. Respostas de negócio não significam que o webhook original fica aberto esperando toda a conversa terminar.

Mensagem recebida e respondida

---
config:
  sequence:
    useMaxWidth: false
---
sequenceDiagram
    participant U as Pessoa no WhatsApp
    participant M as Meta
    participant G as Gateway / Ingress
    participant W as WhatsApp Entrypoint
    participant F as Plataforma
    participant A as Agente B2B ou B2C
    participant I as GenAI / WooCommerce
    U->>M: Envia mensagem ou interação
    M->>G: Webhook
    G->>W: Encaminha evento
    W->>F: Resolve loja e contexto
    W-->>M: Resposta HTTP via gateway
    Note over W,A: Processamento pode ocorrer em segundo plano
    W->>A: Encaminha interação autorizada
    A->>I: Consulta necessária à tarefa
    I-->>A: Resultado
    A->>W: Solicita envio da resposta
    W->>M: Envia mensagem
    M-->>U: Disponibiliza mensagem
    M->>G: Status de envio/entrega
    G->>W: Encaminha status

B2B trata a gestão do lojista; B2C trata a compra do consumidor. Aceitação de envio pela API não confirma entrega. O número central administrativo não é o número de atendimento da loja. O prazo de atendimento e os templates são explicados no healthcheck.

Busca de produto

---
config:
  sequence:
    useMaxWidth: false
---
sequenceDiagram
    participant B as B2C
    participant A as GenAI Wrapper
    participant E as Provedor de embeddings
    participant V as Weaviate
    participant L as Modelo de conversa
    B->>A: Consulta com contexto da loja
    A->>E: Gera vetor da consulta
    E-->>A: Embedding
    A->>V: Pesquisa no índice da loja
    V-->>A: Produtos candidatos
    A-->>B: Resultado da busca
    Note over B,L: Conforme a etapa, IA auxilia apresentação e recomendação
    B->>A: Solicita interpretação ou recomendação
    A->>L: Contexto e produtos encontrados
    L-->>A: Resposta
    A-->>B: Texto normalizado
    Note over B: Resposta enviada via WhatsApp Entrypoint

O desenho não impõe duas chamadas de IA a toda pesquisa; o caminho depende da etapa do agente. O índice precisa estar populado. Embeddings e conversação são capacidades separadas. Disponibilidade, variação, preço, frete e pedido também dependem da integração comercial. Veja IA e busca.

Atualização do catálogo

---
config:
  sequence:
    useMaxWidth: false
---
sequenceDiagram
    participant L as Loja WooCommerce
    participant G as Gateway
    participant W as WooCommerce Wrapper
    participant R as Cache e mídias
    participant A as GenAI Wrapper
    participant V as Weaviate
    L->>G: Webhook de produto
    G->>W: Reescreve rota e encaminha
    W->>W: Valida evento e contexto
    W->>L: Consulta dados quando necessário
    L-->>W: Produto
    W->>R: Atualiza ou remove cópias locais
    W->>A: Solicita indexação ou exclusão
    A->>V: Atualiza índice da loja
    Note over W,V: Evento recebido não garante indexação concluída

Criação/atualização pode consumir embeddings; exclusão remove o registro correspondente. Sincronização e reconciliação periódicas complementam os eventos. Veja sincronização.

Uso durante incidentes

Identifique a última etapa confirmada e procure o erro seguinte. Correlacione loja, horário e request_id; tarefas podem exigir também job ID ou identificador do recurso. Não presuma correlação automática entre eventos distintos. Consulte logs e runbooks.