FunnelChat: capa de API, integraciones del panel y migración entre nubes


- Eventos de instancia
- API Go
- Canales NATS JetStream
Control de eventos anterioresEntrega al cliente
Los eventos secuenciales anteriores condicionan el envío de las confirmaciones. Los callbacks de confirmación no tienen un orden total.
En 30 segundos
Problema
El producto de mensajería necesitaba una API, un panel de suscripciones e infraestructura preparada para escalar, con el coste y la seguridad dentro del trabajo de ingeniería.
Mi contribución
A través de Setup construí y evolucioné la capa de API en Go sobre whatsmeow con endpoints compatibles con Z-API. Integré llamadas mediante WebRTC y un motor VoIP incorporado, implementé funcionalidades del panel SaaS y dirigí la migración de la aplicación de AWS a Kubernetes en Oracle Cloud.
Resultado
La implementación conecta mensajería, precios configurables de suscripción y controles de despliegue. El autoescalado y los servicios con estado en clúster respaldan una arquitectura diseñada para miles de instancias.
Cómo funciona
Eventos de instancia
Llegan mensajes, cambios de estado y recibos de entrega de cada instancia de WhatsApp.
API Go
Separa los recibos de entrega de la ruta de eventos seriales.
Canales NATS JetStream
Los eventos seriales conservan una ruta ordenada; los recibos tienen un consumidor duradero propio. Tras un reinicio, el worker adopta el consumidor existente y conserva su posición.
Admisión por canal
Los workers admiten cada entrega mediante un punto de coordinación de PostgreSQL por canal.
Control de eventos anteriores
Los eventos secuenciales anteriores de la instancia deben enviarse antes de que se envíe una confirmación.
Entrega al cliente
La entrega usa el control de admisión de los eventos seriales anteriores. Las confirmaciones de entrega pueden llegar desordenadas entre sí; una confirmación en curso puede llegar después de un callback posterior.
El envío de una confirmación espera a que se hayan enviado los eventos secuenciales anteriores de la instancia. Los callbacks de confirmación pueden llegar desordenados entre sí, y uno que ya esté en curso puede llegar después de un callback posterior.
Decisiones técnicas
Construir la capa de API sobre whatsmeow e implementar contratos compatibles con Z-API.
- Por qué
- Los endpoints y eventos implementados exponen mensajería, campañas y medios mediante contratos REST conocidos.
- Coste de la decisión
- La compatibilidad de endpoints y los cambios de la biblioteca requieren mantenimiento propio; la autoría de la biblioteca sigue siendo de sus creadores.
Dirigir la migración de la aplicación desde la base AWS a Kubernetes en Oracle Cloud.
- Por qué
- El autoescalado, el estado compartido y los controles de despliegue respaldan la arquitectura prevista.
- Coste de la decisión
- La configuración Kubernetes introduce responsabilidades de recuperación de base de datos/broker, capacidad y control de campos.
Usar tickets de llamada acotados y referencias de imagen inmutables.
- Por qué
- Cada llamada en el navegador necesita acceso limitado; cada despliegue, un artefacto identificable.
- Coste de la decisión
- El canje de tickets depende del estado compartido y las versiones deben superar comprobaciones de identidad de imagen.
Operación
Monté la base inicial en AWS con Terraform para ECS Fargate, RDS, ElastiCache, S3 y CloudFront, y escribí en Go el enrutamiento al worker ECS responsable. Para la migración de la aplicación a OKE configuré autoescalado de pods/nodos, NATS JetStream, PostgreSQL/CloudNativePG, Redis Sentinel, observabilidad y controles de despliegue/red. El trabajo de coste incluyó builds ARM64 de imágenes de la aplicación, ajuste de recursos, OCI Object Storage en lugar de MinIO dentro del clúster y una malla de proxies con autoescalado. Los controles implementados incluyen tickets de llamada de un solo uso, protección frente a SSRF, imágenes firmadas, despliegues fijados por digest y denegación de red por defecto.
Autoría
Construí y evolucioné la capa de API de la aplicación sobre whatsmeow e implementé funcionalidades e integraciones del panel. Las llamadas usan un puente WebRTC y un motor VoIP incorporado de terceros. También revisé e integré versiones de varios autores, conservando su autoría.
Construir la API alrededor del contrato del producto
Construí y evolucioné la capa de API de WhatsApp de FunnelChat en Go sobre whatsmeow, implementando contratos REST y eventos compatibles con los endpoints Z-API cubiertos por ese trabajo. La capa incorpora mensajería, campañas, tratamiento de medios y entrega de webhooks. Mi colaboración es a través de Setup Automatizado y empezó en agosto de 2025. El trabajo se amplió a integración de llamadas en el navegador, servidor MCP, funcionalidades del panel SaaS y migración de infraestructura. La distinción de autoría es concreta: whatsmeow aporta la biblioteca; mi contribución es la capa de API y las integraciones que exponen sus capacidades al producto.
Dar a la entrega un registro desde el que recuperarse
La entrega de webhooks utiliza outbox, cola de mensajes fallidos y semántica de entrega al menos una vez. Una entrega puede volver a intentarse, por lo que la recuperación necesita estado persistente. Trabajé en los consumidores NATS JetStream y el registro de entregas en PostgreSQL, incluida la recuperación cuando la creación de un consumidor agota el tiempo de espera después de que el broker lo haya creado. La recuperación puede adoptar el consumidor duradero existente y conservar su posición inicial. Los reintentos son limitados y la cancelación interrumpe la espera durante el apagado.
Vincular la concurrencia a un límite concreto
Las confirmaciones tienen una ruta de procesamiento separada que espera al envío de los eventos secuenciales anteriores de la instancia. Es una condición de despacho, no una ordenación total de callbacks. Las confirmaciones pueden llegar fuera de secuencia; una que ya esté en vuelo puede llegar después de un callback posterior. Implementé el consumidor y la comprobación de su posición de confirmación, conservando el procesamiento secuencial por defecto. La separación configurable añade ciclo de vida del consumidor, estado de vaciado y coordinación de base de datos por vía de procesamiento. Son costes propios de esa decisión de concurrencia.
Incorporar llamadas y acceso para agentes
Integré llamadas de voz y vídeo en el navegador mediante un puente WebRTC y un motor VoIP incorporado de terceros, junto con un servidor MCP con OAuth 2.1 para acceso explícito de agentes a la API. Los streams de llamada usan un ticket firmado de corta duración, vinculado a la instancia y la llamada, en lugar de la credencial de instancia. Redis coordina su canje de un solo uso entre réplicas. Si el almacenamiento falla, se rechaza la petición. El navegador obtiene el ticket al abrir el stream, evitando que la solicitud de permiso del micrófono consuma antes su validez.
Hacer del panel una parte del producto
Implementé funcionalidades del panel SaaS en Next.js e integración Stripe, con soporte para suscripciones y facturas con precios configurables en BRL, USD y EUR. La interfaz y los correos incluyen localización en portugués, inglés y español. También cambié la integración de autenticación para que los listados de sesiones y las respuestas no necesiten exponer los tokens de sesión subyacentes. La revocación resuelve un identificador en el servidor y comprueba que pertenece al usuario autenticado. Estos controles están en la integración del panel con el servicio de autenticación. El checkout selecciona la moneda solicitada cuando está configurada y, en caso contrario, usa el precio canónico.
Mantener los contratos utilizables desde la interfaz
La API y el panel debían compartir el contrato de autenticación y acceso a llamadas. Cambié las acciones del servidor para obtener el ticket y devolver la dirección de stream autorizada, con un cliente TypeScript generado desde la especificación API. Así, la interacción del navegador sigue el contrato del backend. Cada cambio tiene un lugar definido: la forma de la API, una comprobación de autorización y la acción de interfaz que la utiliza.
Separar el aprovisionamiento del enrutamiento
La implementación inicial en AWS utilizó Terraform para aprovisionar ECS Fargate, RDS, ElastiCache, S3 y CloudFront. Añadí distribución multimedia mediante CloudFront Origin Access Control y políticas S3. La propiedad de las peticiones era otro problema: una instancia podía pertenecer a un worker ECS concreto y la petición debía llegar a él. Escribí ese enrutamiento en Go, con un reverse proxy interno y una respuesta explícita de indisponibilidad si no se podía alcanzar al worker responsable. Terraform gestionaba la infraestructura; Go tomaba la decisión de enrutamiento en la aplicación.
Migrar a Kubernetes con estado compartido y control definido
Monté la infraestructura inicial en AWS y dirigí la migración de la aplicación a Oracle Cloud Kubernetes Engine. Configuré autoescalado de pods y nodos, clúster de NATS JetStream, PostgreSQL con CloudNativePG, Redis Sentinel y observabilidad con Prometheus/Grafana. La arquitectura está diseñada para miles de instancias, con escenarios y un harness de pruebas de carga. También había que delimitar el control de campos Kubernetes: la automatización no debe sobrescribir las réplicas gestionadas por el autoescalador horizontal. Corregí ese límite y mantuve comprobaciones de imagen por digest, además de integrar cambios revisados de políticas de red, presupuestos de interrupción y alertas.
Ajustar recursos para reducir costes
El coste era un objetivo del trabajo de infraestructura. Adapté los builds de las imágenes de la aplicación a ARM64, ajusté recursos y sustituí su almacenamiento MinIO dentro del clúster por OCI Object Storage. También implementé una malla de proxies con autoescalado. Son cambios concretos en el cómputo, almacenamiento y capacidad de proxy de la aplicación. También afectan a la operación: las imágenes específicas de arquitectura condicionan su ubicación y el autoescalado necesita reglas de capacidad además del código de despliegue. La configuración conecta estas decisiones de recursos con los servicios compartidos, la recuperación y los controles de despliegue.
Aplicar seguridad donde se concede autoridad
Los tickets de un solo uso, las comprobaciones de titularidad de sesiones en el servidor y la protección frente a SSRF acotan lo que puede solicitar o recibir un cliente. Las imágenes firmadas, los despliegues fijados por digest y las políticas de red de denegación por defecto añaden controles a la entrega y la comunicación entre servicios. Mi trabajo incluyó implementación e integración de versiones. Cuando una versión contenía commits de otros autores, conservé su autoría y distinguí revisión e integración de escritura de código. La API, el panel y la infraestructura muestran el alcance de mi función: construir el producto, atender sus fallos y considerar acceso y coste en el diseño.

