Contato
ESTUDO DE CASO · ARQUITETURA & IAviaFCamara

Synforce

Synthetic Workers de RH em Produção na AWS com OpenClaw

Plataforma de agentes inteligentes de People/RH da FCamara: arquitetura em nuvem, integração com Microsoft Teams e WhatsApp Cloud API, governança anti-alucinação ancorada no SharePoint e zero portas de administração expostas.

Meu PapelTech lead · Arquitetura, Infraestrutura & IA
Stack Principal
  • AWS
  • Terraform
  • Docker
  • TypeScript
01

O Desafio: Atendimento de RH sem Alucinações nem Vazamento de Dados

Com centenas de colaboradores e políticas internas dinâmicas (férias, benefícios, atestados, reembolsos), a equipe de People da FCamara sofria com sobrecarga de dúvidas repetitivas em múltiplos canais.

Bots convencionais de atendimento falham com frequência nesse cenário: ou utilizam RAG vetorial ingênuo que fragmenta tabelas e alucina regras de benefícios, ou não oferecem segregação de privilégios para dados sensíveis de folha e colaboradores. O objetivo foi criar uma força de trabalho sintética em produção que combinasse segurança estrita, resposta agêntica e disponibilidade nos canais que os colaboradores já usavam no dia a dia.

Segregação de Agentes

Synthia & BP: Duas Personas Especializadas

Synthia atende dúvidas gerais de People para toda a empresa no Teams e no WhatsApp. O agente BP (Business Partner) gerencia dados sensíveis de colaboradores via integração com Orange, sendo estruturalmente restrito ao Microsoft Teams com autenticação Entra ID.

Governança e Precisão

Zero Alucinação com Fonte Única Corporativa

Nenhuma política é inferida ou memorizada sem ancoragem: o SharePoint é a fonte única da verdade da base de conhecimento, sincronizada em tempo real.

Omnichannel Real

Microsoft Teams & WhatsApp Cloud API

Atendimento no desktop corporativo (Teams) e no bolso do colaborador (WhatsApp oficial da Meta com áudio e documentos).

02

Desenho de Arquitetura: Da Borda aos Agentes

Uma visão de engenharia ponta a ponta: do tráfego nos canais e terminação TLS ao runtime conteinerizado na AWS e integração com LLM e síntese de voz.

A infraestrutura foi desenhada para operar de forma econômica, robusta e modular em uma única instância EC2 Graviton t4g.small com Docker Compose. O Caddy atua como borda segura terminando TLS :443 e roteando apenas os endpoints estritamente autorizados, isolando o gateway OpenClaw e os microserviços auxiliares.

Inspecione os nós do diagrama e alterne os fluxos para ver a trajetória de cada requisição:

Fluxo:
Full Architecture
synforce-architecture-v2.dia
ONLINE · AWS SA-EAST-1
FCamara · SynWorkers POC Architecture
01 · Canais de EntradaIngress

Microsoft Teams

Colaboradores FCamara

JWT
/api/messagesBot Framework

WhatsApp Cloud API

Meta Webhook Oficial

HMAC
/whatsapp ➔ :18789Áudio Opus PTT

SharePoint M365

Fonte Única da KB

Token
Power Automate ➔ /kbx-kb-token
02 · Borda & TLSEdge
TLS :443

Caddy Reverse Proxy

56.126.101.37.sslip.io

  • /api/messages➔ :3978
  • /whatsapp➔ :18789
  • /kb➔ :4100
  • /healthz➔ 200 OK
🛡️ Resto: 404 estrito
03 · Host & ContainersEC2 ARM64
Docker Composet4g.small
OpenClaw Gateway:3978
Synthia (People)
BP Agent (Teams)

Plugins: whatsapp-cloud + ler_documento

KB-Receiver:4100

MarkItDown ➔ INDEX.md + .kb-map.json

Symphony-Shim:8899

SSE stream:true ⇄ JSON batch

EBS /srv/openclawDLM 7d
sqlite, sessões, /knowledge (:ro)
04 · IA & ProvidersBackbone

Symphony LLM

Cérebro & Visão

