Atendimento via WhatsApp · Implantação de plataforma de terceiros
ZapPop
Implantação, sob a marca ZapPop, de uma plataforma de atendimento multiusuário pelo WhatsApp baseada no Atendechat, produto de terceiros. Meu trabalho foi colocar a base em operação em servidor próprio, integrar o módulo da API oficial do WhatsApp, versionar e proteger a instalação e criar o site de apresentação.
Papel
Implantação, operação e site de apresentação
Organização e período
2026
Plataformas
Aplicação web de atendimento · API oficial do WhatsApp (módulo) · Site de apresentação
Site de apresentação do ZapPop.
01 / Contexto
História e problema
Para quem
Pequenas e médias empresas que atendem clientes pelo WhatsApp com mais de um atendente e precisam de filas, histórico e relatórios.
Problema
Atendimento feito em um único celular não escala: conversas se perdem, não há divisão entre atendentes nem registro do que foi resolvido. Construir uma plataforma do zero levaria meses; a alternativa foi licenciar uma base pronta e cuidar da implantação, da operação e da oferta comercial.
Restrições
Base de terceiros com instalador próprio, que precisou de ajustes de ambiente. Servidor compartilhado com outros projetos. Duas formas de conexão com o WhatsApp: a sessão do WhatsApp Web, sem custo por mensagem, e a API oficial da Meta, com webhook e aprovação.
Dez/2025 a fev/2026
Versões do instalador do Atendechat com suporte a múltiplas instâncias, mantido pelo fornecedor.
28/03/2026
Site de apresentação do ZapPop publicado, com planos, botão de contato pelo WhatsApp e ícone da marca.
2026
Aplicação, backend e API oficial implantados em três subdomínios, com HTTPS e processos gerenciados.
31/07/2026
Bancos e Redis do ZapPop incluídos na rotina diária de backup com retenção e cópia externa.
13/08/2026
Correção de DNS do site e criação de repositório privado da instalação, sem segredos.
02 / Papel
Minha responsabilidade
Liderança e direção
Decidi licenciar e implantar uma base existente em vez de construir uma plataforma de atendimento do zero.
Defini a separação entre site comercial, aplicação de atendimento, backend e API oficial em endereços próprios.
Defini as regras de operação: Redis antes do backend e verificação das filas antes de reiniciar.
Execução técnica direta
Implantei a base no servidor: frontend, backend e módulo da API oficial como processos PM2, nginx com WebSocket e certificados Let's Encrypt.
Configurei PostgreSQL para a aplicação e para a API oficial e Redis em contêiner para as filas.
Incluí a instalação no backup diário e criei o repositório privado excluindo arquivos de ambiente e dependências.
Administrei usuários e perfis de acesso da plataforma.
Trabalho da equipe
Aplicação de atendimento, módulo da API oficial e instalador: desenvolvidos e mantidos pelo fornecedor do Atendechat.
03 / Arquitetura
Arquitetura documentada
A instalação segue a arquitetura da base Atendechat: frontend React, backend Node.js com Express e TypeScript, PostgreSQL via Sequelize, filas Bull sobre Redis e eventos em tempo real com Socket.IO. Ao lado roda o módulo da API oficial do WhatsApp em NestJS com Prisma. O site de apresentação é uma aplicação Next.js separada.
Implantação do ZapPop
Acesso
Site de apresentação
App de atendimento
Borda
nginx + HTTPS
PM2
Aplicação (Atendechat)
Backend Express
API oficial (NestJS)
Socket.IO
Dados e filas
PostgreSQL
Redis (Bull)
WhatsApp
Sessão WhatsApp Web
API oficial da Meta
Conexões
O site e a aplicação chegam aos processos pelo nginx com HTTPS.
O PM2 mantém frontend, backend, API oficial e site em execução.
O backend persiste no PostgreSQL, enfileira tarefas no Redis e envia eventos por Socket.IO.
O backend conecta sessões do WhatsApp Web e a API oficial recebe o webhook da Meta.
Camadas e tecnologias
Base de terceiros
Atendechat: backend Node.js com Express 4, TypeScript, Sequelize 5 sobre PostgreSQL (pg), Bull 3, Socket.IO 4, biblioteca Baileys para sessões do WhatsApp Web e integração com OpenAI; frontend React 16 com Material UI.
API oficial
Módulo do mesmo fornecedor em NestJS 10 com Prisma 5, PostgreSQL próprio e ioredis, com documentação Swagger e webhook por empresa e conexão.
Infraestrutura
Servidor Linux com PM2, nginx com cabeçalhos de WebSocket, certificados Let's Encrypt por subdomínio e Redis em contêiner Docker.
Site de apresentação
Next.js 16.2, React 19.2, TypeScript 5 e Tailwind CSS 4, com ícones Lucide, em processo próprio atrás do nginx.
Continuidade
Backup diário dos dois bancos e do Redis com retenção e cópia externa; repositório privado com a instalação, sem arquivos de ambiente nem dependências.
04 / Decisões
Decisões técnicas e compromissos
01
Licenciar a base em vez de construir
Problema
Uma plataforma de atendimento com filas, campanhas, agendamentos e várias conexões levaria meses para ficar estável.
Decisão
Adotar o Atendechat e concentrar o trabalho em implantação, operação e oferta comercial.
Motivo
Coloca o produto em operação rapidamente e deixa a evolução do núcleo com quem o mantém.
Compromisso
Dependência do fornecedor para correções e atualizações e pouca diferenciação técnica no núcleo.
02
Sessão do WhatsApp Web e API oficial lado a lado
Problema
A sessão do WhatsApp Web não tem custo por mensagem, mas não é o canal oficial; a API da Meta é oficial, mas exige aprovação e cobra por conversa.
Decisão
Manter as duas opções: a conexão padrão da base e o módulo da API oficial em endereço próprio.
Motivo
Cada cliente escolhe entre custo e conformidade com as regras da plataforma.
Compromisso
Dois serviços, dois bancos e mais pontos de falha para operar.
03
Versionar uma instalação que só existia no servidor
Problema
A instalação rodava sem controle de versão; uma falha de disco ou alteração indevida não teria como ser revertida.
Decisão
Criar repositório privado a partir do servidor, excluindo os arquivos de ambiente e as dependências, e incluir bancos e Redis no backup diário.
Motivo
Recuperação e auditoria de mudanças sem expor credenciais.
Compromisso
O primeiro commit registra o estado já em produção, sem o histórico anterior das alterações.
05 / Evidências
Resultados e próximos passos
Resultados e evidências
Plataforma implantada em três subdomínios do ZapPop, com HTTPS e processos gerenciados.
Site de apresentação entregue em março de 2026.
Instalação versionada e coberta por backup diário a partir de julho e agosto de 2026.
Próximos passos
O núcleo da aplicação é de terceiros; não há no repositório evidência de alterações próprias no código do Atendechat.
Próximo passo: testes automatizados próprios e monitoramento de disponibilidade documentado.
