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
| Campo | Valor |
|---|---|
| ID | UC-001 |
| Nome | Consultar Rastreamento |
| Ator Principal | Cliente |
| Atores Secundários | Bot IA, ConectEnvios API V1 |
| Endpoint API | GET /package/track/:id |
| Prioridade | Alta (P0) |
2.2 Fluxo Principal
| Passo | Ator | Ação |
|---|---|---|
| 1 | Cliente | Envia mensagem: "Quero rastrear meu envio 12345" |
| 2 | Sistema | Recebe via webhook WhatsApp |
| 3 | Bot IA | Processa com GPT-4, extrai package_id |
| 4 | Bot IA | Executa function track_package |
| 5 | Sistema | Verifica cache Redis |
| 6 | Sistema | [Cache miss] Chama GET /package/track/12345 |
| 7 | Sistema | Recebe array de TrackingEvent |
| 8 | Bot IA | Formata resposta com status e eventos |
| 9 | Sistema | Envia 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
| Campo | Valor |
|---|---|
| ID | UC-002 |
| Nome | Solicitar Cotação de Frete |
| Ator Principal | Cliente/Lojista |
| Atores Secundários | Bot IA, ConectEnvios API V1 |
| Endpoints API | GET /cep/address + POST /package/shipping |
| Prioridade | Alta (P0) |
3.2 Fluxo Principal
| Passo | Ator | Ação |
|---|---|---|
| 1 | Cliente | "Quero uma cotação de frete" |
| 2 | Bot IA | Inicia slot filling, pede CEP origem |
| 3 | Cliente | "70000-000" |
| 4 | Sistema | Valida via GET /cep/address/?cep=70000000 |
| 5 | Bot IA | Confirma "Brasília/DF", pede CEP destino |
| 6 | Cliente | "01310-100" |
| 7 | Sistema | Valida CEP destino |
| 8 | Bot IA | Pede peso e dimensões |
| 9 | Cliente | "2kg, 20x10x30cm" |
| 10 | Sistema | Chama POST /package/shipping |
| 11 | Sistema | Recebe opções de todas transportadoras |
| 12 | Bot IA | Formata 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
| Campo | Valor |
|---|---|
| ID | UC-003 |
| Nome | Gerar Etiqueta de Envio |
| Ator Principal | Cliente/Lojista |
| Pré-requisito | UC-002 (cotação) |
| Prioridade | Alta (P0) |
4.2 Fluxo Principal
- Cliente seleciona opção da cotação
- Bot IA confirma seleção
- Sistema coleta dados do remetente (ou usa salvos)
- Sistema coleta dados do destinatário
- Sistema processa pagamento
- Sistema gera etiqueta na transportadora
- Bot IA envia PDF via WhatsApp
5. Matriz de Rastreabilidade
| Caso de Uso | Requisitos | Endpoint API |
|---|---|---|
| UC-001 | RF-E01-003 | GET /package/track/:id |
| UC-002 | RF-E01-004 | POST /package/shipping |
| UC-003 | RF-E01-005 | Múltiplos |
6. Histórico de Revisões
| Versão | Data | Descrição |
|---|---|---|
| 1.0 | 05/01/2026 | Versão inicial |
| 2.0 | 05/01/2026 | Endpoints ConectEnvios API V1 |