# Agenturkonten ## Was sind Agenturkonten? Mit Agenturkonten können Sie mehrere Kundenkonten über ein einziges Dashboard verwalten. Anstatt sich für jeden Kunden separat anzumelden, erhalten Sie eine zentralisierte Ansicht, in der Sie Unterkonten erstellen, Kampagnen überwachen, Guthaben zuweisen und sofort zwischen Kunden wechseln können. Dies ist für Marketingagenturen, Berater und Wiederverkäufer konzipiert, die die App im Namen mehrerer Unternehmen verwalten. ::: walkthrough agency-accounts ::: Die beiden Seiten, die dies ermöglichen – **Unterkonten** und **SaaS-Modus** – haben jeweils ihren eigenen Platz in der Seitenleiste, anstatt in den Einstellungen versteckt zu sein. Diese Seite ist die Übersicht; die täglichen Abläufe finden Sie unter [Unterkonten-Verwaltung](sub-accounts.md). --- ## Gemeinsames Guthabensystem Einer der Hauptunterschiede zwischen Agenturkonten und regulären Konten ist die Funktionsweise des Guthabens: - **Credits werden geteilt** zwischen Ihrem Agenturkonto und allen Unterkonten. - Wenn ein Unterkonto Credits verbraucht (für KI-Antworten, Kampagnen usw.), werden die Credits von Ihrem Agenturguthaben abgezogen. - Unterkonten sehen das Credit-Guthaben nicht – sie sehen nur ihre eigene Nutzung. Sie als Agentur verwalten den gesamten Credit-Pool. **Beispiel:** Sie haben 1.000 Credits in Ihrem Agenturkonto. Kunde A sendet eine Kampagne an 50 Kontakte (50 Credits). Der KI-Bot von Kunde B antwortet auf 30 Konversationen (30 Credits). Ihr verbleibender Saldo beträgt 920 Credits. --- ## Erstellen von Unterkonten ::: master-only
Die Seite „Unterkonten“ in v2 zeigt die sechs Statistik-Kacheln (Unterkonten, Mit Problemen, Aktive Kampagnen, Pausierte Kampagnen, Kunden zugewiesen, Nicht zugewiesen), die Suchleiste und eine Kundenzeile in der Tabelle

Die Seite „Unterkonten“: Statistik-Kacheln oben (die beiden rechten teilen Ihr Guthaben-Pool in das auf, was durch Kundenlimits bereits beansprucht ist und was noch frei ist), eine Schaltfläche Konto hinzufügen und eine Verknüpfung zum SaaS-Modus.

::: 1. Klicken Sie in der Hauptseitenleiste auf **Sub Accounts** – dies ist eine eigene Seite direkt über **Settings**. 2. Klicken Sie auf die grüne Schaltfläche **Add account** (oben rechts). 3. Geben Sie die Details Ihres Kunden in dem dreistufigen Modal ein: Konto (Name, E-Mail), Unternehmen (Firmenname, Adresse, Beschreibung) und Funktionen. ::: master-only
Das Modal zum Hinzufügen eines Unterkontos im Schritt „Konto“, das den 3-stufigen Fortschritt (Konto, Unternehmen, Funktionen) mit Feldern für Vorname, Nachname und E-Mail zeigt

Das Modal zum Hinzufügen eines Unterkontos. Drei Schritte: Konto → Unternehmen → Funktionen. Die eingegebene E-Mail-Adresse wird zur Anmeldeadresse des Kunden.

