Contacto
CASO DE ESTUDIO · ARQUITECTURA E IAviaFCamara

Synforce

Synthetic Workers de RRHH en Producción en AWS con OpenClaw

Plataforma de agentes inteligentes de People/RRHH de FCamara: arquitectura en la nube, integración con Microsoft Teams y WhatsApp Cloud API, gobernanza anti-alucinaciones anclada en SharePoint y cero puertos de administración expuestos.

Meu PapelTech lead · Arquitectura, Infraestructura e IA
Stack Principal
  • AWS
  • Terraform
  • Docker
  • TypeScript
01

El Desafío: Soporte de RRHH sin Alucinaciones ni Filtraciones de Datos

Con cientos de colaboradores y políticas internas dinámicas (vacaciones, beneficios, licencias, reembolsos), el equipo de People de FCamara sufría sobrecarga de consultas repetitivas en múltiples canales.

Los bots convencionales de soporte suelen fallar en este entorno: o usan RAG vectorial ingenuo que fragmenta tablas y alucina reglas de beneficios, o carecen de segregación estricta de permisos para datos confidenciales de nómina y colaboradores. El objetivo fue crear una fuerza de trabajo sintética en producción que combinara seguridad rigurosa, búsqueda agéntica y disponibilidad en los canales que los colaboradores ya utilizaban.

Segregación de Agentes

Synthia y BP: Dos Personas Especializadas

Synthia atiende consultas generales de People para toda la empresa en Teams y WhatsApp. El agente BP (Business Partner) gestiona datos sensibles de colaboradores mediante integración con Orange, estando restringido estructuralmente a Microsoft Teams con autenticación Entra ID.

Gobernanza y Precisión

Cero Alucinaciones con Fuente Única Corporativa

Ninguna política se infiere sin anclaje: SharePoint funciona como la fuente única de verdad para el conocimiento, sincronizada en tiempo real.

Omnicanalidad Real

Microsoft Teams y WhatsApp Cloud API

Experiencia nativa tanto en el escritorio corporativo (Teams) como en el móvil del colaborador (WhatsApp oficial de Meta con notas de voz y documentos).

02

Diseño de Arquitectura: Del Borde a los Agentes

Una visión completa de ingeniería: desde el tráfico en canales y terminación TLS hasta el runtime en contenedores en AWS, integración con LLM y síntesis de voz.

La infraestructura fue diseñada para operar de forma económica, robusta y modular en una única instancia EC2 Graviton t4g.small con Docker Compose. Caddy actúa como borde seguro terminando TLS :443 y enrutando únicamente los endpoints autorizados, aislando el gateway OpenClaw y los microservicios auxiliares.

Inspecciona los nodos del diagrama y alterna los flujos para ver la trayectoria de cada petición:

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: Decisiones Críticas de Implementación

Soluciones prácticas diseñadas para superar limitaciones de protocolos corporativos, streaming e ingesta de documentos.

01.Sin RAG Tradicional

Navegación Agéntica de Documentos con MarkItDown

En lugar de recortar archivos en fragmentos vectoriales opacos que descontextualizan tablas de beneficios, la canalización convierte los documentos de SharePoint (PDF, Word, PowerPoint) a Markdown limpio y genera un INDEX.md semántico. Synthia lee el índice y realiza búsquedas activas bajo demanda mediante la herramienta dedicada ler_documento, garantizando contexto completo y citas precisas.

02.Compatibilidad de Streaming

Microservicio Symphony-Shim

El gateway OpenClaw fue diseñado para requerir comunicación con stream: true mediante Server-Sent Events (SSE). Sin embargo, la API corporativa de Symphony LLM opera en batch JSON (stream: false). Desarrollamos un microservicio intermedio en Python que convierte el JSON en eventos SSE con finish_reason sanitizado en tiempo real.

03.Meta Cloud API

Plugin Nativo de WhatsApp con Audio Opus

Eliminamos puentes HTTP externos para ejecutar un plugin propietario directamente en el runtime. Para mensajes de voz, el canal instruye a ElevenLabs a sintetizar directamente en formato opus_48000_64 (Ogg/Opus), entregando notas de voz nativas en WhatsApp sin necesidad de incluir FFmpeg en el contenedor.

04

Infraestructura como Código y Postura de Seguridad

Despliegue 100% automatizado mediante Terraform en la región sa-east-1 (São Paulo), manteniendo los datos y PII de colaboradores en territorio brasileño.

Cero Puerto 22 (Sin SSH)

Ningún puerto de administración expuesto a internet. El acceso administrativo, despliegues y monitoreo se orquestan exclusivamente mediante AWS Systems Manager (SSM Session Manager y SSM Run Command).

Secretos sin .env en disco

Secretos y tokens residen en AWS SSM Parameter Store (SecureString) y se inyectan dinámicamente en memoria durante el despliegue, sin versionarse jamás en git.

EBS Dedicado con DLM

El estado persistente (~/.openclaw con SQLite, sesiones y workspaces) reside en un volumen EBS dedicado independiente de la raíz, protegido por prevent_destroy y snapshots diarios automáticos vía Data Lifecycle Manager.

Borde Seguro con Caddy

Emisión y renovación automática de TLS, exponiendo exclusivamente los endpoints autorizados (/api/messages, /whatsapp y /kb con token x-kb-token) y retornando 404 estricto para cualquier ruta no mapeada.

05

Impacto en Producción y Demostración en Video

Eficiencia operativa demostrada con respuesta instantánea y alta satisfacción de los colaboradores.

2Canales ActivosTeams y WhatsApp simultáneos
100%Sincronización KBFlujo delta de SharePoint automatizado
0Fuga de PIIAgente BP aislado en Teams
t4g.smallCosto Optimizado4 microservicios en 1 instancia ARM

Demostración en Video

Mira la atención de Synforce en acción, respondiendo dudas con lenguaje natural y contexto corporativo:

pt-br · desktop