Voltar aos trabalhos selecionados

FunnelChat: camada de API, integrações do painel e migração de nuvem

Atuação
FunnelChat API / Manager · cliente do Setup Automatizado
Período
Agosto de 2025–atual
Tecnologias
  • Go
  • whatsmeow
  • WebRTC
  • MCP
  • OAuth 2.1
  • Next.js
  • TypeScript
  • Stripe
  • NATS JetStream
  • PostgreSQL
  • Redis
  • Terraform
  • AWS
  • OCI
  • Kubernetes
  • Prometheus
  • Grafana
FunnelChat APIDiagrama conceitual · simplificado
  1. Eventos da instância
  2. API Go
  3. Canais NATS JetStream
Eventos seriais
Recibos

Controle de eventos anterioresEntrega ao cliente

Eventos seriais anteriores condicionam o envio dos recibos. Os callbacks dos recibos não têm ordem total.

Em 30 segundos

Problema

O produto de mensageria precisava de API, painel de assinaturas e infraestrutura preparada para escalar, com custo e segurança dentro do trabalho de engenharia.

Minha contribuição

Pelo Setup, construí e evoluí a camada de API em Go sobre whatsmeow com endpoints compatíveis com a Z-API. Integrei chamadas por WebRTC e motor VoIP incorporado, implementei funcionalidades do painel SaaS e conduzi a migração da aplicação da AWS para Kubernetes na Oracle Cloud.

Resultado

A implementação conecta mensageria, preços configuráveis de assinatura e controles de deploy. Autoescala e serviços de estado em cluster sustentam uma arquitetura projetada para milhares de instâncias.

Como funciona

  1. Eventos da instância

    Chegam mensagens, mudanças de estado e recibos de entrega de cada instância do WhatsApp.

  2. API Go

    Separa os recibos de entrega do caminho de eventos seriais.

  3. Canais NATS JetStream

    Os eventos seriais mantêm um caminho ordenado; os recibos têm um consumidor durável próprio. Após reiniciar, o worker adota o consumidor existente e preserva sua posição.

  4. Admissão por canal

    Os workers admitem cada entrega por um ponto de coordenação PostgreSQL para seu canal.

  5. Controle de eventos anteriores

    Os eventos seriais anteriores da instância devem ser enviados antes do envio de um recibo.

  6. Entrega ao cliente

    A entrega usa o controle de admissão dos eventos seriais anteriores. Os callbacks de recibos podem chegar fora de ordem entre si; um recibo em trânsito pode chegar após um callback posterior.

O envio de um recibo aguarda o envio dos eventos seriais anteriores da instância. Os callbacks de recibos podem chegar fora de ordem entre si, e um recibo já em voo pode chegar depois de um callback posterior.

Decisões técnicas

  1. Construir a camada de API sobre whatsmeow e implementar contratos compatíveis com a Z-API.

    Por quê
    Os endpoints e eventos implementados expõem mensageria, campanhas e mídia por contratos REST conhecidos.
    Custo da decisão
    Compatibilidade de endpoints e mudanças da biblioteca exigem manutenção própria; a autoria da biblioteca permanece com seus criadores.
  2. Conduzir a migração da aplicação da base AWS para Kubernetes na Oracle Cloud.

    Por quê
    Autoescala, estado compartilhado e controles de deploy sustentam a arquitetura projetada.
    Custo da decisão
    A configuração Kubernetes introduz responsabilidades de recuperação de banco/broker, capacidade e controle de campos.
  3. Usar tickets restritos para chamadas e referências imutáveis de imagem.

    Por quê
    Uma chamada no navegador precisa de acesso limitado; um deploy precisa de um artefato identificável.
    Custo da decisão
    O resgate de tickets depende do estado compartilhado e as versões precisam passar pelas checagens de identidade da imagem.

Operação

Montei a base inicial na AWS com Terraform para ECS Fargate, RDS, ElastiCache, S3 e CloudFront e escrevi em Go o roteamento para o worker ECS responsável. Para a migração da aplicação a OKE, configurei autoescala de pods/nós, NATS JetStream, PostgreSQL/CloudNativePG, Redis Sentinel, observabilidade e controles de deploy/rede. O trabalho de custo incluiu builds ARM64 das imagens da aplicação, redimensionamento, OCI Object Storage no lugar do MinIO em cluster e uma malha de proxies com autoescala. Os controles implementados incluem tickets de chamada de uso único, proteção contra SSRF, imagens assinadas, deploy por digest e rede default-deny.

Autoria

Construí e evoluí a camada de API da aplicação sobre whatsmeow e implementei funcionalidades e integrações do painel. As chamadas usam uma ponte WebRTC e um motor VoIP incorporado de terceiros. Também revisei e integrei versões de vários autores, preservando a autoria original.

Construir a API em torno do contrato do produto

Construí e evoluí a camada de API de WhatsApp da FunnelChat em Go sobre whatsmeow, implementando contratos REST e eventos compatíveis com os endpoints Z-API cobertos por esse trabalho. A camada acrescenta mensageria, campanhas, tratamento de mídia e entrega de webhooks. Minha atuação é pelo Setup Automatizado e começou em agosto de 2025. O trabalho passou a incluir integração de chamadas no navegador, servidor MCP, funcionalidades do painel SaaS e migração de infraestrutura. A distinção de autoria é concreta: o whatsmeow fornece a biblioteca; minha contribuição é a camada de API e as integrações que expõem suas capacidades ao produto.

Persistir o estado para recuperar entregas

