Auto-hébergement

Comment auto-héberger une boîte de réception d'équipe WhatsApp

Comment préparer, tester et exploiter un déploiement WATeamInbox auto-hébergé, y compris ses services, sauvegardes, accès et risques de connexion WhatsApp.

Auto-héberger WATeamInbox signifie exécuter l’application web, les services de données et les workers de connexion WhatsApp sur une infrastructure que votre équipe contrôle.

Cet article couvre les décisions et les vérifications autour d’un déploiement. Pour les commandes et la configuration actuelles, suivez la documentation d’auto-hébergement et les fichiers du dépôt GitHub.

Décidez si votre équipe doit l’exploiter

L’auto-hébergement est un choix raisonnable si quelqu’un dans votre équipe est à l’aise avec Linux, Docker, les bases de données, le TLS, les sauvegardes et les mises à jour de routine. Cela peut maintenir l’application et les données de conversation client à l’intérieur d’un environnement que vous gérez.

C’est un mauvais choix si personne ne peut réagir lorsqu’un service s’arrête, qu’un disque se remplit ou qu’une migration échoue. Dans ce cas, WATeamInbox Cloud peut être plus simple, car nous exploitons la pile applicative.

Connaissez les services impliqués

La base de production actuelle comprend :

  • la boîte de réception web
  • l’API derrière le routeur HAProxy interne tenant compte de l’état de préparation (avec des répliques d’API homogènes optionnelles)
  • PostgreSQL pour les données applicatives et la recherche
  • NATS pour les commandes et les événements
  • Centrifugo pour les mises à jour en direct de la boîte de réception
  • les processus worker et orchestrateur WhatsApp
  • un Cloudflare R2 privé via le point de terminaison S3 de son compte pour les médias
  • Caddy pour le HTTPS et le routage de périphérie

Vous n’avez pas besoin de devenir un expert de chaque service avant d’exécuter la pile de développement. Vous devez en revanche savoir où chaque service stocke ses données, quels ports doivent rester privés et comment vous remarquerez une panne.

Lisez d’abord l’avertissement WhatsApp

WATeamInbox utilise une bibliothèque cliente WhatsApp non officielle. WhatsApp peut modifier son protocole ou ses politiques, l’appairage peut cesser de fonctionner et des restrictions de compte sont possibles. WATeamInbox ne peut pas garantir la sécurité des comptes et n’est pas affilié à WhatsApp ni à Meta.

Utilisez un numéro non critique pour le premier déploiement lorsque c’est possible. Ne transférez pas un numéro client important avant que votre équipe ait testé la reprise de connexion et convenu d’un processus de repli.

Notez où les données vivront

Avant de créer le serveur, décidez :

  • où sont stockées les données PostgreSQL
  • quel magasin d’objets contient les images, documents et messages vocaux
  • où les sauvegardes sont copiées
  • qui peut administrer l’hôte
  • comment les secrets sont créés, stockés et renouvelés
  • combien de temps les journaux et les données client sont conservés

Gardez les ports d’administration de la base de données, de NATS, de la recherche et du stockage d’objets hors de l’Internet public. Le point d’entrée web doit utiliser le HTTPS.

Utilisez un déploiement par étapes

1. Exécutez-le localement

Commencez par la configuration de développement du dépôt. Créez un espace de travail, invitez un autre utilisateur et suivez un message depuis WhatsApp jusque dans la boîte de réception web.

La configuration Compose locale utilise des identifiants de développement et des ports exposés. Ne la considérez pas comme une configuration de production.

2. Construisez un serveur de préproduction

Utilisez la base de production mono-hôte documentée sur un petit serveur non critique. Configurez de vrais fichiers de secrets, le TLS, des volumes persistants et des destinations de sauvegarde.

Avant d’inviter une équipe, confirmez que vous pouvez :

  • exécuter les migrations de base de données
  • appairer et reconnecter un numéro WhatsApp
  • envoyer et recevoir un message de test
  • ouvrir les médias pris en charge
  • attribuer une conversation entre deux utilisateurs
  • restreindre les actions avec des rôles et des permissions
  • restaurer la base de données et les références des médias sur un système vierge

3. Faites un pilote avec deux ou trois coéquipiers

Faites passer une petite file dans la boîte de réception. Convenez de qui surveille les messages non attribués, de quand un agent attribue une conversation et des informations qui ont leur place dans une note interne.

Surveillez les services pendant le pilote. Vérifiez la croissance du disque, la taille des sauvegardes, les redémarrages des workers et le comportement de la recherche au lieu d’attendre qu’un client signale un problème.

4. Préparez le numéro principal

Si vous décidez de transférer un numéro important, planifiez le changement et notez comment revenir au processus précédent. Conservez des sauvegardes récentes et assurez-vous que l’équipe sait qui contacter si la connexion WhatsApp tombe.

Sauvegardez à la fois les messages et les médias

Une sauvegarde de base de données ne suffit pas si les documents et les messages vocaux des clients sont stockés séparément. Sauvegardez PostgreSQL et le stockage d’objets selon un calendrier correspondant à la quantité de données que votre équipe peut se permettre de perdre.

Restaurez-les ensemble sur une autre machine. Confirmez que les utilisateurs, les conversations, les attributions et les médias se chargent toujours. Un test de restauration est la seule preuve fiable que la sauvegarde est utile.

Examinez les accès avant le lancement

Donnez à chaque coéquipier son propre compte. Réservez les rôles de propriétaire et d’administrateur aux personnes qui doivent gérer les connexions, les membres, les paramètres et les exports.

Examinez aussi l’accès à l’hôte. Les permissions du produit ne protègent pas les données de quelqu’un disposant de larges identifiants de base de données, de stockage d’objets ou de serveur.

Liste de vérification minimale avant le lancement

Avant de vous fier au déploiement, vérifiez :

  • le HTTPS fonctionne sur le domaine de production
  • seuls les ports prévus sont publics
  • chaque coéquipier se connecte avec un compte individuel
  • la connexion WhatsApp récupère après un redémarrage d’un worker
  • les attributions et les notes survivent à un relais
  • les médias pris en charge peuvent être visionnés
  • les sauvegardes s’exécutent en dehors de l’hôte principal
  • une restauration a réussi sur un système vierge
  • quelqu’un reçoit des alertes en cas de panne de service ou de stockage
  • l’équipe dispose d’un repli lorsque la connectivité WhatsApp est indisponible

Le guide de déploiement public est une base mono-hôte. Il peut utiliser plusieurs processus d’API pour la résilience des processus et des versions, mais ce n’est pas une conception à haute disponibilité ou multi-région ; ajustez donc vos attentes en conséquence. L’orchestrateur reste un singleton.

Lorsque ces vérifications deviennent routinières, continuez avec les commandes et la configuration dans la documentation d’auto-hébergement. Si l’exploitation de la pile devient plus de travail que votre équipe ne le souhaite, comparez les plans Cloud actuels.

Des questions ? Écrivez-nousWhatsApp · +65 8404 2683