Self-Hosting

So hosten Sie einen WhatsApp-Team-Posteingang selbst

Wie Sie ein selbst gehostetes WATeamInbox-Deployment vorbereiten, testen und betreiben — inklusive Diensten, Backups, Zugriff und Risiken der WhatsApp-Verbindung.

WATeamInbox selbst zu hosten bedeutet, die Webanwendung, die Datendienste und die WhatsApp-Verbindungs-Worker auf einer Infrastruktur zu betreiben, die Ihr Team kontrolliert.

Dieser Artikel behandelt die Entscheidungen und Prüfungen rund um ein Deployment. Für aktuelle Befehle und Konfiguration folgen Sie der Self-Hosting-Dokumentation und den Dateien im GitHub-Repository.

Entscheiden Sie, ob Ihr Team es betreiben sollte

Self-Hosting ist eine sinnvolle Wahl, wenn jemand in Ihrem Team mit Linux, Docker, Datenbanken, TLS, Backups und routinemäßigen Updates vertraut ist. Es kann die Anwendung und die Daten der Kundenkonversationen in einer Umgebung halten, die Sie verwalten.

Es passt schlecht, wenn niemand reagieren kann, wenn ein Dienst stoppt, eine Festplatte voll läuft oder eine Migration fehlschlägt. In diesem Fall ist WATeamInbox Cloud möglicherweise einfacher, weil wir den Anwendungs-Stack betreiben.

Kennen Sie die beteiligten Dienste

Die aktuelle Produktions-Baseline umfasst:

  • den Web-Posteingang
  • die API hinter dem internen, readiness-fähigen HAProxy-Router (mit optionalen homogenen API-Replikaten)
  • PostgreSQL für Anwendungsdaten und die Suche
  • NATS für Befehle und Events
  • Centrifugo für Live-Posteingang-Aktualisierungen
  • WhatsApp-Worker- und -Orchestrator-Prozesse
  • privates Cloudflare R2 über den S3-API-Endpunkt seines Kontos für Medien
  • Caddy für HTTPS und Edge-Routing

Sie müssen nicht in jedem Dienst zum Experten werden, bevor Sie den Entwicklungs-Stack betreiben. Sie müssen aber wissen, wo jeder Dienst Daten speichert, welche Ports privat sein sollten und wie Sie einen Ausfall bemerken.

Lesen Sie zuerst den WhatsApp-Warnhinweis

WATeamInbox verwendet eine inoffizielle WhatsApp-Client-Bibliothek. WhatsApp kann sein Protokoll oder seine Richtlinien ändern, das Pairing kann nicht mehr funktionieren und Kontobeschränkungen sind möglich. WATeamInbox kann die Kontosicherheit nicht garantieren und ist nicht mit WhatsApp oder Meta verbunden.

Verwenden Sie für das erste Deployment nach Möglichkeit eine nicht kritische Nummer. Übertragen Sie keine wichtige Kundennummer, bis Ihr Team die Wiederherstellung der Verbindung getestet und sich auf einen Ausweichprozess geeinigt hat.

Schreiben Sie auf, wo die Daten liegen werden

Entscheiden Sie, bevor Sie den Server erstellen:

  • wo die PostgreSQL-Daten gespeichert werden
  • welcher Objektspeicher Bilder, Dokumente und Sprachnachrichten enthält
  • wohin Backups kopiert werden
  • wer den Host administrieren darf
  • wie Secrets erstellt, gespeichert und rotiert werden
  • wie lange Logs und Kundendaten aufbewahrt werden

Halten Sie die Administrations-Ports für Datenbank, NATS, Suche und Objektspeicher aus dem öffentlichen Internet fern. Der Web-Einstiegspunkt sollte HTTPS verwenden.

Nutzen Sie einen gestaffelten Rollout

1. Betreiben Sie es lokal

Beginnen Sie mit dem Entwicklungs-Setup im Repository. Erstellen Sie einen Workspace, laden Sie einen weiteren Benutzer ein und verfolgen Sie eine Nachricht von WhatsApp bis in den Web-Posteingang.

Die lokale Compose-Konfiguration verwendet Entwicklungs-Zugangsdaten und offengelegte Ports. Behandeln Sie sie nicht als Produktionskonfiguration.

2. Bauen Sie einen Staging-Server

