Pular para o conteúdo principal

E01 - Plataforma de Inteligência Artificial

Casos de Uso e Fluxos Detalhados

Versão: 2.0 | Data: 05/01/2026 | API Base: ConectEnvios API V1


1. Diagrama Geral de Casos de Uso

┌─────────────────────────────────────────────────────────────────────────────────────┐
│ PLATAFORMA DE IA - WHATSAPP │
├─────────────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────┐ │
│ │ │ ┌────────────────────────────┐ │ │ │
│ │ │─────────│ UC-001: Consultar │ │ │ │
│ │ │ │ Rastreamento │ │ │ │
│ │ │ └────────────────────────────┘ │ │ │
│ │ │ │ │ │
│ │ │ ┌────────────────────────────┐ │ │ │
│ │ │─────────│ UC-002: Solicitar │ │ │ │
│ │ CLIENTE │ │ Cotação │──────────────│ BOT │ │
│ │ │ └────────────────────────────┘ │ IA │ │
│ │ │ │ │ │
│ │ │ ┌────────────────────────────┐ │ │ │
│ │ │─────────│ UC-003: Gerar Etiqueta │ │ │ │
│ │ │ │ de Envio │ │ │ │
│ │ │ └────────────────────────────┘ │ │ │
│ └─────────┘ └─────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────────────────┘

2. UC-001: Consultar Rastreamento

2.1 Informações Gerais

CampoValor
IDUC-001
NomeConsultar Rastreamento
Ator PrincipalCliente
Atores SecundáriosBot IA, ConectEnvios API V1
Endpoint APIGET /package/track/:id
PrioridadeAlta (P0)

2.2 Fluxo Principal

PassoAtorAção
1ClienteEnvia mensagem: "Quero rastrear meu envio 12345"
2SistemaRecebe via webhook WhatsApp
3Bot IAProcessa com GPT-4, extrai package_id
4Bot IAExecuta function track_package
5SistemaVerifica cache Redis
6Sistema[Cache miss] Chama GET /package/track/12345
7SistemaRecebe array de TrackingEvent
8Bot IAFormata resposta com status e eventos
9SistemaEnvia via WhatsApp API

2.3 Exemplo de Interação

┌──────────────────────────────────────┐
│ CONECTENVIOS ··· │
├──────────────────────────────────────┤
│ │
│ ┌────────────────────────────────┐ │
│ │ Quero rastrear meu envio 12345│ │
│ └────────────────────────────────┘ │
│ 14:30 ✓✓│
│ │
│ ┌────────────────────────────────┐ │
│ │ 📦 *Rastreamento: 12345* │ │
│ │ │ │
│ │ ✅ Status: *Em trânsito* │ │
│ │ 📍 Local: São Paulo/SP │ │
│ │ 🕐 Atualizado: 05/01 às 14:30 │ │
│ │ │ │
│ │ 📋 *Últimos eventos:* │ │
│ │ │ │
│ │ • 05/01 14:30 │ │
│ │ Em trânsito para o destino │ │
│ │ São Paulo/SP │ │
│ │ │ │
│ │ • 05/01 08:00 │ │
│ │ Objeto saiu para distribuição│ │
│ │ Centro de Distribuição SP │ │
│ └────────────────────────────────┘ │
│ 14:30 ✓✓ │
│ │
└──────────────────────────────────────┘

3. UC-002: Solicitar Cotação de Frete

3.1 Informações Gerais

CampoValor
IDUC-002
NomeSolicitar Cotação de Frete
Ator PrincipalCliente/Lojista
Atores SecundáriosBot IA, ConectEnvios API V1
Endpoints APIGET /cep/address + POST /package/shipping
PrioridadeAlta (P0)

3.2 Fluxo Principal

PassoAtorAção
1Cliente"Quero uma cotação de frete"
2Bot IAInicia slot filling, pede CEP origem
3Cliente"70000-000"
4SistemaValida via GET /cep/address/?cep=70000000
5Bot IAConfirma "Brasília/DF", pede CEP destino
6Cliente"01310-100"
7SistemaValida CEP destino
8Bot IAPede peso e dimensões
9Cliente"2kg, 20x10x30cm"
10SistemaChama POST /package/shipping
11SistemaRecebe opções de todas transportadoras
12Bot IAFormata e apresenta cotação

3.3 Exemplo de Interação

┌──────────────────────────────────────┐
│ CONECTENVIOS ··· │
├──────────────────────────────────────┤
│ │
│ ┌────────────────────────────────┐ │
│ │ Quanto custa enviar de │ │
│ │ 70000-000 para 01310-100, 2kg? │ │
│ └────────────────────────────────┘ │
│ 14:35 ✓✓│
│ │
│ ┌────────────────────────────────┐ │
│ │ 📋 *Cotação de Frete* │ │
│ │ Brasília/DF → São Paulo/SP │ │
│ │ Peso: 2kg │ │
│ │ │ │
│ │ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ │
│ │ │ │
│ │ 📦 *Jadlog PICKUP* │ │
│ │ 💰 R$ 13,26 │ │
│ │ ⏱️ 5 dias úteis │ │
│ │ │ │
│ │ 📄 *Correios PAC* │ │
│ │ 💰 R$ 31,79 │ │
│ │ ⏱️ 5 dias úteis │ │
│ │ │ │
│ │ 🚀 *Correios SEDEX* │ │
│ │ 💰 R$ 70,04 │ │
│ │ ⏱️ 1 dia útil │ │
│ │ │ │
│ │ ⏱️ Cotação válida por 24h │ │
│ └────────────────────────────────┘ │
│ 14:36 ✓✓ │
│ │
│ ┌──────────────┐ ┌───────────────┐ │
│ │🏷️ Gerar │ │🔄 Nova │ │
│ │ etiqueta │ │ cotação │ │
│ └──────────────┘ └───────────────┘ │
│ │
└──────────────────────────────────────┘

4. UC-003: Gerar Etiqueta de Envio

4.1 Informações Gerais

CampoValor
IDUC-003
NomeGerar Etiqueta de Envio
Ator PrincipalCliente/Lojista
Pré-requisitoUC-002 (cotação)
PrioridadeAlta (P0)

4.2 Fluxo Principal

  1. Cliente seleciona opção da cotação
  2. Bot IA confirma seleção
  3. Sistema coleta dados do remetente (ou usa salvos)
  4. Sistema coleta dados do destinatário
  5. Sistema processa pagamento
  6. Sistema gera etiqueta na transportadora
  7. Bot IA envia PDF via WhatsApp

5. Matriz de Rastreabilidade

Caso de UsoRequisitosEndpoint API
UC-001RF-E01-003GET /package/track/:id
UC-002RF-E01-004POST /package/shipping
UC-003RF-E01-005Múltiplos

6. Histórico de Revisões

VersãoDataDescrição
1.005/01/2026Versão inicial
2.005/01/2026Endpoints ConectEnvios API V1

Especificação de Requisitos | Contratos de API →