Auto-hospedagem

Como auto-hospedar uma caixa de entrada de equipe do WhatsApp

Como preparar, testar e operar uma instalação auto-hospedada do WATeamInbox, incluindo seus serviços, backups, acesso e riscos da conexão com o WhatsApp.

Auto-hospedar o WATeamInbox significa executar o aplicativo web, os serviços de dados e os workers de conexão com o WhatsApp em uma infraestrutura que sua equipe controla.

Este artigo trata das decisões e verificações em torno de uma instalação. Para os comandos e as configurações atuais, siga a documentação de auto-hospedagem e os arquivos no repositório do GitHub.

Decida se sua equipe deve operá-lo

A auto-hospedagem é uma escolha razoável se alguém da sua equipe estiver confortável com Linux, Docker, bancos de dados, TLS, backups e atualizações de rotina. Ela pode manter o aplicativo e os dados das conversas de clientes dentro de um ambiente que você gerencia.

É uma má opção se ninguém puder responder quando um serviço parar, um disco encher ou uma migração falhar. Nesse caso, o WATeamInbox Cloud pode ser mais simples, porque operamos a pilha do aplicativo.

Conheça os serviços envolvidos

A base de produção atual inclui:

  • a caixa de entrada web
  • a API por trás do roteador interno HAProxy ciente de prontidão (com réplicas de API homogêneas opcionais)
  • PostgreSQL para dados do aplicativo e busca
  • NATS para comandos e eventos
  • Centrifugo para atualizações ao vivo da caixa de entrada
  • processos de worker e orquestrador do WhatsApp
  • Cloudflare R2 privado através do endpoint da API S3 da conta para mídia
  • Caddy para HTTPS e roteamento de borda

Você não precisa se tornar especialista em todos os serviços antes de executar a pilha de desenvolvimento. Mas precisa saber onde cada serviço armazena dados, quais portas devem ser privadas e como você perceberá uma falha.

Leia o aviso sobre o WhatsApp primeiro

O WATeamInbox usa uma biblioteca de cliente não oficial do WhatsApp. O WhatsApp pode mudar seu protocolo ou suas políticas, o pareamento pode parar de funcionar e restrições de conta são possíveis. O WATeamInbox não pode garantir a segurança da conta e não é afiliado ao WhatsApp nem à Meta.

Use um número não crítico na primeira instalação sempre que possível. Não transfira um número importante de clientes até que sua equipe tenha testado a recuperação de conexão e acordado um processo de contingência.

Anote onde os dados vão ficar

Antes de criar o servidor, decida:

  • onde os dados do PostgreSQL serão armazenados
  • qual armazenamento de objetos guardará imagens, documentos e mensagens de voz
  • para onde os backups serão copiados
  • quem poderá administrar o host
  • como os segredos são criados, armazenados e rotacionados
  • por quanto tempo os logs e os dados dos clientes são retidos

Mantenha as portas de administração do banco de dados, do NATS, da busca e do armazenamento de objetos fora da internet pública. O ponto de entrada web deve usar HTTPS.

Use uma implantação por etapas

1. Execute localmente

Comece com a configuração de desenvolvimento do repositório. Crie um espaço de trabalho, convide outro usuário e acompanhe uma mensagem do WhatsApp até a caixa de entrada web.

A configuração local do Compose usa credenciais de desenvolvimento e portas expostas. Não a trate como uma configuração de produção.

2. Monte um servidor de staging

Use a base de produção single-host documentada em um servidor pequeno e não crítico. Configure arquivos de segredos reais, TLS, volumes persistentes e destinos de backup.

Antes de convidar uma equipe, confirme que você consegue:

  • executar migrações de banco de dados
  • parear e reconectar um número do WhatsApp
  • enviar e receber uma mensagem de teste
  • abrir mídias suportadas
  • atribuir uma conversa entre dois usuários
  • restringir ações com funções e permissões
  • restaurar o banco de dados e as referências de mídia em um sistema limpo

3. Faça um piloto com dois ou três colegas

Execute uma fila pequena pela caixa de entrada. Combine quem monitora as mensagens não atribuídas, quando um agente atribui uma conversa e quais informações devem ir em uma nota interna.

Observe os serviços durante o piloto. Verifique o crescimento do disco, o tamanho dos backups, reinícios de worker e o comportamento da busca, em vez de esperar que um cliente relate um problema.

4. Prepare o número principal

Se decidir transferir um número importante, programe a mudança e anote como voltar ao processo anterior. Mantenha backups recentes e garanta que a equipe saiba a quem contatar se a conexão com o WhatsApp cair.

Faça backup de mensagens e mídia

Um backup do banco de dados não basta se os documentos e as mensagens de voz dos clientes forem armazenados separadamente. Faça backup do PostgreSQL e do armazenamento de objetos em um cronograma compatível com a quantidade de dados que sua equipe pode se dar ao luxo de perder.

Restaure os dois juntos em outra máquina. Confirme que usuários, conversas, atribuições e mídia ainda carregam. Um teste de restauração é a única prova confiável de que o backup é útil.

Revise o acesso antes do lançamento

Dê a cada colega sua própria conta. Reserve as funções de dono e administrador para pessoas que precisam gerenciar conexões, membros, configurações e exportações.

Revise também o acesso ao host. As permissões do produto não protegem os dados de alguém com credenciais amplas de banco de dados, armazenamento de objetos ou servidor.

Checklist mínimo de lançamento

Antes de depender da instalação, verifique:

  • o HTTPS funciona no domínio de produção
  • apenas as portas pretendidas são públicas
  • cada colega entra com uma conta individual
  • a conexão com o WhatsApp se recupera após um reinício de worker
  • atribuições e notas sobrevivem a uma passagem de bastão
  • mídias suportadas podem ser visualizadas
  • os backups são executados fora do host principal
  • uma restauração foi bem-sucedida em um sistema limpo
  • alguém recebe alertas de falhas de serviço ou armazenamento
  • a equipe tem uma contingência quando a conectividade com o WhatsApp não está disponível

O guia público de implantação é uma base single-host. Ele pode usar vários processos de API para resiliência de processo e de versão, mas não é um projeto de alta disponibilidade ou multi-região, então ajuste as expectativas de acordo. O orquestrador continua sendo um singleton.

Quando essas verificações forem rotina, continue com os comandos e as configurações na documentação de auto-hospedagem. Se operar a pilha se tornar mais trabalho do que sua equipe deseja, compare os planos do Cloud atuais.

Dúvidas? Fale com a genteWhatsApp · +65 8404 2683