Autohospedar WATeamInbox significa ejecutar la aplicación web, los servicios de datos y los workers de conexión con WhatsApp en una infraestructura que tu equipo controla.
Este artículo cubre las decisiones y comprobaciones en torno a un despliegue. Para los comandos y la configuración actuales, sigue la documentación de autohospedaje y los archivos del repositorio de GitHub.
Decide si tu equipo debería operarlo
Autohospedar es una opción razonable si alguien de tu equipo se siente cómodo con Linux, Docker, bases de datos, TLS, copias de seguridad y actualizaciones rutinarias. Puede mantener la aplicación y los datos de las conversaciones de los clientes dentro de un entorno que gestionas.
Es una mala opción si nadie puede reaccionar cuando un servicio se detiene, un disco se llena o una migración falla. En ese caso, WATeamInbox Cloud puede ser más sencillo porque nosotros operamos la pila de la aplicación.
Conoce los servicios implicados
La línea base de producción actual incluye:
- la bandeja de entrada web
- la API detrás del enrutador interno HAProxy consciente del estado de disponibilidad (con réplicas de API homogéneas opcionales)
- PostgreSQL para los datos de la aplicación y la búsqueda
- NATS para comandos y eventos
- Centrifugo para las actualizaciones en vivo de la bandeja de entrada
- los procesos del worker y el orquestador de WhatsApp
- Cloudflare R2 privado a través del endpoint S3 de su cuenta para los medios
- Caddy para HTTPS y el enrutamiento de borde
No necesitas convertirte en experto en cada servicio antes de ejecutar la pila de desarrollo. Sí necesitas saber dónde almacena los datos cada servicio, qué puertos deben ser privados y cómo notarás un fallo.
Lee primero la advertencia sobre WhatsApp
WATeamInbox usa una biblioteca cliente no oficial de WhatsApp. WhatsApp puede cambiar su protocolo o sus políticas, el emparejamiento puede dejar de funcionar y es posible que haya restricciones de cuenta. WATeamInbox no puede garantizar la seguridad de la cuenta y no está afiliado a WhatsApp ni a Meta.
Usa un número no crítico para el primer despliegue siempre que sea posible. No traslades un número importante de clientes hasta que tu equipo haya probado la recuperación de la conexión y haya acordado un proceso de respaldo.
Anota dónde vivirán los datos
Antes de crear el servidor, decide:
- dónde se almacenan los datos de PostgreSQL
- qué almacén de objetos guarda las imágenes, los documentos y los mensajes de voz
- dónde se copian las copias de seguridad
- quién puede administrar el host
- cómo se crean, almacenan y rotan los secretos
- durante cuánto tiempo se conservan los logs y los datos de los clientes
Mantén los puertos de administración de la base de datos, NATS, la búsqueda y el almacenamiento de objetos fuera de la internet pública. El punto de entrada web debe usar HTTPS.
Usa un despliegue por etapas
1. Ejecútalo localmente
Empieza con la configuración de desarrollo del repositorio. Crea un espacio de trabajo, invita a otro usuario y sigue un mensaje desde WhatsApp hasta la bandeja de entrada web.
La configuración local de Compose usa credenciales de desarrollo y puertos expuestos. No la trates como una configuración de producción.
2. Construye un servidor de staging
Usa la línea base de producción de host único documentada en un servidor pequeño y no crítico. Configura archivos de secretos reales, TLS, volúmenes persistentes y destinos de copias de seguridad.
Antes de invitar a un equipo, confirma que puedes:
- ejecutar migraciones de base de datos
- emparejar y reconectar un número de WhatsApp
- enviar y recibir un mensaje de prueba
- abrir los medios compatibles
- asignar una conversación entre dos usuarios
- restringir acciones con roles y permisos
- restaurar la base de datos y las referencias de medios en un sistema limpio
3. Haz un piloto con dos o tres compañeros
Lleva una pequeña cola a través de la bandeja de entrada. Acuerda quién vigila los mensajes sin asignar, cuándo un agente asigna una conversación y qué información corresponde a una nota interna.
Observa los servicios durante el piloto. Comprueba el crecimiento del disco, el tamaño de las copias de seguridad, los reinicios de los workers y el comportamiento de la búsqueda en lugar de esperar a que un cliente informe de un problema.
4. Prepara el número principal
Si decides trasladar un número importante, programa el cambio y anota cómo volver al proceso anterior. Conserva copias de seguridad recientes y asegúrate de que el equipo sepa a quién contactar si la conexión de WhatsApp se cae.
Haz copias de seguridad tanto de los mensajes como de los medios
Una copia de seguridad de la base de datos no es suficiente si los documentos y los mensajes de voz de los clientes se almacenan por separado. Haz copias de seguridad de PostgreSQL y del almacenamiento de objetos con una frecuencia que coincida con la cantidad de datos que tu equipo pueda permitirse perder.
Restáuralos juntos en otra máquina. Confirma que los usuarios, las conversaciones, las asignaciones y los medios siguen cargándose. Una prueba de restauración es la única prueba fiable de que la copia de seguridad es útil.
Revisa el acceso antes del lanzamiento
Da a cada compañero su propia cuenta. Reserva los roles de propietario y administrador para las personas que necesiten gestionar conexiones, miembros, configuraciones y exportaciones.
Revisa también el acceso al host. Los permisos del producto no protegen los datos frente a alguien con credenciales amplias de base de datos, almacenamiento de objetos o servidor.
Lista de comprobación mínima para el lanzamiento
Antes de depender del despliegue, verifica que:
- HTTPS funciona en el dominio de producción
- solo son públicos los puertos previstos
- cada compañero inicia sesión con una cuenta individual
- la conexión de WhatsApp se recupera tras el reinicio de un worker
- las asignaciones y las notas sobreviven a un traspaso
- los medios compatibles se pueden ver
- las copias de seguridad se ejecutan fuera del host principal
- una restauración ha tenido éxito en un sistema limpio
- alguien recibe alertas ante fallos de servicio o de almacenamiento
- el equipo tiene un respaldo cuando la conectividad de WhatsApp no está disponible
La guía pública de despliegue es una línea base de host único. Puede usar varios procesos de API para dar resiliencia a procesos y versiones, pero no es un diseño de alta disponibilidad ni multirregión, así que ajusta tus expectativas en consecuencia. El orquestador sigue siendo un singleton.
Cuando esas comprobaciones sean rutinarias, continúa con los comandos y la configuración de la documentación de autohospedaje. Si operar la pila se convierte en más trabajo del que tu equipo quiere, compara los planes de Cloud actuales.