A entrega de webhooks usa outbox, fila de mensagens com falha e semântica de entrega at-least-once. Uma entrega pode ser tentada novamente, então a recuperação precisa de estado persistente. Trabalhei nos consumidores NATS JetStream e no registro de entregas em PostgreSQL, incluindo recuperação quando a chamada de criação de um consumidor atinge o timeout depois de o broker já tê-lo criado. A recuperação pode adotar o consumidor durável existente e preservar sua posição inicial. Os retries são limitados, e o cancelamento interrompe a espera durante o desligamento.

Vincular a concorrência a uma fronteira específica

Recibos têm um caminho separado de processamento que aguarda o envio dos eventos seriais anteriores da instância. É uma condição de despacho, não uma ordenação total de callbacks. Recibos podem chegar fora de sequência, e um já em voo pode chegar depois de um callback posterior. Implementei o consumidor e a checagem de posição de confirmação, mantendo o processamento serial como padrão. A separação configurável acrescenta ciclo de vida do consumidor, estado de drenagem e coordenação de banco por lane. São custos da decisão de concorrência, mesmo com uma fila separada.

Incorporar chamadas e acesso para agentes

Integrei chamadas de voz e vídeo no navegador por uma ponte WebRTC e motor VoIP incorporado de terceiros, além de servidor MCP com OAuth 2.1 para acesso explícito de agentes à API. Streams de chamada usam um ticket assinado, de curta duração, vinculado à instância e à chamada, em vez da credencial de instância. O Redis coordena seu resgate de uso único entre réplicas. Se o armazenamento falha, a requisição é recusada. O navegador obtém o ticket ao abrir o stream, evitando que o pedido de permissão do microfone consuma sua validade antes.

Tratar o painel como parte do produto

Implementei funcionalidades do painel SaaS em Next.js e integração com Stripe, com suporte a assinaturas e faturas com preços configuráveis em BRL, USD e EUR. A interface e os e-mails incluem localização em português, inglês e espanhol. Também mudei a integração de autenticação para que listagens de sessões e respostas não precisem expor os tokens de sessão subjacentes. A revogação resolve um identificador no servidor e verifica se pertence ao usuário autenticado. Esses controles ficam na integração do painel com o serviço de autenticação. O checkout seleciona a moeda pedida quando configurada e, caso contrário, usa o preço canônico.

Manter contratos utilizáveis pela interface

API e painel precisavam compartilhar o contrato de autenticação e acesso às chamadas. Mudei as ações do servidor para obter o ticket e devolver o endereço autorizado do stream, com cliente TypeScript gerado da especificação da API. Assim, a interação do navegador segue o contrato do backend. Cada mudança tem um lugar definido: o formato da API, uma checagem de autorização e a ação da interface que a utiliza.

Separar provisionamento de roteamento

A implementação inicial na AWS usou Terraform para provisionar ECS Fargate, RDS, ElastiCache, S3 e CloudFront. Adicionei distribuição de mídia com CloudFront Origin Access Control e políticas S3. A titularidade das requisições era outro problema: uma instância podia pertencer a um worker ECS específico, e a requisição precisava chegar até ele. Escrevi esse roteamento em Go, com reverse proxy interno e resposta explícita de indisponibilidade quando o worker responsável não pudesse ser alcançado. O Terraform gerenciava infraestrutura; o Go tomava a decisão de roteamento da aplicação.

Migrar para Kubernetes com estado compartilhado e controle definido

Montei a infraestrutura inicial na AWS e conduzi a migração da aplicação para Oracle Cloud Kubernetes Engine. Configurei autoescala de pods e nós, cluster NATS JetStream, PostgreSQL com CloudNativePG, Redis Sentinel e observabilidade com Prometheus/Grafana. A arquitetura é projetada para milhares de instâncias, com cenários e harness de testes de carga. Também foi preciso delimitar o controle dos campos Kubernetes: a automação não deve sobrescrever as réplicas gerenciadas pelo autoscaler horizontal. Corrigi essa fronteira e mantive checagens de imagem por digest, além de integrar mudanças revisadas de políticas de rede, orçamentos de interrupção e alertas.

Escolher recursos com foco no custo

Custo era um objetivo do trabalho de infraestrutura. Adaptei os builds das imagens da aplicação para ARM64, redimensionei recursos e substituí o armazenamento da aplicação no MinIO do cluster por OCI Object Storage. Também implementei uma malha de proxies com autoescala. São mudanças concretas na computação, armazenamento e capacidade de proxy da aplicação. Elas também afetam a operação: imagens específicas de arquitetura restringem alocação, e autoescala precisa de regras de capacidade além do código de deploy. A configuração conecta essas escolhas de recursos com serviços compartilhados, recuperação e controles de deploy.

Aplicar segurança onde se concede autoridade

Tickets de uso único, checagens de titularidade de sessão no servidor e proteção contra SSRF restringem o que um cliente pode pedir ou receber. Imagens assinadas, deploys fixados por digest e redes que negam tráfego por padrão acrescentam controles de entrega e comunicação entre serviços. Meu trabalho incluiu implementação e integração de versões. Quando uma versão continha commits de outros autores, preservei sua autoria e distingui revisão e integração de escrita de código. API, painel e infraestrutura mostram o alcance da minha função: construir o produto, tratar falhas e considerar acesso e custo no desenho.

Vamos conversar sobre uma oportunidade em engenharia

Interesse em oportunidades presenciais e híbridas em toda a Espanha e trabalho remoto na Europa.

contato@guilhermejansen.com

Guilherme Jansen · Engenheiro de Software Sênior · Engenheiro de IA

Voltar ao topo