Häufig gestellte Fragen

Wie werde ich Reseller?

Kontaktiere deinen Ansprechpartner oder schreib eine E-Mail an [email protected], um Reseller-Zugang zu beantragen. Sobald dein Vertrag unterschrieben ist, kannst du Teams über die API und das Dashboard erstellen und verwalten. Die Stufen findest du unter Preise & Vertragsbedingungen.

Wie lauten die Vertragsbedingungen?

Eine Mindestlaufzeit von zwölf Monaten, zahlbar monatlich zum Listenpreis oder ein Jahr im Voraus für 10 % weniger: eine monatliche Grundgebühr mit Monitor-Kontingent, alles darüber zum Tarifpreis, taggenau anteilig. Der erste Monat ist gratis. Die Verlängerung richtet sich nach deiner Zahlungsweise und erfolgt automatisch. Kündigen kannst du, sobald die zwölf Monate erfüllt sind -- vorher nicht -- ohne Kündigungsfrist, jederzeit bis zum Tag vor der nächsten Verlängerung, wirksam zum Ende des bereits bezahlten Zeitraums. Die Zahlen stehen unter Preise & Vertragsbedingungen.

Kann ich meine Stufe während der Vertragslaufzeit upgraden?

Ja. Upgrades gelten sofort und werden anteilig für die verbleibende Laufzeit berechnet. Downgrades werden zum nächsten Verlängerungstermin wirksam. Abgerechnet wird immer die günstigste Stufe für dein tatsächliches Volumen -- über ein Kontingent hinauszuwachsen kostet nie mehr als die nächste Stufe.

Wie werden Daten zwischen Teams isoliert?

Die Daten jedes Teams sind auf Infrastrukturebene vollständig isoliert. Jede API-Anfrage ist auf den Kontext des authentifizierten Teams beschränkt und Teams können nicht auf die Daten anderer Teams zugreifen — auch nicht im Falle von Anwendungsfehlern.

Was passiert, wenn ich ein Team lösche?

Das Team wird soft-gelöscht mit einer 30-tägigen Schonfrist. In dieser Zeit kannst du es über POST /reseller/managed-teams/{id}/restore oder das Dashboard wiederherstellen. Nach 30 Tagen werden das Team und alle zugehörigen Daten dauerhaft gelöscht: Monitore, Vorfälle, Check-Ergebnisse, Benachrichtigungskanäle, Benachrichtigungsregeln, Benutzer und Statusseiten. Das Löschen erfordert die Bestätigung des Teamnamens im Request-Body (confirm_name-Feld).

Kann ich ein Team an einen anderen Reseller übertragen?

Nicht über die Reseller-API. Kontaktiere den Support für eine Neuzuweisung.

Wie richte ich Webhook-Benachrichtigungen ein?

1. Erstelle einen Benachrichtigungskanal vom Typ webhook mit deiner Endpunkt-URL
2. Erstelle eine Benachrichtigungsregel für die gewünschten Events (z.B. team.provisioned, incident.created, email.password_reset)
3. Siehe Webhooks für detaillierte Anleitungen, Event-Typen und Payload-Beispiele

Wie hoch sind die Rate-Limits?

Reseller-API-Endpunkte sind auf 120 Anfragen pro Minute pro Token limitiert. Der Authentifizierungs-Endpunkt hat ein strengeres Limit. Bei Überschreitung erhältst du eine 429-Antwort mit einem Retry-After-Header.

Rate-Limits gelten pro Token, nicht pro Team-Kontext — das Impersonieren mehrerer Teams erhöht dein Kontingent nicht.

Können Team-Benutzer sehen, dass sie von einem Reseller verwaltet werden?

Nein. Team-Benutzer sehen ein normales Konto und wissen nichts von der Reseller-Beziehung. Mit White-Label-Branding erscheint das gesamte Erlebnis unter deiner eigenen Marke.

Wie ändere ich den Plan eines Teams?

Verwende PATCH /reseller/managed-teams/{id} mit {"plan": "pro"} oder bearbeite das Team im Dashboard. Verfügbare Pläne sind free, hobby, starter und pro.

Kann ich meinen Teams Testphasen anbieten?

Ja. Beim Erstellen eines verwalteten Teams kannst du trial_days (1-365) angeben, um das Team mit einer Testphase zu starten. Du kannst auch trial_days und trial_plan in deinen Portal-Registrierungsstandards konfigurieren, damit Self-Service-Anmeldungen automatisch eine Testphase erhalten.

Wenn eine Testphase abläuft, wird der Plan des Teams auf free zurückgesetzt und du erhältst einen team.trial_expired-Webhook. Du erhältst auch team.trial_ending-Webhooks 3 Tage und 1 Tag vor Ablauf, damit du deine Kunden benachrichtigen kannst.

Du kannst Testphasen über PATCH /reseller/managed-teams/{id} mit trial_days verwalten (neue Testphase setzen oder 0 zum Aufheben).

Wie verfolge ich die Nutzung für die Abrechnung?

Verwende GET /reseller/managed-teams/{id}/usage?period=YYYY-MM, um Monitor-Zahlen, Check-Zahlen, API-Anfragen, gesendete Benachrichtigungen und Webhook-Zustellungen für einen bestimmten Monat abzurufen. Standard ist der aktuelle Monat.

Kann ich Monitore im Konto eines Teams erstellen?

Ja. Setze den X-Tenant-Id-Header auf die tenant_id des Teams und verwende die Standard-Monitor-API. Siehe Impersonation für Details. Auf diese Weise erstellte Monitore sind nicht von Monitoren zu unterscheiden, die von den eigenen Benutzern des Teams erstellt wurden.

Kann ich Benachrichtigungen white-labeln?

Ja. Verwende die Branding-API (PATCH /branding), um Alert-Prefix, Markenname, Logos, Footer-Text und mehr anzupassen. Alle Benachrichtigungskanäle verwenden dein individuelles Branding. Siehe API-Referenz — Branding.

Kann ich E-Mails von meiner eigenen Domain senden?

Ja, mit der Custom-SMTP-Funktion. Konfiguriere deinen SMTP-Server über PATCH /smtp-config und alle Benachrichtigungs-E-Mails werden über deinen SMTP-Server versendet. Siehe API-Referenz — Custom SMTP.

Kann ich Plattform-E-Mails unterdrücken und selbst versenden?

Ja. Verwende die E-Mail-Unterdrückungsfunktion, um bestimmte Plattform-E-Mails für alle verwalteten Teams zu deaktivieren. Wenn eine unterdrückte E-Mail normalerweise gesendet würde, feuert Hoppla einen email.*-Webhook mit dem vollständigen E-Mail-Payload (Empfänger, Template-Daten, Aktions-URLs), damit du die E-Mail selbst versenden kannst. Siehe Webhooks — E-Mail-Unterdrückung.

Was passiert, wenn mein Custom SMTP fehlschlägt?

Wenn dein SMTP-Server nicht erreichbar ist, fällt Hoppla automatisch auf den Standard-Mailer zurück. Deine Endbenutzer erhalten ihre Benachrichtigungen weiterhin.

Kann ich "Powered by Hoppla" aus E-Mails entfernen?

Ja. Setze hide_powered_by: true in den Branding-Einstellungen. Dies erfordert die White-Label-Branding-Funktion.