Verwenden Sie die dokumentierte Single-Host-Produktions-Baseline auf einem kleinen, nicht kritischen Server. Konfigurieren Sie echte Secret-Dateien, TLS, persistente Volumes und Backup-Ziele.

Bestätigen Sie, bevor Sie ein Team einladen, dass Sie Folgendes können:

  • Datenbankmigrationen ausführen
  • eine WhatsApp-Nummer koppeln und wieder verbinden
  • eine Testnachricht senden und empfangen
  • unterstützte Medien öffnen
  • eine Konversation zwischen zwei Benutzern zuweisen
  • Aktionen mit Rollen und Berechtigungen einschränken
  • die Datenbank und die Medienreferenzen auf einem sauberen System wiederherstellen

3. Pilotieren Sie mit zwei oder drei Teamkollegen

Lassen Sie eine kleine Warteschlange durch den Posteingang laufen. Einigen Sie sich darauf, wer nicht zugewiesene Nachrichten beobachtet, wann ein Agent eine Konversation zuweist und welche Informationen in eine interne Notiz gehören.

Beobachten Sie die Dienste während des Pilotbetriebs. Prüfen Sie Festplattenwachstum, Backup-Größe, Worker-Neustarts und das Suchverhalten, anstatt zu warten, bis ein Kunde ein Problem meldet.

4. Bereiten Sie die Hauptnummer vor

Wenn Sie sich entscheiden, eine wichtige Nummer zu übertragen, planen Sie die Umstellung und notieren Sie, wie Sie zum vorherigen Prozess zurückkehren. Halten Sie aktuelle Backups bereit und stellen Sie sicher, dass das Team weiß, wen es kontaktieren muss, wenn die WhatsApp-Verbindung abbricht.

Sichern Sie sowohl Nachrichten als auch Medien

Ein Datenbank-Backup reicht nicht aus, wenn Kundendokumente und Sprachnachrichten separat gespeichert werden. Sichern Sie PostgreSQL und den Objektspeicher in einem Rhythmus, der zu der Datenmenge passt, deren Verlust Ihr Team verkraften kann.

Stellen Sie sie gemeinsam auf einer anderen Maschine wieder her. Bestätigen Sie, dass Benutzer, Konversationen, Zuweisungen und Medien weiterhin laden. Ein Wiederherstellungstest ist der einzige verlässliche Beweis, dass das Backup nützlich ist.

Prüfen Sie den Zugriff vor dem Start

Geben Sie jedem Teamkollegen ein eigenes Konto. Reservieren Sie Eigentümer- und Administratorrollen für Personen, die Verbindungen, Mitglieder, Einstellungen und Exporte verwalten müssen.

Prüfen Sie auch den Host-Zugriff. Produktberechtigungen schützen die Daten nicht vor jemandem mit umfassenden Datenbank-, Objektspeicher- oder Server-Zugangsdaten.

Mindest-Checkliste für den Start

Überprüfen Sie, bevor Sie sich auf das Deployment verlassen:

  • HTTPS funktioniert auf der Produktionsdomain
  • nur die vorgesehenen Ports sind öffentlich
  • jeder Teamkollege meldet sich mit einem individuellen Konto an
  • die WhatsApp-Verbindung erholt sich nach einem Worker-Neustart
  • Zuweisungen und Notizen überstehen eine Übergabe
  • unterstützte Medien können angezeigt werden
  • Backups laufen abseits des Haupt-Hosts
  • eine Wiederherstellung ist auf einem sauberen System gelungen
  • jemand erhält Benachrichtigungen bei Dienst- oder Speicherausfällen
  • das Team hat eine Ausweichlösung, wenn die WhatsApp-Konnektivität nicht verfügbar ist

Der öffentliche Deployment-Leitfaden ist eine Single-Host-Baseline. Er kann mehrere API-Prozesse für Prozess- und Release-Resilienz nutzen, ist aber kein Hochverfügbarkeits- oder Multi-Region-Design, setzen Sie die Erwartungen also entsprechend. Der Orchestrator bleibt ein Singleton.

Wenn diese Prüfungen zur Routine geworden sind, fahren Sie mit den Befehlen und der Konfiguration in der Self-Hosting-Dokumentation fort. Wenn der Betrieb des Stacks mehr Aufwand wird, als Ihr Team möchte, vergleichen Sie die aktuellen Cloud-Tarife.

Fragen? Schreiben Sie unsWhatsApp · +65 8404 2683