Engenharia & Arquitetura — Agentes de IA no ecossistema Meta

1. Globalização ATIVO

"O agente fala a língua do cliente, não o contrário."

pt-BR é língua primária, não tradução. Resolvemos o país pelo DDI do telefone (E.164 → ISO2) e roteamos idioma, moeda e gateway por país, com 14 vozes culturais do ProteOS. Matriz aprovada de 13 países em 4 ondas. Onda 1 (PT/EN/ES) cobre Brasil, EUA, Portugal, Nigéria, Peru e Venezuela; demais idiomas entram por onda.

2. Escalabilidade EM EVOLUÇÃO

"Crescer sem reescrever."

Backend FastAPI stateless + banco gerenciado (Supabase) — o webhook responde (ACK) em < 20s e processa em background, sem segurar a conexão. Hoje roda em VM dedicada 24×7 em São Paulo, dimensionada para o lançamento. Roadmap: failover horizontal (GCP Cloud Run) quando o volume exigir.

3. Inovação ATIVO

"O mais novo, mas só o que funciona."

Modelos de fronteira da Anthropic (Claude), com roteamento por complexidade (Haiku para simples, Sonnet/Opus para complexo) e cache semântico para reduzir custo e latência. Roadmap: multimodal (imagem/áudio) e fine-tuning de tom de voz.

4. LGPD forte ATIVO

"A lei é o mínimo; nós fazemos o máximo."

• Consentimento granular por finalidade (uso × marketing), revogável — com prova auditável (texto, versão, data/hora, IP).
• Direito ao esquecimento: endpoint /delete-data (callback Meta com assinatura HMAC) + canais app/e-mail, conclusão em até 30 dias.
• Zero compartilhamento de bem-estar com publicidade — nem com a Meta (ver Política de Privacidade §6).
• Criptografia AES-256-GCM em repouso para dados sensíveis + RLS por usuário.

Em evolução: mascaramento de PII antes do envio ao modelo (anonimização tokenizada).

5. Código Python, aberto e auditável ATIVO

"Seu time lê, entende e modifica."

Framework FastAPI; integração Meta via Graph API; banco PostgreSQL (Supabase); deploy por systemd na VM Oracle. Sem orquestradores opacos — o fluxo é legível linha a linha.

6. Privacidade por design ATIVO

• Dados first-party apenas;
• Criptografia em trânsito (TLS 1.2+) e em repouso (AES-256-GCM);
• Não treinamos modelos com seus dados;
• Isolamento por usuário (RLS deny-by-default) e auditoria de acesso.

7. Performance EM EVOLUÇÃO

Meta: resposta percebida rápida.

ACK do webhook em < 20s (garantido por processamento assíncrono), cache semântico para respostas recorrentes e chamadas assíncronas ao modelo. Metas de latência (p50/p95) serão medidas e publicadas após o go-live — não divulgamos números antes de medir em produção.

8. Experiência conversacional nativa EM EVOLUÇÃO

Tom de voz da marca (camada de vozes culturais do ProteOS), histórico de conversa por cliente e handoff humano sem perder contexto (aprovação via Slack/HumanLayer). Roadmap: memória de preferências de longo prazo e resolução de referências.

9. Integração ecossistema Meta ATIVO

Um código, múltiplos canais.

Detecção de canal e do remetente para WhatsApp, Instagram e Messenger com histórico unificado (CRM próprio). Webhook com verificação de assinatura, ACK < 20s e reenvio com retry. Roadmap: Threads.

10. Brand safety ATIVO

Guarda de conteúdo (brand_guardian) na saída: bloqueia alegações de saúde e linguagem de diagnóstico (coerente com "não é serviço médico"), respeita diversidade cultural/religiosa (camada EcumenicOS) e escala para humano quando a confiança cai.

11. Mensuração EM EVOLUÇÃO

Registro de interações do widget (origem, UTMs, cliques). Roadmap: Meta Pixel e Conversions API — transmitindo somente eventos lifestyle não sensíveis (nunca dados de bem-estar, ver Privacidade §6).

12. Segurança ATIVO

• Verificação de webhook por HMAC-SHA256 (X-Hub-Signature-256);
• Verificação do signed_request da Meta no fluxo de exclusão de dados;
• RLS deny-by-default; segredos fora do código (variáveis de ambiente).

Roadmap: rate limiting no nginx, hardening contra prompt injection e pentest externo.

13. Transparência ATIVO

Sempre identificamos a IA: "Você está conversando com o ProteOS, agente de IA do AquariOS." Registros auditáveis (audit_logs) e esta própria página — que declara honestamente o que é ativo e o que é roadmap.

14. Personalização EM EVOLUÇÃO

Integração com CRM próprio (cliente, histórico, país) para não repetir perguntas. Sempre opt-in e desativável. Roadmap: recomendações personalizadas.

15. Resiliência EM EVOLUÇÃO

Reenvio à Meta com retry e backoff; fila de processamento em background; registro de falhas para reprocessamento. Roadmap: modo degradado por regras se o modelo cair, circuit breaker e metas formais de uptime/MTTR.

WhatsApp / Instagram / Messenger
        ↓
nginx (HTTPS · api.podiumtec.com.br)
        ↓
FastAPI — verificação de assinatura (HMAC-SHA256) · ACK < 20s
        ↓
Gate de compliance — país ativo na onda? · bloqueio OFAC (Irã)
        ↓
Roteamento — DDI → país → idioma / voz cultural / gateway
        ↓
ProteOS (Claude / Anthropic)  ·  cache semântico
        ↓
brand_guardian — alegações de saúde / tom / cultura  →  handoff humano (Slack)
        ↓
Supabase (RLS deny-by-default · AES-256-GCM · audit_logs)
        ↓
Envio à Meta (retry 3×)  ·  eventos lifestyle não sensíveis