Amazon API Gateway
Endpoint dos webhooks do canal.

Visão técnica · POC 03
Arquitetura proposta
Webhooks recebem as mensagens, uma fila desacopla o processamento e uma máquina de estados coordena elegibilidade, pagamento, documentos e confirmação entre o canal e os sistemas envolvidos.
Fluxo da solução
Mapa interativo
Fluxograma completo
Em telas menores, arraste o diagrama para acompanhar todo o fluxo.
flowchart TD
START([Aluno solicita rematrícula]) --> AUTH{Aluno identificado?}
AUTH -->|Não| ASK_RA[Solicita identificador]
ASK_RA --> VERIFY[Valida no sistema acadêmico]
VERIFY --> VERIFIED{Válido?}
VERIFIED -->|Não| ERROR1[Dados não encontrados]
VERIFIED -->|Sim| SAVE_SESSION
AUTH -->|Sim| SAVE_SESSION[Salva estado no DynamoDB]
SAVE_SESSION --> CHECK_ELIGIBLE[Consulta elegibilidade]
CHECK_ELIGIBLE --> ELIGIBLE{Elegível?}
ELIGIBLE -->|Não| ERROR2[Pendência acadêmica]
ELIGIBLE -->|Sim| CHECK_DEBT[Verifica débitos]
CHECK_DEBT --> HAS_DEBT{Tem débitos?}
HAS_DEBT -->|Sim| SEND_BOLETO[Envia cobrança]
SEND_BOLETO --> WAIT_PAYMENT[Aguarda pagamento]
WAIT_PAYMENT --> CHECK_DEBT
HAS_DEBT -->|Não| GEN_CONTRACT[Gera contrato]
GEN_CONTRACT --> SEND_SIGN[Cria envelope de assinatura]
SEND_SIGN --> SEND_LINK[Envia link no WhatsApp]
SEND_LINK --> WAIT_SIGN[Aguarda webhook]
WAIT_SIGN --> SIGNED{Assinado?}
SIGNED -->|Não| REMIND[Envia lembrete]
REMIND --> WAIT_SIGN
SIGNED -->|Sim| STORE[Guarda documento no S3]
STORE --> UPDATE[Atualiza sistema acadêmico]
UPDATE --> CONFIRM[Confirma no WhatsApp]
CONFIRM --> END([Processo concluído])
ERROR1 --> END_ERROR([Processo interrompido])
ERROR2 --> END_ERROR
O diagrama não pôde ser carregado. O fluxo técnico detalhado abaixo preserva as etapas essenciais.
Tecnologias e papéis
Endpoint dos webhooks do canal.
Roteamento e adaptadores de integração.
Workflow completo da rematrícula.
Fila assíncrona e tratamento de falhas.
Contexto e estado da conversa.
Histórico e relatórios da jornada.
Documentos assinados.
Logs, métricas e alertas.
Credenciais das integrações.
Arquitetura em camadas
A API oficial do WhatsApp envia mensagens, botões e webhooks aprovados.
API Gateway recebe eventos; Lambda classifica intenção e DynamoDB mantém o Estado da conversa.
SQS absorve picos e Step Functions coordena elegibilidade, pagamento e assinatura.
Banco relacional guarda histórico, S3 preserva documentos e adaptadores isolam sistemas externos.
Fluxo técnico detalhado
Controles técnicos
AWS Secrets Manager protege credenciais; webhooks exigem assinatura, idempotência e minimização de dados.
Retry limitado, Dead-letter queue, correlação por jornada e tratamento manual evitam perda silenciosa.
DynamoDB retém estado efêmero; histórico e documentos possuem políticas de acesso separadas.
Requer canal aprovado e contratos estáveis com sistemas acadêmico, financeiro e de assinatura.
Premissas da estimativa
Indicadores propostos
Faixa de planejamento atualizada em 2026 a partir das premissas da fonte. Recalcular no AWS Pricing Calculator e validar também o preço do provedor do WhatsApp; não representa cotação, SLA ou compromisso comercial.