Grundkonzepte
Workspaces, Kanäle, Kontakte, Vorlagen, Kampagnen, Konversationen und die dauerhafte Outbox — das Vokabular, auf dem Servus aufbaut.
Zuletzt aktualisiert 18. Juni 2026
Workspace & Tenant
Ein Workspace (ein Tenant) ist die Isolationsgrenze für alles, was du anlegst — Kanäle, Kontakte, Vorlagen, Nachrichten und Teammitglieder. Der Tenant wird stets aus deinem Credential abgeleitet (der Portal-Session oder einem API-Key), nie aus einem Request-Body — Daten überschreiten also nie Workspace-Grenzen.
Kanäle
Ein Kanal ist ein verbundenes Konto, von dem du sendest und empfängst — eine WhatsApp-Nummer, ein SMS-Gateway-Telefon oder eine E-Mail-Versanddomain. Jeder Kanal hat einen Verbindungs-Lebenszyklus (Ausstehend → Verbindet → Verbunden); seine Anmeldedaten sind ruhend verschlüsselt und werden dir nie wieder angezeigt.
Kontakte, Segmente & Einwilligung
Ein Kontakt ist eine erreichbare Person (Telefon, E-Mail oder beides) mit Tags und einem Einwilligungs-Status. Ein Segment ist ein gespeicherter Filter über Kontakte (z. B. "hat Tag vip, eingewilligt"), der zu einer Live-Mitgliedschaft auflöst und Kampagnen speist. Opt-out wird immer respektiert — wer STOP antwortet, ist abgemeldet, und Sendungen an abgemeldete Kontakte werden blockiert.
Vorlagen & Kampagnen
Eine Vorlage ist ein wiederverwendbarer, versionierter Nachrichtentext mit {{variables}} und einem Freigabe-Lebenszyklus. Eine Kampagne sendet eine freigegebene Vorlage an ein Segment oder eine explizite Liste, vom Gateway getaktet, während es die Outbox leert.
Konversationen & die Outbox
Eingehende Nachrichten bündeln sich zu Konversationen — ein Kontakt auf einem Kanal — im geteilten Posteingang. Jede ausgehende Sendung wird in einer dauerhaften Outbox gespeichert, bevor die API antwortet; ein Gateway-Worker stellt sie dann asynchron zu und erfasst das echte Ergebnis — eine Sendung geht also nie stillschweigend verloren.