::: 4. Klicken Sie auf **Create Account**. Ein Bestätigungsbildschirm zeigt das generierte Anmeldepasswort an – kopieren Sie es, bevor Sie das Fenster schließen. Der Kunde erhält es ebenfalls per E-Mail. Vollständige Anleitung: [Unterkonten-Verwaltung – Ein Unterkonto erstellen](sub-accounts.md#creating-a-sub-account). --- ## Einem potenziellen Kunden eine Live-Demo zeigen Bevor sich ein Kunde anmeldet, können Sie ihm eine Live-Vorschau des Chat-Assistenten auf seiner eigenen Website zeigen – ohne dass er etwas installieren muss. Verwenden Sie dazu den **Kunden-Demo-Link**. > **Derzeit nicht verfügbar.** Der Bereich **Kunden-Demo-Link** aus der vorherigen Version der App ist derzeit nicht Teil des Verwaltungsbildschirms des Chat-Widgets, daher können die folgenden Schritte noch nicht abgeschlossen werden. Sie sind hier als Beschreibung der Funktionsweise des Demo-Links aufgeführt. **So funktioniert es:** Sie fügen die Website-Adresse des Kunden ein, und die Plattform generiert einen teilbaren Link. Wenn der Kunde diesen Link öffnet, sieht er seine eigene Website mit Ihrem Chat-Widget darüber – vollständig live und bereit zum Chatten. An seiner tatsächlichen Website ändert sich nichts, und er muss keinen Code anfassen. Die Vorschau existiert vollständig unter Ihrem Link. **So gelangen Sie dorthin:** Öffnen Sie **Einstellungen → Kanäle → Kanäle**, klicken Sie auf die Karte **Chat-Widget**, suchen Sie den Bereich **Kunden-Demo-Link**, geben Sie die Website-Adresse des Kunden ein oder fügen Sie sie ein (zum Beispiel `theirbusiness.com`) und klicken Sie auf **Demo-Link kopieren**. Senden Sie diesen Link dann auf beliebigem Weg an den Kunden – per E-Mail, WhatsApp, Nachricht oder wo auch immer. ::: master-only
Einstellungen → Kanäle → Kanäle-Seite, die die Website-Chat-Widget-Karte mit einer Verwalten-Schaltfläche zeigt

Einstellungen → Kanäle → Kanäle: Die Website-Chat-Widget-Karte ist der Einstiegspunkt für die Einrichtung des Widgets.

::: ::: master-only
Das Verwalten-Modal für das Chat-Widget, das Erscheinungsbild-Einstellungen und ein Live-Vorschau-Panel zeigt – es enthält keinen Bereich für Kunden-Demo-Links

Das Verwalten-Modal heute: Bereiche für Erscheinungsbild, Verhalten, Lead-Erfassung sowie Kanäle & Einbettungen, aber kein Kunden-Demo-Link.

::: Ein paar Dinge, die Sie wissen sollten: - Manche Websites erlauben es nicht, innerhalb einer anderen Seite angezeigt zu werden (eine Sicherheitseinstellung auf deren Seite). In diesem Fall funktioniert der Demo-Link dennoch – er zeigt einen sauberen Vorschaurahmen mit der Website-Adresse, und der Chat-Assistent ist weiterhin voll funktionsfähig zum Ausprobieren. Das Gesprächserlebnis ist identisch; nur der Hintergrund der Website unterscheidet sich. - Die Demo verwendet Ihre tatsächliche Widget-Konfiguration, sodass alle Nachrichten, die der Kunde während des Tests sendet, wie bei jedem anderen Chat-Widget-Gespräch bei Ihnen eingehen. --- ## Anmeldedaten für Kunden Wenn Sie ein Unterkonto erstellen: - Der Kunde erhält eine E-Mail und ein Passwort, mit denen er sich auf Ihrer White-Label-Anmeldeseite in sein eigenes Konto einloggen kann. - Den Kunden Login-Zugriff zu gewähren ist **optional** – Sie können auf Wunsch alles in ihrem Namen verwalten. - Wenn sich der Kunde einloggt, sieht er sein eigenes Dashboard mit seinen Kampagnen, Kontakten und Chats. Er sieht nicht Ihr Agentur-Dashboard oder andere Unterkonten. - Das Credit-Guthaben ist für Unterkonten ausgeblendet, da Sie den geteilten Credit-Pool verwalten. --- ## Zwischen Unterkonten wechseln Es gibt zwei Möglichkeiten, in das Konto eines Kunden zu wechseln: **Der Kontowechsler, von überall aus:** 1. Klicken Sie oben in der Seitenleiste auf **Switch account**. ::: master-only
Das Dropdown-Menü zum Wechseln des Kontos in der Seitenleiste, das ein Suchfeld für Unterkonten zeigt

Das Konto wechseln-Dropdown, das von überall in der Seitenleiste geöffnet werden kann. Diese Agentur hat noch keine Unterkonten, daher ist die Liste leer – sobald Sie eines erstellen, erscheint es hier und kann nach Name oder E-Mail durchsucht werden.

::: 2. Suchen Sie nach dem Sub-Account anhand des Namens oder der E-Mail-Adresse oder scrollen Sie durch die Liste. 3. Klicken Sie darauf. Das Dashboard wird unter der Identität dieses Sub-Accounts neu geladen. **Über die Seite „Unterkonten“:** 1. Klicken Sie in der Seitenleiste auf **Unterkonten**. 2. Suchen Sie das Unterkonto in der Liste. Klicken Sie in dieser Zeile auf das **Mehr**-Menü (Drei-Punkte-Symbol ganz rechts). 3. Klicken Sie auf **Als Benutzer anmelden**. So oder so: Während Sie sich in einem Unterkonto befinden, färbt sich die Umschaltfläche in der Seitenleiste bernsteinfarben und zeigt **Unterstützung für: ** an. Klicken Sie darauf und wählen Sie **Zurück zu meiner Agentur**, um zu Ihrem eigenen Dashboard zurückzukehren. Die bernsteinfarbene **Unterstützung**-Leiste am oberen Seitenrand bietet dieselbe Exit-Option; klicken Sie auf das **×**, um die Leiste für den Rest Ihres Besuchs auszublenden, falls Sie den Platz benötigen. Wenn der Kunde die Zwei-Faktor-Authentifizierung aktiviert hat, werden Sie nicht nach dessen Code gefragt: Sie haben sich bereits als Sie selbst angemeldet, und der Code würde an den Kunden gehen, nicht an Sie. --- ## Nachverfolgung des Guthabenverbrauchs Als Agentur können Sie nachverfolgen, wie Guthaben über alle Unterkonten hinweg verbraucht wird: - **Statistik-Kacheln auf der Seite Unterkonten** – aggregierte Anzahl laufender/pausierter Kampagnen und wie viele Unterkonten Probleme haben. - **Tracking pro Unterkonto** – wie viele Credits jedes Unterkonto verbraucht, über das **Mehr**-Menü der jeweiligen Zeile. - **Details zum Credit-Verbrauch** – eine dedizierte Ansicht pro Unterkonto, die gekaufte Credits, verbrauchte Credits, das verbleibende Guthaben, die Nutzung nach Grund, die Top-Kampagnen nach Ausgaben und eine filterbare Transaktionstabelle anzeigt. ::: master-only
Die Seite „Unterkonten“ in v2, die die sechs Statistik-Kacheln zeigt: Unterkonten, Mit Problemen, Aktive Kampagnen, Pausierte Kampagnen, Kunden zugewiesen, Nicht zugewiesen

Die Statistik-Kacheln oben auf der Seite „Unterkonten“ – ein gesamtübergreifender Überblick über den Kampagnenstatus bei allen Kunden sowie darüber, wie viel Ihres Guthaben-Kontingents bereits durch die Ausgabenlimits der Kunden beansprucht wird (Kunden zugewiesen / Nicht zugewiesen). Das Mehr-Menü in jeder Zeile (nicht abgebildet – erfordert mindestens ein Unterkonto) ist der Ort, an dem sich die konto-spezifische Guthabenverfolgung und Details zur Guthabennutzung befinden.

::: Diese Transparenz hilft Ihnen, Ihre Kosten zu verstehen, Kunden mit hohem Verbrauch zu identifizieren und eine angemessene Preisgestaltung für Ihre Dienstleistungen festzulegen. --- ## Credit-Reselling (auch bekannt als SaaS-Modus) Mit der Kreditweiterveräußerung können Sie Kredite an Ihre Unterkonten zu Ihren eigenen Preisen verkaufen und so eine Einnahmequelle für Ihre Agentur schaffen. Dieser gesamte Bereich befindet sich auf einer eigenen Seitenleistenseite namens **SaaS-Modus** — das gleiche Feature, das Sie unter dem branchenüblichen Namen "Kreditweiterveräußerung" kennen könnten. Es ist im **Agentur**-Plan verfügbar und durch das **White-Labeling**-Feature-Flag geschützt. Wenn Ihr Plan White-Labeling beinhaltet — was bei jedem Lifetime-Deal-Tier der Fall ist, bei dem es aufgeführt ist — gehört die Weiterveräußerung bereits Ihnen: Sie sind nicht darauf beschränkt, die App für Kunden zu verwalten, sondern können Pläne unter Ihrer eigenen Marke, zu Ihren eigenen Preisen und über Ihr eigenes Stripe- oder PayPal-Konto verkaufen. Es muss nichts zusätzlich erworben werden. ### Funktionsweise 1. **SaaS-Modus öffnen** — klicken Sie auf den entsprechenden Eintrag in der Hauptseitenleiste (er befindet sich neben den Unterkonten, nahe dem unteren Rand des Menüs) oder klicken Sie auf das **SaaS-Modus**-Feld oben auf der Seite "Unterkonten". 2. **Kreditweiterveräußerung für ein Unterkonto aktivieren** im **Bearbeiten**-Modal (Seite "Unterkonten" → Zeile **Mehr**-Menü → **Bearbeiten** → **Kreditverwaltung**), indem Sie den Modus von "Manuell" auf "Weiterveräußerung" umstellen. Die Weiterveräußerung wird erst angeboten, wenn Ihre Agentur White-Labeling in ihrem Plan aktiviert hat. 3. **Preise festlegen** — definieren Sie Kreditpakete und Preise pro Kredit, die Ihre Unterkonten sehen, wenn sie Kredite kaufen. 4. **Durchsetzung von Mindestpreisen** — die Plattform erzwingt einen Mindestkreditpreis, um eine nachhaltige Preisgestaltung auf der gesamten Plattform zu gewährleisten. 5. **Unterkonten kaufen Kredite** über Ihren benutzerdefinierten Checkout, der von dem von Ihnen verbundenen Zahlungsanbieter betrieben wird — Stripe, PayPal oder beide. Zahlungen gehen direkt auf Ihr eigenes Konto bei diesem Anbieter. 6. **Kredite werden automatisch geliefert** an das Unterkonto nach dem Kauf. Die Kredite landen im gekauften Guthaben des Kunden, und die gleiche Anzahl an Krediten wird von Ihrem Agentur-Pool abgezogen — dieser Abzug sind Ihre Kosten für den Verkauf, während die Zahlung des Kunden auf Ihr eigenes Zahlungskonto geht. ### Guthaben-Wirtschaftlichkeit Wenn ein Kunde Kredite kauft, werden diese Kredite dem eigenen erworbenen Guthaben des Kunden hinzugefügt, und die gleiche Anzahl an Krediten wird **von Ihrem Agentur-Pool abgezogen**. Das Geld des Kunden geht an Ihr Stripe-Konto; der Pool-Abzug sind Ihre Plattformkosten für den Verkauf. Ihr Gewinn ist die Differenz zwischen dem von Ihnen festgelegten Preis und den Kosten dieser Kredite für Sie — was auch der Grund für den Mindestpreis pro Kredit ist (Sie können ein Paket nicht unter den eigenen Kreditkosten der Plattform anbieten). Halten Sie Ihren Pool gedeckt: Der Checkout erfordert, dass Ihr Agentur-Pool mindestens so viele Kredite enthält, wie das gekaufte Paket umfasst. Wenn Ihr Pool zum Zeitpunkt der Zahlung den Kauf nicht decken kann, belastet die Plattform automatisch die bei Ihrer Agentur hinterlegte Karte, um ihn aufzufüllen — und falls diese automatische Belastung fehlschlägt, wird die Zahlung des Kunden zurückerstattet und es werden keine Kredite geliefert. **Beispiel:** Sie verkaufen 150 Kredite für 25 $. Die 150 Kredite landen im erworbenen Guthaben des Kunden, die 25 $ gehen an Ihr Stripe-Konto und 150 Kredite werden von Ihrem Agentur-Pool abgezogen. Wenn diese Pool-Kredite Sie 15 $ kosten, beträgt Ihre Marge bei diesem Verkauf 10 $. Gekaufte Credits decken **alles ab, was der Kunde ausgibt** – KI-Antworten, Tools, Follow-ups sowie die Nicht-KI-WhatsApp-Kosten (Nummernmiete und ab dem 1. Oktober 2026 die nachrichtenbasierten Netzbetreibergebühren). All dies wird zuerst vom gekauften Guthaben des Kunden abgezogen; Ihr Agentur-Pool deckt nur das ab, was dieses Guthaben nicht abdecken kann. Es gibt keinen separaten Aufschlag pro Kunde auf die WhatsApp-Kosten (das Feld **Kundentarif** passt nur die Preise für Max- und Mini-KI-Aktionen an). Wenn Sie also WhatsApp weiterverkaufen, kalkulieren Sie diese Kosten in Ihre Pläne ein. SMS gehören nicht dazu: SMS laufen immer über ein Twilio-Konto, das Sie selbst verbinden, sodass Twilio Ihnen diese direkt in Rechnung stellt und keine Credits involviert sind. ### Was passiert, wenn das Guthaben eines Kunden Null erreicht Die Ausgaben eines Reselling-Kunden bleiben auf die von ihm gekauften Credits beschränkt, **solange sein monatliches Kontingent null ist**. Ohne Kontingent stoppt der KI-Bot für dieses Unterkonto in dem Moment, in dem das gekaufte Guthaben null erreicht **– er greift nicht auf Ihren Agentur-Pool zurück –** und der Kunde muss über Ihren Checkout einen neuen Plan oder ein Credit-Paket kaufen, um fortzufahren. Dies ist die harte Grenze, die verhindert, dass die Nutzung eines Kunden Ihr Agenturguthaben aufzehrt. Wenn für das Unterkonto noch ein **Monatliches Kontingent** festgelegt ist (siehe [Credit-Verwaltungsmodi](sub-accounts.md#credit-management-modes)), wird dieses Kontingent weiterhin jeden Monat bereitgestellt und genau wie im manuellen Modus aus Ihrem Pool verbraucht, sodass der Kunde auch nach Verbrauch seiner gekauften Credits weitermachen kann. Setzen Sie das Kontingent im **Bearbeiten**-Modal des Unterkontos auf null, wenn Sie das reine Pay-to-Play-Verhalten wünschen. (SMS werden Ihnen ohnehin direkt von Twilio in Rechnung gestellt, daher fallen hierfür keine Credit-Gebühren an.) ### Der Self-Service-Anmeldeprozess Das Ziel des Credit-Resellings ist, dass Sie Anmeldungen **nicht** manuell verwalten müssen. Der Ablauf sieht wie folgt aus: 1. Sie veröffentlichen einen Zahlungslink (in einer E-Mail, auf Ihrer Website, in einer Anzeige). 2. Ein neuer Kunde klickt darauf, bezahlt, und ein Unterkonto wird automatisch erstellt. (Wenn der Plan eine kostenlose Testversion beinhaltet, beginnt diese ohne Zahlung – die Abbuchung erfolgt automatisch, wenn die Testphase abläuft.) 3. Der Kunde erhält eine E-Mail mit den Anmeldedaten und einem temporären Passwort. 4. Er meldet sich an, durchläuft das Onboarding und kann von dort aus loslegen. Sie greifen nur ein, wenn Hilfe benötigt wird – Abrechnungsaufladungen, erneute Zahlungsversuche usw. laufen vollautomatisch. Es gibt drei Möglichkeiten, dies einzurichten: **Stripe** (empfohlen, vollständig integriert), **PayPal** (ebenfalls vollständig integriert und die übliche Lösung, wenn Stripe an Ihrem Standort nicht verfügbar ist) oder ein **benutzerdefinierter Zahlungsanbieter** (jedes andere System, das Sie bereits verwenden — erfordert etwas Integrationsaufwand). --- ### Credit-Reselling einrichten ::: master-only
Einrichtungsassistent für den SaaS-Modus, Schritt 1 von 5: Erstellen eines Stripe-Kontos, mit Schaltflächen für 'Stripe öffnen' und 'Ich habe ein Konto' sowie einer Alternative für einen benutzerdefinierten Zahlungsanbieter

Der Einrichtungsassistent für den SaaS-Modus (Schritt 1 von 5). Stripe ist der Standardweg; das Feld unten bietet den Weg über einen benutzerdefinierten Zahlungsanbieter, falls Stripe in Ihrem Land nicht verfügbar ist.

::: 1. Klicken Sie in der Hauptseitenleiste auf **SaaS-Modus**. 2. Wenn Sie zum ersten Mal hier sind, gelangen Sie zum Einrichtungsassistenten. Wählen Sie einen der drei Wege: - **Ich habe ein Konto / Stripe verbinden** — empfohlen. Siehe [Option 1: Stripe verbinden](#option-1-connect-stripe) unten. - **Stattdessen einen benutzerdefinierten Zahlungsanbieter verwenden** — für jeden anderen Zahlungsanbieter, den Sie selbst steuern möchten. Siehe [Option 2: Benutzerdefinierter Zahlungsanbieter](#option-2-custom-payment-provider) unten. - **Stattdessen PayPal verbinden** — wie Stripe integriert, wobei das Geld auf Ihrem PayPal-Geschäftskonto landet. Siehe [Option 3: PayPal verbinden](#option-3-connect-paypal) unten. > Stripe ist der Weg des geringsten Widerstands. Wenn Stripe in Ihrem Land nicht verfügbar ist oder Ihre Kunden einfach PayPal bevorzugen, verbinden Sie PayPal — es ist genauso integriert und erfordert keinen Integrationsaufwand. Behalten Sie den Weg über den benutzerdefinierten Zahlungsanbieter für ein Abrechnungssystem bei, das Sie bereits haben und behalten möchten (Mollie, Paddle, GoCardless, Ihr eigenes Backend usw.). Sie können Stripe und PayPal gleichzeitig verbinden. Ihre Kunden erhalten dann für jeden eine Schaltfläche und wählen die bevorzugte Methode aus. --- ### Option 1: Stripe verbinden Dies ist der empfohlene Weg. Die Plattform übernimmt den Checkout, die Kontoerstellung und die Bereitstellung der Credits für Sie – Sie müssen Stripe lediglich die Zugangsdaten geben. #### Schritt 1 – Einen eingeschränkten Stripe-API-Schlüssel erstellen 1. Im SaaS-Modus-Assistenten werden Sie nach Ihrem **Stripe Secret Key** gefragt. 2. Öffnen Sie Ihr Stripe-Dashboard in einem neuen Tab → **Entwickler** → **API-Schlüssel** → **Eingeschränkten Schlüssel erstellen**. 3. Geben Sie dem Schlüssel einen Namen (z. B. *DM Champ Reselling*) und erteilen Sie die folgenden Berechtigungen: - **Checkout-Sitzungen** → Schreiben - **Produkte** → Schreiben - **Preise** → Schreiben - **Abonnements** → Schreiben (kennzeichnet das Abonnement jedes Kunden, damit Verlängerungen – und die Umwandlung von kostenlosen Testversionen in kostenpflichtige Abonnements – dem richtigen Konto gutgeschrieben werden, und ermöglicht es der Plattform, eine Stufe für aktive Abonnenten zu prüfen, bevor Sie diese löschen) - **Kunden** → Schreiben, **Setup Intents** → Lesen und **Kundenportal** → Schreiben (wird verwendet, wenn ein Kunde eine Karte für die automatische Aufladung speichert oder sein Abonnement verwaltet) - **Konto** → Lesen - **Webhook-Endpunkte** → Schreiben (ermöglicht es der Plattform zu prüfen, ob Ihr Webhook mit den richtigen Ereignissen registriert ist, und diesen bei Bedarf für Sie zu korrigieren – siehe [Webhook-Integritätsprüfung](#webhook-health-check) unten) 4. Klicken Sie auf **Schlüssel erstellen** und kopieren Sie dann den Schlüssel. > **Bereits mit weniger Berechtigungen verbunden?** Sie benötigen keinen neuen Schlüssel. Öffnen Sie in Stripe **Entwickler → API-Schlüssel**, klicken Sie auf Ihren vorhandenen eingeschränkten Schlüssel, aktivieren Sie die fehlenden Berechtigungen und speichern Sie – die Plattform übernimmt diese bei der nächsten Anfrage. Das verräterische Anzeichen für einen Schlüssel, dem die **Abonnements**-Berechtigung fehlt, ist die Fehlermeldung *"Could not verify if this tier has active subscribers"*, wenn Sie versuchen, eine Preisstufe zu löschen. 5. Fügen Sie ihn in den Assistenten ein und klicken Sie auf **Speichern & Weiter**. #### Schritt 2 – Den Stripe-Webhook registrieren 1. Der Assistent zeigt Ihnen eine **Webhook-URL**. Kopieren Sie diese. 2. Gehen Sie in Stripe zu **Developers** → **Webhooks** → **Add endpoint**. 3. Fügen Sie die Webhook-URL als Ziel ein. 4. Wählen Sie für die Ereignisse **`checkout.session.completed`** (Erstkäufe), **`invoice.paid`** (Verlängerungen sowie die erste Abbuchung nach Ablauf einer kostenlosen Testphase – ohne diese wird die Verlängerung eines Kunden zwar in Stripe abgerechnet, aber dessen Guthaben nicht aufgefüllt), **`customer.subscription.updated`** (Tarifwechsel über das Stripe-Kundenportal – ohne diese behält ein Kunde, der ein Upgrade durchführt, sein altes Kontingent, bis Sie es manuell korrigieren) und **`customer.subscription.deleted`** (Kündigungen – ohne diese wird ein Kunde, der in Stripe kündigt, hier weiterhin als abonniert angezeigt). 5. Stripe zeigt ein **Signing Secret** für den neuen Webhook an. Kopieren Sie es, fügen Sie es in den Assistenten ein und klicken Sie dann auf **Save & Continue**. ##### Webhook-Integritätsprüfung Sobald Sie das Signaturgeheimnis speichern, und danach einmal täglich, verwendet die Plattform Ihren Stripe-Schlüssel, um zu überprüfen, ob Ihr Webhook-Endpunkt aktiviert ist und alle vier Ereignisse abonniert hat. Wenn Ereignisse fehlen und Ihr Schlüssel über die Berechtigung **Webhook Endpoints → Write** verfügt, werden diese automatisch für Sie hinzugefügt. Wenn die Plattform das Problem nicht beheben kann (kein Endpunkt gefunden, Endpunkt deaktiviert, der Schlüssel hat nicht die erforderliche Berechtigung oder Stripe lehnt den Schlüssel ab, weil er abgelaufen oder widerrufen wurde), zeigt das SaaS-Modus-Dashboard eine Warnung **"Webhook needs attention"** an, die Ihnen genau sagt, was zu tun ist. Beheben Sie dies umgehend: Während die Warnung angezeigt wird, werden die Verlängerungen Ihrer Kunden zwar weiterhin in Stripe abgerechnet, aber ihre Guthaben werden nicht aufgefüllt. #### Schritt 3 — Preisstufen einrichten 1. Definieren Sie die Kreditpakete, die Ihre Kunden kaufen können (bis zu 20 Stufen — z. B. *Starter — 1.000 Kredite / 29 $* , *Pro — 5.000 Kredite / 99 $*), und optional die Funktionen, die jede Stufe freischaltet. - **Benötigen Sie denselben Plan in zwei Abrechnungszyklen — sagen wir monatlich und jährlich?** Richten Sie ihn einmal ein und klicken Sie dann auf das **Duplizieren**-Symbol (neben dem Papierkorb-Symbol in der Stufe), anstatt ihn erneut zu erstellen. Die Kopie übernimmt alle Einstellungen des Originals — Kredite, Preis, Funktionen, Limits, Testversion — mit dem Zusatz *(Kopie)* im Namen, und ist noch nicht veröffentlicht: Stellen Sie die **Abrechnung** auf "Jährlich" um, passen Sie Preis und Bezeichnung an und speichern Sie. Dann erhält der Plan ein eigenes Stripe-Produkt und einen eigenen Preis. Die Kopie wird absichtlich immer am **Ende** Ihrer Planliste hinzugefügt: Ihre Zahlungslinks und der Einbettungscode verweisen auf Pläne anhand ihrer Position in der Liste (siehe [Schritt 4 — Ihre Zahlungslinks teilen](#step-4--share-your-payment-links)), sodass sich nichts, was Sie bereits auf Ihrer Website platziert haben, verschiebt. 2. Wählen Sie mit dem **Abrechnungs**-Auswahlfeld, wie der Plan abgerechnet wird: **Monatlich**, **Jährlich** oder **Alle N Wochen**. Bei "Monatlich" ändert sich nichts — der von Ihnen eingegebene Preis wird jeden Monat berechnet. Bei **Jährlich** ist der von Ihnen eingegebene Preis der Preis für ein **ganzes Jahr**, während das Feld **Kredite pro Monat** genau das bedeutet — die Kredite, die der Kunde **pro Monat** erhält. Also bedeutet *1.000 Kredite / 290 $ / Jährlich*, dass ein Kunde Ihnen einmal im Jahr 290 $ zahlt und jeden Monat 1.000 Kredite erhält. Ihr Kontingent wird Monat für Monat gewährt — der erste Monat beim Kauf, dann automatisch jeden Monat danach, wobei sich die Anzahl bei jeder jährlichen Verlängerung zurücksetzt — anstatt dass zwölf Monate an Krediten am ersten Tag gutgeschrieben werden. Das ist wichtig für Ihren Pool: Ein jährlicher Verkauf entnimmt nicht sofort Kredite für ein ganzes Jahr. Wenn der Kunde kündigt, enden die monatlichen Zuteilungen. **Alle N Wochen** ist für jeden anderen Rhythmus gedacht: Wählen Sie ihn aus und geben Sie die **Wochen zwischen Zahlungen** (1 bis 52) ein — *alle 4 Wochen* zum Beispiel, was 13 Zahlungen pro Jahr statt 12 bedeutet. Bei einem wöchentlichen Plan gelten Preis und Kredite **pro Abrechnungszeitraum**: Ein Plan mit *1.000 Krediten / 29 $ / alle 4 Wochen* berechnet alle vier Wochen 29 $ und gewährt alle vier Wochen 1.000 Kredite. Das Ändern des Abrechnungsrhythmus eines gespeicherten Plans erstellt einen neuen Preis in Ihrem Stripe, sodass bestehende Abonnenten bei dem bleiben, was sie abonniert haben. 3. Geben Sie dem Plan eine **kostenlose Testversion**, wenn Sie möchten. **Kostenlose Testversion (Tage)** akzeptiert Werte von 1 bis 90 — lassen Sie es auf **0** für keine Testversion — und **Testkredite** legt fest, mit wie vielen Krediten der Kunde beginnt (standardmäßig sind dies die monatlichen Kredite des Plans, und Sie können sie verringern — auf mindestens 1, da ein Testkonto ohne Kredite seine eigene Einrichtung nicht abschließen könnte). Mit einer eingerichteten Testversion wird einem neuen Kunden **bei der Anmeldung nichts berechnet**: Er erhält die Testkredite am ersten Tag und kann den Plan sofort nutzen. Wenn der Testzeitraum endet, berechnet Stripe automatisch den Planpreis und der Kunde wechselt ab dann zum vollen monatlichen Kontingent. Ein paar Dinge, die Sie beachten sollten: - **Testkredite stammen aus Ihrem Agentur-Pool**, genau wie alle anderen Plankredite. Eine großzügige Testversion für einen Plan, den Sie stark bewerben, ist ein echter Kostenfaktor, also legen Sie die Anzahl bewusst fest, anstatt sie auf dem vollen monatlichen Kontingent zu belassen. - **Eine Testversion ist für neue Anmeldungen.** Eine Anmeldung über Ihren Zahlungslink oder den eingebetteten Checkout erhält die Testversion genau wie im Plan konfiguriert. Ein Unterkonto, das bereits existiert — von Ihnen erstellt, zuvor abonniert oder bereits getestet — und über seine eigene Abrechnungsseite kauft, wird sofort belastet, ohne zweite Testversion. Ein Kunde, der während der Testphase kündigt, wird nie belastet und behält alle verbleibenden Testkredite. - **Karte oder keine Karte — Ihre Entscheidung.** Standardmäßig fragt die Testversion den Kunden bei der Anmeldung nach einer Karte, und Stripe belastet diese, wenn die Testversion endet. Deaktivieren Sie **Karte zur Testversion erforderlich**, und der Checkout überspringt die Karte vollständig: Der Kunde beginnt nur mit einer E-Mail-Adresse. Wenn er bis zum Ablauf der Testversion keine Karte hinzugefügt hat, endet der Plan einfach — sein Unterkonto wird als gekündigt markiert, es werden keine weiteren Kredite gewährt, und er behält die verbleibenden Testkredite. Eine Testversion ohne Karte konvertiert weniger automatisch als eine mit hinterlegter Karte, daher lohnt es sich, den Kunden daran zu erinnern, seine Karte vor dem Ende hinzuzufügen. - **Harter Ablauf nach Testversion — ungenutzte Kredite zurückfordern.** Neben dem Kartenschalter befindet sich **Harter Ablauf nach Testversion**: *Wenn die Testversion ohne Upgrade endet, fließen ungenutzte Testkredite zurück in Ihren Pool und das Konto des Kunden wird gesperrt, bis er ein Abonnement abschließt.* Lassen Sie es deaktiviert (Standard) und es ändert sich nichts gegenüber dem obigen Absatz — der Plan wird gekündigt, es werden keine weiteren Kredite gewährt, und der Kunde behält die verbleibenden Testkredite, sodass seine KI weiterhin antwortet, bis diese aufgebraucht sind. Schalten Sie es ein, und in dem Moment, in dem eine Testversion ohne Upgrade endet, fließen die ungenutzten Testkredite **zurück in Ihren Agentur-Pool** und das Konto des Kunden wird gesperrt: Senden und KI-Antworten stoppen und er sieht *"Ihre kostenlose Testversion ist abgelaufen. Kontaktieren Sie Ihren Anbieter, um fortzufahren."* Nur das, was er nicht ausgegeben hat, kommt zurück — eine Testversion, die er tatsächlich genutzt hat, kostet Sie das, was er verbraucht hat. Die Sperre hebt sich von selbst auf, sobald er einen Plan kauft, und Sie können sie selbst im **Bearbeiten**-Modal des Unterkontos aufheben oder ändern, indem Sie dieselben [Blockierungssteuerelemente](sub-accounts.md#blocking-pausing-a-sub-account) verwenden wie für einen Kunden, der mit Zahlungen in Verzug gerät. (Eine Sperre, die Sie bereits manuell platziert haben, wird davon nie berührt — Ihr Grund dafür hat Vorrang vor unserem.) Der harte Ablauf funktioniert sowohl bei Testversionen mit als auch ohne erforderliche Karte; bei einer Testversion ohne Karte weist der Checkout den Käufer im Voraus darauf hin, dass sein Plan **und** alle verbleibenden Testkredite nach der Testversion automatisch enden, es sei denn, er fügt eine Zahlungsmethode hinzu. 4. Die Gruppe **Kanäle** enthält das **Kanallimit** des Plans — eine Zahl, kein Umschalter, die genau wie Team-Plätze und das KI-Agenten-Limit funktioniert. Wählen Sie **Nicht festgelegt** (Standard — der Plan verwaltet die Anzahl nicht, also bleibt das, was das Konto bereits hat), **Unbegrenzt** oder **Benutzerdefiniert** mit der genauen Anzahl an Messaging-Kanälen, die Kunden in diesem Plan gleichzeitig verbunden haben können — einschließlich **0**, für Pläne, bei denen Sie die Kanäle selbst verbinden und verwalten. Das Limit wird angewendet, wenn ein Kunde abonniert, und bei jeder Verlängerung aktualisiert. Ein Limit, das Sie manuell für ein bestimmtes Unterkonto festgelegt haben (im Bearbeiten-Modal), wird durch eine Verlängerung nie überschrieben. Es steuert *wie viele* Kanäle, nicht *welche* — das ist die nächste Gruppe. Die Anzahl bezieht sich auf die **Verbindung**, nicht auf den Kanaltyp: Jede WhatsApp-Nummer belegt einen eigenen Slot (WhatsApp Web und Business API gleichermaßen), während Instagram und Messenger über dieselbe Meta-Seitenverbindung eingehen und zusammen einen einzigen Slot belegen. Ein Kunde, der sein Limit erreicht hat, sieht eine klare Meldung, wenn er versucht, einen weiteren Kanal zu verbinden; das erneute Verbinden eines bereits vorhandenen Kanals wird nie blockiert. 5. Innerhalb der Funktionsliste jeder Stufe finden Sie auch eine Gruppe **Kanaltypen**, die die Kanaltypen auflistet, die einem Kunden zugewiesen werden können — Chat-Widget, WhatsApp Business API, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, E-Mail, SMS und iMessage. Kanaltypen sind standardmäßig aktiviert, es sei denn, Sie deaktivieren einige, sodass Sie bestimmte Kanäle für höhere Stufen reservieren können — sagen wir, einen Starter-Plan nur mit Widget und WhatsApp Business API ab Ihrem Pro-Tier. Kunden in einer Stufe, die einen Kanal ausschließt, sehen ihn auf ihrer Kanalseite als gesperrt mit einem Hinweis auf ein Upgrade. 6. Die Funktionsliste enthält auch eine Gruppe **Team**, sodass jeder Plan sein eigenes Kontingent an Team-Plätzen definieren kann. Ein Auswahlfeld, **Team-Plätze**, entscheidet sowohl darüber, ob Kunden im Plan überhaupt Teammitglieder erhalten, als auch wie viele: Wählen Sie **Nicht enthalten** (Standard — Kunden in diesem Plan können keine Teamkollegen einladen), eine der Voreinstellungen (3 / 5 / 10 / Unbegrenzt) oder **Benutzerdefiniert** mit einer beliebigen genauen Anzahl — Starter mit 3 Plätzen, Professional mit 10, Enterprise unbegrenzt oder was auch immer zu Ihrer Preisgestaltung passt. Das Kontingent wird automatisch angewendet, wenn ein Kunde abonniert, und bei jeder Verlängerung aktualisiert, sodass pro Kunde nichts manuell eingestellt werden muss. Zwei Dinge, die Sie wissen sollten: **Nicht festgelegt** bedeutet, dass Teammitglieder enthalten sind, aber der Plan die Anzahl nicht verwaltet — das Platzlimit, das das Konto bereits hat, bleibt unverändert — und ein Platzlimit, das Sie manuell für ein bestimmtes Unterkonto festgelegt haben (im Bearbeiten-Modal oder über die API), wird durch eine Verlängerung nie überschrieben, sodass einmalige Ausnahmen Abrechnungszyklen überdauern. Es gibt auch eine Gruppe **Produktivität** (Aufgaben, Tägliche Zusammenfassungen, KI-Medienbibliothek), wenn Sie diese für höhere Pläne reservieren möchten. 7. Die Gruppe **Kontakte & KI-Agenten** enthält das **KI-Agenten-Limit** des Plans — eine Zahl, kein Umschalter, die genau wie Team-Plätze funktioniert. Wählen Sie **Nicht festgelegt** (Standard — der Plan verwaltet die Anzahl nicht, also bleibt das, was das Konto bereits hat), **Unbegrenzt** oder **Benutzerdefiniert** mit der genauen Anzahl an KI-Agenten, die Kunden in diesem Plan haben können — einschließlich **0**, für Pläne, bei denen Sie die Agenten selbst erstellen und verwalten und Kunden keine eigenen erstellen sollten. Das Limit wird angewendet, wenn ein Kunde abonniert, und bei jeder Verlängerung aktualisiert. Ein Limit, das Sie manuell für ein bestimmtes Unterkonto festgelegt haben (im Bearbeiten-Modal), wird durch eine Verlängerung nie überschrieben. Ein Kunde, der sein Limit erreicht hat, sieht eine klare Meldung, wenn er versucht, einen Agenten zu erstellen oder zu duplizieren; das Kopieren eines Agenten in ein Unterkonto von Ihrer Agenturseite aus wird dadurch nie blockiert. 8. Die Gruppe **Ungenutzte Kredite** entscheidet, was mit den übrig gebliebenen Krediten eines Kunden passiert, wenn der Plan verlängert wird. **Maximal behalten** gibt an, wie viele Monate Kontingent ein Kunde in diesem Plan übertragen darf: Bei jeder Verlängerung wird sein ungenutztes Guthaben auf maximal das so-und-so-fache des monatlichen Kontingents gekürzt, und dann kommen die neuen Kredite hinzu — `1` behält den Wert eines Monats, `0.5` einen halben Monat, `0` überträgt nichts. **Ungenutzte Kredite verfallen nach** ist eine Anzahl von Tagen: Kredite, die so lange ungenutzt geblieben sind, verfallen bei der ersten Verlängerung, nachdem sie dieses Alter erreicht haben. Da der Verbrauch immer zuerst von den ältesten Krediten abgezogen wird, verliert ein Kunde, der sein Kontingent jeden Monat nutzt, nie etwas. Lassen Sie beide Felder leer — der Standardwert und das, was jeder Plan, den Sie bereits verkaufen, beibehält — und nichts wird gedeckelt oder verfällt. Es lohnt sich, dies bei einem günstigen oder im Preis reduzierten Testplan festzulegen, bei dem ein Kunde, der das Produkt ansonsten kaum nutzt, ein Guthaben aufbaut, für das Ihr Pool aufkommen muss. Ein Wert, der für ein bestimmtes Unterkonto festgelegt wurde, hat Vorrang vor dem des Plans, sodass Sie immer noch eine Ausnahme für einen einzelnen Kunden machen können. Siehe [Deckelung der Übertragung](sub-accounts.md#capping-what-rolls-over). 9. Legen Sie den **Preis pro Kredit** fest — das ist es, was Kunden für Ad-hoc-Aufladungen zahlen. 10. Klicken Sie auf **Speichern & Weiter**. > **Kontakte sind eine Ja/Nein-Funktion, keine Zahl.** Die gleiche Gruppe **Kontakte & KI-Agenten** enthält **Unbegrenzte Kontakte** als einfaches Ein-/Aus-Element, und es gibt bewusst kein Feld, in das eine Kontaktanzahl eingegeben werden kann. Das Ausschalten führt nicht dazu, dass Sie ein Kontaktlimit festlegen können – lassen Sie es also eingeschaltet, es sei denn, Sie haben einen triftigen Grund dafür. Die drei Limits, die Sie als tatsächliche Zahl angeben können, sind **Kanallimit**, **KI-Agentenlimit** und **Team-Plätze**, jeweils mit den Optionen Nicht festgelegt / Unbegrenzt / Benutzerdefiniert. > **Es gibt kein tarifabhängiges Limit für Kampagnen oder Broadcasts.** Wenn Sie ein Starter-Paket klein halten möchten, sollten Sie die Anzahl der Agenten begrenzen – nutzen Sie dazu das oben genannte **KI-Agentenlimit**. > **Stufen sind Abonnements, keine einmaligen Käufe.** Jede Preisstufe ist ein wiederkehrendes Abonnement – das je nach **Abrechnungs**-Auswahlfeld jeden Monat, einmal im Jahr oder alle N Wochen berechnet wird – und läuft, bis der Kunde kündigt. Monatliche und jährliche Pläne gewähren das Kreditkontingent **jeden Monat**; ein Plan im Wochenrhythmus gewährt es **jeden Abrechnungszeitraum**. Verwenden Sie für einmalige Aufladungen stattdessen die Option für benutzerdefinierte Beträge pro Kredit. Da Stufen aktive Abonnements sind, kann eine Stufe, die noch aktive Abonnenten hat, nicht gelöscht werden – kündigen oder migrieren Sie diese Kunden zuerst. > ⚠️ **Die Funktionsliste der Stufe gewinnt bei jeder Verlängerung.** Wenn ein Kunde eine Stufe abonniert und bei jeder Verlängerung werden seine Funktionen genau auf das zurückgesetzt, was diese Stufe beinhaltet. Wenn Sie also für einen Kunden über **Unterkonto bearbeiten** eine zusätzliche Funktion aktivieren, fügen Sie diese auch seinem Tarif hinzu – andernfalls fällt sie bei der nächsten Verlängerung weg. (Benutzerdefinierte einmalige Credit-Käufe beeinflussen die Funktionen nicht.) #### Verkauf eines Plans über eine spezifische White-Label-Domain Wenn Sie mehr als eine [White-Label-Domain](white-labeling.md#up-to-three-white-labels) betreiben, erhält jede Stufe eine **Verkauft über**-Auswahl (diese erscheint erst, wenn Sie zwei oder mehr Domains haben). Belassen Sie die Einstellung auf **Hauptdomain**, dann ändert sich nichts. Wählen Sie eine Ihrer anderen Domains aus – zum Beispiel Ihre Lead-Finder-Domain – und: - Der **Checkout dieser Stufe übernimmt das Branding der Domain**, und nach der Bezahlung landet der Käufer auf dieser Domain, nicht auf Ihrer Hauptdomain. - Das Unterkonto des Käufers wird **automatisch dieser Domain zugewiesen**, sodass dessen E-Mails und Login-Branding vom ersten Tag an dieser folgen (dieselbe Zuweisung, die Sie manuell über die **White-Label**-Auswahl des Unterkontos festlegen können). - Kunden, die auf dieser Domain angemeldet sind, sehen auf ihrer Credits-Seite eine **Pläne**-Karte, die nur die dort verkauften Pläne mit einem Upgrade-Button auflistet – so kann ein Kunde auf Ihrer Lead-Finder-Domain ein Abonnement abschließen, ohne jemals Ihre Hauptmarke zu sehen. Pläne, die auf Ihrer Hauptdomain verkauft werden, erscheinen niemals auf Ihren anderen Domains und umgekehrt. Wenn Sie später [eine andere Domain zu Ihrer Hauptdomain machen](white-labeling.md#changing-which-domain-is-main), wird jeder Plan, der sich auf der **Hauptdomain** befand, an die Domain gebunden, auf der er tatsächlich verkauft wurde, sodass sich für die dort kaufenden Kunden nichts ändert. Sie gelangen auf einen **Alles bereit!**-Bildschirm mit einer Checkliste (Stripe-Konto verbunden, Preisstufen konfiguriert, Webhook registriert) und einem Tipp, mit der Testkarte von Stripe `4242 4242 4242 4242` zu testen. Von dort aus gelangen Sie über **Dashboard anzeigen** zum Dashboard des SaaS-Modus. #### Kunden, die den Tarif wechseln Wenn Sie Kunden erlauben, ihr Abonnement selbst über das Stripe-Kundenportal zu verwalten, können diese eigenständig zwischen Ihren Tarifen wechseln. Hier erfahren Sie, wie sich das auf deren Guthaben auswirkt. - **Upgrades mitten im Zyklus führen zu einer sofortigen Aufstockung.** Ein Kunde im Starter-Tarif (100 Credits pro Monat), der am 10. Tag zum Professional-Tarif (1.000 Credits pro Monat) wechselt, erhält sofort die Differenz – 900 Credits – und ab der nächsten Verlängerung die vollen 1.000 Credits. Stripe berechnet die Preisdifferenz für den Rest des Zeitraums; die Credits werden wie immer aus Ihrem Pool entnommen. - **Downgrades führen niemals zu einer Rückbuchung von Credits.** Was der Kunde bereits erhalten hat, bleibt bei ihm, und es fließt nichts in Ihren Pool zurück. Das geringere Kontingent gilt ab der nächsten Verlängerung. - **Mehrfaches Hin- und Herwechseln führt nicht zu einer doppelten Gutschrift.** Die Plattform merkt sich das höchste Kontingent, mit dem der aktuelle Zeitraum des Kunden bereits finanziert wurde. Ein Wechsel von Starter → Professional → Starter → Professional innerhalb eines Monats führt also nur einmal zur Gutschrift der 900 Credits Differenz, nicht zweimal. - **Tariffunktionen, Plätze und Limits folgen sofort dem neuen Tarif**, in beide Richtungen. Zwei Dinge, die Sie in Ihren Einstellungen für das Stripe-Kundenportal beachten sollten: - **Lassen Sie "Kunden können die Menge ändern" deaktiviert.** Die Menge multipliziert den Betrag, der dem Kunden berechnet wird, aber niemals die Credits, die er erhält – ein Kunde, der die Menge auf 3 setzt, zahlt den dreifachen Preis und erhält dennoch nur das Kontingent eines Tarifs. - **Das Planen von Downgrades zum Ende des Abrechnungszeitraums ist aus finanzieller Sicht die sinnvollste Standardeinstellung.** Ein Downgrade, das sofort wirksam wird, stuft den Kunden für einen Zeitraum, für den er bereits den höheren Preis gezahlt hat, in einen kleineren Tarif ein, und keine der bereits gewährten Credits fließen an Sie zurück. #### Schritt 4 — Teilen Sie Ihre Zahlungslinks Der Tab **Zahlungen** im Dashboard listet Ihre Zahlungslinks auf. Die Links verwenden die Domain, unter der Sie angemeldet sind: Öffnen Sie das Dashboard über `app.youraiconnector.com`, beginnen sie mit `app.youraiconnector.com`; melden Sie sich über Ihre eigene White-Label-Domain an, tragen sie stattdessen Ihre Domain – ein Hinweis unter den Links erinnert Sie daran. (Sie können den Domain-Teil einer kopierten URL auch einfach manuell austauschen.) Die Checkout-Seite selbst ist immer mit Ihrem Logo und Ihrer Marke als White-Label gestaltet. Auf demselben Tab finden Sie auch **Einbettungscode kopieren**, falls Sie die Preiskarten direkt auf Ihrer eigenen Website einbinden möchten. Schalten Sie Meta-Anzeigen? Der Einbettungscode leitet auch die Meta-Anzeigen-Klick-ID (`fbclid`) von Ihrer Seite an die Checkout-Buttons weiter, und ein einfacher Zahlungslink akzeptiert diese ebenfalls (`...&fbclid=...`). Zusammen mit einer **Meta-Pixel-ID** auf Ihrer White-Label-Domain ermöglicht dies Meta, die Registrierung der Anzeige zuzuordnen. Siehe [Tracking von Meta-Anzeigen-Conversions](white-labeling.md#tracking-meta-ads-conversions). Wenn Sie auch PayPal verbunden haben, enthält jeder Plan neben dem Stripe-Link einen PayPal-Link, und der Einbettungscode fügt jeder Preiskarte eine Schaltfläche pro verbundenem Zahlungsanbieter hinzu. Jeder Zahlungslink verweist auf einen Plan basierend auf seiner Position in Ihrer Planliste (der erste Plan ist `tier=0`, der zweite `tier=1` usw.). Wenn Sie einen Plan löschen, rücken die nachfolgenden Pläne um eine Position auf. Kopieren Sie daher nach dem Löschen eines Plans Ihre Links und den Einbettungscode erneut aus dem Tab „Zahlungen“. Andernfalls könnte eine Schaltfläche auf Ihrer Website auf den falschen Plan oder einen Plan verweisen, der nicht mehr existiert. Pläne werden Ihren Kunden in der Reihenfolge angezeigt, in der sie in Ihrer Planliste erscheinen. **Was Käufer an der Kasse eingeben können.** Neben der Karte fragt die Checkout-Seite von Stripe nach der E-Mail-Adresse, der Telefonnummer und der Rechnungsadresse des Käufers. Zudem bietet sie ein optionales Feld für den **Firmennamen** sowie ein Kontrollkästchen **„Ich kaufe als Unternehmen ein“**, über das Käufer ihre USt-IdNr. / Steuernummer hinzufügen können. Der Firmenname und die Steuernummer werden beim Kunden in Ihrem Stripe-Konto gespeichert, sodass Sie diese für Ihre eigene Rechnungsstellung verwenden können. Die Telefonnummer wird standardmäßig abgefragt, Sie können dies jedoch deaktivieren. Deaktivieren Sie auf dem Tab **Zahlungen** unter **Checkout-Felder** die Option **Telefonnummer beim Checkout abfragen**. Käufer müssen dann nur noch ihre E-Mail-Adresse, Kartendaten und Rechnungsadresse eingeben. Dies gilt sofort für Ihre Zahlungslinks und Ihren eingebetteten Checkout – Sie müssen nichts neu kopieren. Bei Konten, die sich mit deaktivierter Option registrieren, ist einfach keine Telefonnummer hinterlegt, was sich ansonsten nicht auf die Funktionsweise auswirkt. > ⚠️ **Löschen Sie nicht die Produkte, die die Plattform in Ihrem Stripe-Konto erstellt.** Wenn Sie Preisstufen einrichten, erstellt die Plattform automatisch passende Stripe-Produkte und -Preise. Wenn Sie diese in Stripe löschen, funktionieren Ihre Zahlungslinks nicht mehr. Verwalten Sie Ihre Preise über das SaaS-Modus-Dashboard, nicht innerhalb von Stripe. --- ### Option 2: Benutzerdefinierter Zahlungsanbieter Wählen Sie diesen Weg, wenn Stripe keine Option ist. Die Plattform stellt Ihnen ein einzelnes Webhook-URL-Feld zur Verfügung — für den Rest der technischen Anbindung sind Sie selbst verantwortlich. Es gibt **zwei** Dinge, die Sie selbst einrichten müssen: 1. **Erstanmeldung** — wenn ein neuer Kunde über Ihren Zahlungslink bezahlt, rufen Sie die API der Plattform auf, um das Unterkonto zu erstellen. 2. **Automatische Aufladungen** — wenn die Kredite eines Unterkontos zur Neige gehen, ruft die Plattform Ihren Webhook auf, damit Sie die Karte belasten und weitere Kredite gewähren können. #### Was Sie selbst erstellen müssen - **Produkte / Zahlungslinks** bei Ihrem eigenen Zahlungsanbieter (Stripe außerhalb von Stripe Connect, Mollie, Paddle, GoCardless, manuelle Rechnungsstellung usw.). - **Einen Workflow, der bei erfolgreicher Zahlung ausgeführt wird** und die API der Plattform aufruft, um: - Das Unterkonto zu erstellen ([POST `/v1/sub-accounts`](https://help.dmchamp.com/api/reference)). - Dem Kunden optional sein temporäres Passwort per E-Mail zu senden. - **Einen Workflow, der Webhooks für die automatische Aufladung** von der Plattform verarbeitet: Belasten Sie die gespeicherte Karte und rufen Sie dann die API der Plattform auf, um Kredite hinzuzufügen. Sie müssen dies nicht von Grund auf neu programmieren — Zapier, Make, n8n oder jedes andere Low-Code-Tool kann die REST-API der Plattform und die API Ihres Zahlungsanbieters nacheinander aufrufen. #### Schritt 1 — API-Referenz finden Die vollständige API-Dokumentation finden Sie unter **help.dmchamp.com → API Reference → Sub Accounts**. > Öffnen Sie `help.dmchamp.com` direkt und nicht Ihre White-Label-Dokumentations-URL. Die API-Referenz ist aus der White-Label-Dokumentation ausgefiltert, damit Ihre Kunden sie nicht sehen. Der Abschnitt „Sub Accounts“ zeigt den Endpunkt zum Erstellen von Unterkonten, die Antwortstruktur (einschließlich des temporären Passworts, das Sie in Ihrer Willkommens-E-Mail verwenden können) sowie die verfügbaren Feature-Flags, die Sie beim Erstellen eines Kontos übergeben können. #### Schritt 2 — Auto-Recharge-Webhook konfigurieren 1. Wählen Sie im SaaS-Modus-Assistenten **Stattdessen einen benutzerdefinierten Zahlungsanbieter verwenden**. 2. Geben Sie Ihre **Webhook-URL** ein – den Endpunkt auf Ihrem Server (oder Zapier / Make / n8n), der Ereignisse bei niedrigem Guthaben verarbeitet. 3. Klicken Sie auf **Test-Ereignis senden**, um zu überprüfen, ob der Endpunkt erreichbar ist. Das Ergebnisfeld zeigt den HTTP-Status, den Ihr Server zurückgegeben hat, die Round-Trip-Latenz, den Antworttext und die genaue JSON-Payload – so können Sie Ihren Handler von Anfang bis Ende testen und debuggen, ohne darauf warten zu müssen, dass bei einem echten Kunden das Guthaben knapp wird. Test-Ereignisse haben `test: true` in der Payload, sodass Ihr Server den Vorgang abbrechen kann, bevor jemandem etwas berechnet wird. 4. Klicken Sie auf **Webhook-URL speichern**. Sobald die Konfiguration abgeschlossen ist, geschieht Folgendes, wenn das Guthaben eines Unterkontos unter dessen Auto-Recharge-Schwelle fällt: - Die Plattform sendet eine Benachrichtigung an Ihre Webhook-URL mit den Details des Unterkontos und der Anzahl der benötigten Credits. - Ihr Server verarbeitet die Zahlung nach Ihren Wünschen (Belastung der Kreditkarte des Kunden, Rechnungserstellung, Abzug von einem Prepaid-Guthaben usw.). - Nachdem die Zahlung bestätigt wurde, ruft Ihr Server die API auf, um dem Unterkonto die Credits gutzuschreiben. Technische Details zum Webhook-Payload und API-Aufruf finden Sie unter [Sub-Account Auto-Recharge (Custom Payment Provider)](sub-account-auto-recharge.md). --- ### Option 3: PayPal verbinden Wählen Sie diesen Weg, wenn Stripe in Ihrem Land nicht verfügbar ist oder wenn Ihre Kunden lieber mit PayPal bezahlen möchten. Es ist genau wie Stripe integriert — die Plattform führt den Checkout durch, erstellt das Unterkonto und liefert die Kredite — und das Geld geht direkt auf **Ihr eigenes PayPal-Geschäftskonto**. Sie benötigen ein PayPal-Geschäftskonto, in dem eine REST-App erstellt wurde; es gibt nichts zu programmieren. Das Verbinden von PayPal ersetzt Stripe nicht. Wenn Sie beides haben, erhalten Ihre Kunden beide Schaltflächen, auf ihrer Abrechnungsseite und auf Ihren Preiskarten. #### Schritt 1 — Ihre PayPal-App verbinden 1. Wählen Sie im SaaS-Modus-Assistenten **Stattdessen PayPal verbinden**. 2. Öffnen Sie in einem neuen Tab Ihr PayPal-Entwickler-Dashboard und erstellen Sie eine **REST-App** in Ihrem Geschäftskonto. 3. Kopieren Sie die **Client-ID** und das **Secret** der App und fügen Sie sie in den Assistenten ein. 4. Wählen Sie die Umgebung: **Live** für echte Zahlungen oder **Sandbox**, wenn Sie den gesamten Ablauf zuerst mit PayPal-Testkäufern testen möchten. Die Client-ID und das Secret müssen aus derselben Umgebung stammen, die Sie auswählen, und Sandbox-Zahlungen sind kein echtes Geld — schalten Sie die Verbindung auf Live um, bevor Sie Ihre Links teilen. 5. Klicken Sie auf **Speichern & Weiter**. Die Plattform prüft die Anmeldeinformationen sofort bei PayPal; wenn PayPal sie ablehnt, wird nichts gespeichert und Sie können sie erneut einfügen. #### Schritt 2 — Den PayPal-Webhook registrieren Der Webhook ist der Weg, wie Ihr PayPal-Konto der Plattform mitteilt, dass eine Zahlung erfolgt ist, ein Abonnement verlängert wurde oder eine Zahlung erstattet wurde. Ohne ihn bezahlen Ihre Kunden zwar, aber ihre Kredite werden nicht geliefert. 1. Der Assistent zeigt Ihnen eine **Webhook-URL**. Kopieren Sie diese. 2. Fügen Sie in derselben PayPal REST-App einen Webhook mit dieser URL hinzu und abonnieren Sie ihn für folgende Ereignisse: - `CHECKOUT.ORDER.APPROVED` - `PAYMENT.CAPTURE.COMPLETED`, `PAYMENT.CAPTURE.DENIED`, `PAYMENT.CAPTURE.REFUNDED`, `PAYMENT.CAPTURE.REVERSED` - `PAYMENT.SALE.COMPLETED`, `PAYMENT.SALE.REFUNDED` - `BILLING.SUBSCRIPTION.ACTIVATED`, `BILLING.SUBSCRIPTION.CANCELLED`, `BILLING.SUBSCRIPTION.SUSPENDED`, `BILLING.SUBSCRIPTION.EXPIRED`, `BILLING.SUBSCRIPTION.PAYMENT.FAILED` - `VAULT.PAYMENT-TOKEN.DELETED` 3. PayPal weist dem neuen Webhook eine **ID** zu. Kopieren Sie diese, fügen Sie sie in den Assistenten ein und klicken Sie auf **Speichern**. Ihre Pläne bleiben in jedem Fall dieselben – richten Sie sie einmal wie in [Schritt 3 – Preiskategorien einrichten](#step-3--set-up-pricing-tiers) ein, und sie werden über alle von Ihnen verbundenen Zahlungsmethoden verkauft. #### Was Ihre Kunden sehen - **Aufladungen** – eine **Mit PayPal bezahlen**-Schaltfläche auf ihrer Abrechnungsseite, neben der Kartenoption, zum gleichen Preis pro Guthabenpunkt, den Sie festgelegt haben. - **Pläne** – jede Stufe erhält einen PayPal-Checkout-Link neben dem Stripe-Link auf der Registerkarte **Zahlungen**, und **Einbettungscode kopieren** generiert eine Schaltfläche pro verbundener Zahlungsmethode, sodass eine Preiskarte auf Ihrer Website Karte und PayPal nebeneinander anbieten kann. - **Automatische Aufladungen** – siehe unten. #### Automatische Aufladungen über PayPal Eine Einstellung, **Gebühr für automatische Aufladungen**, bestimmt, welche Ihrer verbundenen Methoden automatische Aufladungen abwickelt: Stripe, PayPal oder Ihr eigener Webhook. Nur eine davon kann dies gleichzeitig tun, selbst wenn Sie sowohl Stripe als auch PayPal verbunden haben – alles andere (manuelle Aufladungen, Plan-Checkout) bietet weiterhin beides an. Stellen Sie dies auf **PayPal** ein, und jeder Kunde verbindet sein eigenes PayPal-Konto einmalig über die Karte **Automatische Aufladung** auf seiner Abrechnungsseite. Von da an belastet die Plattform bei jedem Unterschreiten des Schwellenwerts das gespeicherte PayPal-Konto für die Aufladung zum festgelegten Preis pro Guthabenpunkt und stellt das Guthaben automatisch bereit, genau wie beim Stripe-Karten-Ablauf. Ein Kunde, der PayPal noch nicht verbunden hat, wird einfach nicht belastet – sein Guthaben läuft aus, bis er ein Konto verbindet oder manuell Guthaben kauft. Wenn PayPal eine Zahlung ablehnt, wird kein Guthaben bereitgestellt und die Plattform versucht es beim nächsten Unterschreiten des Schwellenwerts erneut. Kunden können ihr PayPal-Konto jederzeit über dieselbe Karte entfernen. Wenn Sie PayPal später im SaaS-Modus trennen und es für automatische Aufladungen zuständig war, wird auf Stripe zurückgegriffen, falls verbunden, oder auf Ihren eigenen Webhook, falls konfiguriert. #### Gut zu wissen über PayPal - **Ein Plan fragt den Kunden immer nach einem PayPal-Konto, selbst bei einer kostenlosen Testversion.** Testversionen funktionieren weiterhin – es wird erst etwas berechnet, wenn die Testphase endet –, aber PayPal erfordert, dass der Käufer vorab mit einem Konto zustimmt. Daher hat der Schalter **Karte für Testbeginn erforderlich** bei einem PayPal-Checkout keine Auswirkungen. Wenn Sie auf Testversionen ohne Kontobindung angewiesen sind, verkaufen Sie diesen Plan über Stripe. - **Preise werden exakt wie festgelegt berechnet.** PayPal fügt beim Checkout keine separate Steuerzeile hinzu, daher sollten Sie anfallende Steuern in den Preis Ihrer Pläne und den Preis pro Guthabenpunkt einrechnen. - **Ein Planwechsel bedeutet Kündigung und erneutes Abonnement.** Ein Kunde mit einem PayPal-Abonnement kann nicht direkt in eine andere Stufe wechseln: Er kündigt den aktuellen Plan und kauft den neuen Plan über dessen eigenen Link. (Kunden, die per Karte zahlen, können weiterhin im Stripe-Kundenportal wechseln – siehe [Kunden wechseln Pläne](#clients-switching-plans).) - **Eine Rückerstattung nimmt das Guthaben nicht zurück.** Wenn Sie eine PayPal-Zahlung von Ihrem PayPal-Konto erstatten, wird die Rückerstattung hier protokolliert, aber bereits bereitgestelltes Guthaben verbleibt auf dem Kontostand des Kunden – genau wie bei Stripe. --- ### Preiskonfiguration - **Preiskategorien** – definieren Sie Guthabenpakete, die Ihre Kunden erwerben können (bis zu 10, z. B. "Starter-Paket: 100 Guthabenpunkte für 15 $"), konfiguriert auf der Registerkarte **Pläne** im SaaS-Modus. Jeder Plan wird **monatlich, jährlich oder alle N Wochen** abgerechnet (ein jährlicher Preis gewährt das Guthaben weiterhin monatlich; ein wöchentlicher Plan gewährt es pro Abrechnungszeitraum) und kann eine **kostenlose Testversion** von 1–90 Tagen mit eigenem Testguthaben enthalten, mit oder ohne Abfrage einer Karte vorab und mit oder ohne **harte Ablaufzeit** (ungenutztes Testguthaben zurück in Ihren Pool, Konto gesperrt, wenn die Testphase ohne Upgrade endet). Siehe [Schritt 3 – Preiskategorien einrichten](#step-3--set-up-pricing-tiers). Jeder Plan erhält seinen eigenen Zahlungslink auf der Registerkarte **Zahlungen** – einen Stripe-Link, einen PayPal-Link oder beides, je nachdem, was Sie verbunden haben. Jeder Plan kann auch begrenzen, was ein Kunde zwischen Verlängerungen mitnimmt: Die Gruppe **Ungenutztes Guthaben** legt **Maximal behalten** (Monate des Kontingents) und **Ungenutztes Guthaben verfallen nach** (Tage) fest, angewendet auf jeden Kunden des Plans – siehe [Begrenzung der Übertragung](sub-accounts.md#capping-what-rolls-over). Sie können dies auch über Code verwalten – siehe [Preiskategorien über die API verwalten](api-for-agencies.md#manage-your-pricing-tiers-over-the-api). - **Preis pro Guthabenpunkt** – legen Sie einen benutzerdefinierten Preis pro Guthabenpunkt für flexible Aufladungen fest. Benutzerdefinierte (ad-hoc) Guthabenkäufe müssen zwischen 10 und 10.000 Guthabenpunkten pro Transaktion liegen. Plan-Abonnements decken feste Beträge ab; der benutzerdefinierte Betrag deckt alles dazwischen ab. Eine optionale **Notiz** (bis zu 200 Zeichen) wird den Kunden direkt unter dem Preis auf ihrer Abrechnungsseite angezeigt – nützlich, wenn Sie in einer Währung bepreisen, aber in einer anderen abrechnen, z. B. *"0,25 USD pro Guthabenpunkt zu unserem Referenzkurs"*. Der Preis und die Notiz können auch über Code gelesen und geändert werden – siehe [Preis pro Guthabenpunkt über die API festlegen](api-for-agencies.md#set-your-per-credit-price-over-the-api). - **Mindestpreis für Guthaben** – die Plattform erzwingt einen Mindestpreis pro Guthabenpunkt, um die Nachhaltigkeit der Plattform zu gewährleisten. Sie können Ihren Preis auf oder über diesem Minimum festlegen. ### Kredit-Dashboard für Unterkonten Die **Details zur Credit-Nutzung** jedes Unterkontos (über das Zeilenmenü **Mehr** auf der Unterkonten-Seite) zeigen: - Gekaufte Credits und Gesamtausgaben - Verbrauchte Credits und verbleibendes Guthaben - Nutzungstrends im Zeitverlauf, aufgeschlüsselt nach Grund und nach Top-Kampagnen > **Was das Dashboard anzeigt.** Wenn ein Unterkonto den API-Schlüssel Ihrer Agentur verwendet, zeigt das Dashboard dessen Kreditverbrauch an, verbirgt jedoch die zugrunde liegenden Dollar-Kosten. Die Nutzungssummen zählen nur die tatsächlich verbrauchten Credits – Werbeboni, monatliche Verlängerungen und Plananpassungen sind ausgeschlossen, sodass die Zahl der „verbrauchten Credits“ die tatsächliche Aktivität widerspiegelt. --- ## Kampagnen in Unterkonten kopieren Sie können eine bewährte Kampagne aus Ihrem Agentur-Konto (oder einem beliebigen Unterkonto) in ein oder mehrere Unterkonten gleichzeitig kopieren – die Bot-Einrichtung, die Begrüßungsnachricht, FAQs und Wissensdatenbank, benutzerdefinierte Funktionen sowie Medien werden übernommen, sodass Sie diese nicht manuell neu erstellen müssen. Die Kopie wird als Entwurf angelegt, und einige kontospezifische Elemente (WhatsApp-Vorlagen, Kanäle und Telefonnummern, Kontaktlisten) müssen in jedem Unterkonto neu konfiguriert werden. Starten Sie auf der Seite **Sub Accounts** – öffnen Sie das **Mehr**-Menü einer Zeile und wählen Sie **Kampagne hierher kopieren**. Um stattdessen einen KI-Agenten zu kopieren, verwenden Sie **Agent hierher kopieren** im selben Menü oder das Symbol **Diesen Agenten in ein Unterkonto kopieren** in der Zeile des Agenten auf der Seite **KI-Agenten**. Um einem Kunden ein komplettes Setup auf einmal anstatt nur eines einzelnen Agenten zu übergeben, verwenden Sie einen **Snapshot** – siehe [Snapshots](snapshots.md). Für eine vollständige Schritt-für-Schritt-Anleitung sowie Informationen darüber, was kopiert wird und was neu konfiguriert werden muss, lesen Sie [Kampagne in ein Unterkonto kopieren](sub-accounts.md#copy-a-campaign-to-a-sub-account). --- ## Anmeldemodus (als Unterkonto agieren) Sie können direkt von Ihrem Agentur-Konto aus auf das Dashboard eines Unterkontos zugreifen, als wären Sie der Kunde. Dies ist dieselbe Funktion, die auf manchen Plattformen als „Assist“ oder „Impersonate“ bezeichnet wird – hier heißt die Aktion **Als Benutzer anmelden**. 1. Klicken Sie in der Seitenleiste auf **Unterkonten**. 2. Suchen Sie das Unterkonto in der Liste. Klicken Sie in dieser Zeile auf das **Mehr**-Menü (Drei-Punkte-Symbol ganz rechts). 3. Klicken Sie auf **Als Benutzer anmelden**. 4. Das Dashboard wird als dieses Unterkonto neu geladen – Sie haben vollen Zugriff auf deren Kampagnen, Kontakte, Chats und Einstellungen. 5. Wenn Sie fertig sind, klicken Sie oben in der Seitenleiste auf das bernsteinfarbene Feld **Assisting: ** und wählen Sie **Zurück zu meiner Agentur**. Dies ist besonders nützlich, um Kunden praktische Unterstützung zu bieten, ohne sie nach ihren Anmeldedaten fragen zu müssen. --- ## Funktionen von Unterkonten verwalten Je nach Ihrem Agentur-Tarif können Sie steuern, auf welche Funktionen jedes Unterkonto Zugriff hat. Die Zuweisung von Funktionen erfolgt pro Unterkonto und über Ihre Preisstufen. Über das **Bearbeiten**-Fenster eines Unterkontos können Sie dieses individuell anpassen: Legen Sie fest, welche Funktionen verfügbar sind, blenden Sie bestimmte Seiten aus dem Seitenmenü und den Einstellungen aus, wählen Sie aus, wer Benachrichtigungs-E-Mails erhält (siehe [Benachrichtigungs-Routing](sub-accounts.md#notification-routing)), legen Sie ein monatliches Limit für die Ausgaben über eigene API-Schlüssel fest und aktivieren oder deaktivieren Sie die Max AI-Stufe. Der Funktions-Editor enthält eine Gruppe **Kanaltypen**, die entscheidet, welche Messaging-Kanäle der Kunde verbinden kann — Chat-Widget, WhatsApp Business API, WhatsApp Web, Instagram, Facebook Messenger, Telegram, LINE, Viber, E-Mail, SMS und iMessage. Kanaltypen sind standardmäßig aktiviert, es sei denn, Sie deaktivieren einige; ein Kanal, den Sie deaktiviert haben, wird auf der Kanäle-Seite des Kunden als gesperrt angezeigt, mit dem Hinweis, dass er in seinem aktuellen Plan nicht enthalten ist. > **Wenn sich der Kunde in einem kostenpflichtigen Tarif befindet, fügen Sie die Funktion auch dem Tarif hinzu.** Die hier festgelegten Umschalter werden bei jeder Erneuerung des Abonnements des Kunden durch die eigene Funktionsliste des Tarifs ersetzt. Verwenden Sie das **Bearbeiten**-Modal für einmalige Anpassungen und den Preistarif für alles, was der Kunde behalten soll. > **Max AI-Stufe und Ihr eigener API-Schlüssel.** Wenn Ihre Agentur mit einem eigenen API-Schlüssel arbeitet, ändert die Aktivierung von Max für einen Kunden dessen KI-Nutzung von „kostenlos über Ihren Schlüssel“ auf 0,25 Credits pro Aktion, die Ihrem Agentur-Pool in Rechnung gestellt werden. Dasselbe gilt für die **Mini**-Stufe, die mit Max geliefert wird – sie läuft ebenfalls über unsere Infrastruktur mit 0,15 Credits pro Aktion und niemals über Ihren Schlüssel. --- ## Benötigen Sie Hilfe? If you have questions about agency accounts or sub-account management, reach out via our [email support](mailto:hi@dmchamp.com).