LLM
Symphony /openaiÚnico provider

ElevenLabs TTS

Voz de Marca

Voice
Opus 48kHz nativoWhatsApp PTT

AWS Cloud Ops

Terraform + SSM

Sec
Sem SSH ➔ SSM SessionSegredos SSM
Passo a Passo:Visão Geral Completa

Arquitetura ponta a ponta: 3 canais de entrada, terminação TLS na borda com Caddy, 4 microserviços Docker em EC2 ARM64 e integração com Symphony LLM e ElevenLabs.

  1. 1Entrada por Teams (JWT), WhatsApp (HMAC) e SharePoint (x-kb-token)
  2. 2Caddy expõe apenas portas necessárias e bloqueia o resto com 404
  3. 3Gateway OpenClaw orquestra Synthia (People) e BP (Business Partner)
  4. 4KB-Receiver ingere documentos do SharePoint com MarkItDown
  5. 5Symphony-Shim converte streaming para a API corporativa de LLM
03

Deep Dive Técnico: Decisões Críticas de Implementação

Soluções práticas desenhadas para superar limitações de protocolos corporativos, streaming e ingestão de documentos.

01.Sem RAG Tradicional

Navegação Agêntica de Documentos com MarkItDown

Em vez de recortar arquivos em chunks vetoriais opacos que descontextualizam tabelas de benefícios, a pipeline converte os documentos do SharePoint (PDF, Word, PowerPoint) para Markdown limpo e gera um INDEX.md semântico. A Synthia lê o índice e realiza buscas ativas sob demanda através da tool dedicada ler_documento, garantindo contexto integral e citações precisas.

02.Compatibilidade de Streaming

Microserviço Symphony-Shim

O gateway OpenClaw foi concebido para exigir comunicação com stream: true em Server-Sent Events (SSE). No entanto, a API corporativa do Symphony LLM opera em batch JSON (stream: false). Desenvolvemos um microserviço intermediário em Python que converte o JSON em chunks SSE com finish_reason sanitizado e sem dependência de fallback externo.

03.Meta Cloud API

Plugin Nativo de WhatsApp com Áudio Opus

Eliminamos bridges HTTP externas para rodar um plugin proprietário no runtime. Para mensagens de voz, o canal instrui o ElevenLabs a sintetizar diretamente no formato opus_48000_64 (Ogg/Opus), viabilizando notas de voz nativas no WhatsApp sem precisar empacotar FFmpeg no container.

04

Infraestrutura como Código e Postura de Segurança

Deploy 100% automatizado via Terraform na região sa-east-1 (São Paulo), mantendo dados de colaboradores e base de conhecimento em território brasileiro.

Zero Porta 22 (Sem SSH)

Nenhuma porta de gerenciamento aberta para a internet. Acesso administrativo, deploys e monitoramento ocorrem via AWS Systems Manager (SSM Session Manager e SSM Run Command).

Segredos sem .env em disco

Segredos e tokens residem no AWS SSM Parameter Store (SecureString) e são provisionados dinamicamente em memória durante o deploy, sem jamais serem versionados no git.

EBS Dedicado com DLM

O estado persistente (~/.openclaw contendo SQLite, sessões e workspaces) reside em um volume EBS dedicado independente da raiz, protegido por prevent_destroy e snapshots diários automáticos via Data Lifecycle Manager.

Borda Segura com Caddy

Emissão e renovação automática de TLS, expondo exclusivamente os endpoints autorizados (/api/messages, /whatsapp e /kb com token x-kb-token) e retornando 404 estrito para qualquer rota não mapeada.

05

Impacto em Produção e Demonstração em Vídeo

Eficiência operacional comprovada com resposta instantânea e satisfação dos colaboradores.

2Canais AtivosTeams e WhatsApp simultâneos
100%Sincronização KBDelta SharePoint automatizado
0Vazamento de PIIAgente BP isolado no Teams
t4g.smallCusto Otimizado4 microserviços em 1 instância ARM

Demonstração em Vídeo

Veja o atendimento do Synforce em ação, respondendo dúvidas com linguagem natural e contexto da empresa:

pt-br · desktop