Übersicht über die Einstellungen – Konfigurieren Sie Pläne, Profile, Integrationen und Webhooks

Erfahren Sie, wie Sie Ihre Perkstar-Kontoeinstellungen konfigurieren. Vollständiger Leitfaden zum Verwalten von Abonnementplänen, zum Aktualisieren persönlicher Daten, zum Verbinden von Drittanbieter-Integrationen, zum Einrichten von Webhooks und zum Steuern kontoweiter Konfigurationen.

Übersicht

Das Modul „Einstellungen“ ist Ihre zentrale Anlaufstelle für die Konfiguration Ihres Perkstar-Kontos, die Verwaltung Ihres Profils und die Steuerung der Integration Ihrer Treueplattform mit anderen Tools. Hier verwalten Sie alles von Ihrem Abonnementplan bis hin zu persönlichen Daten, Integrationen von Drittanbietern und erweiterten Webhook-Konfigurationen.

Was Sie in den Einstellungen tun können:

  • Zeigen Sie Ihren Abonnementplan und Ihre Abrechnung an und verwalten Sie sie

  • Aktualisieren Sie persönliche Daten und Kontoanmeldeinformationen

  • Konfigurieren Sie Integrationen mit Diensten von Drittanbietern

  • Richten Sie Webhooks für benutzerdefinierte Integrationen und Automatisierung ein

  • Kontrollieren Sie kontoweite Präferenzen und Konfigurationen

Tipp: Richtig konfigurierte Einstellungen stellen sicher, dass Ihr Konto reibungslos funktioniert, sicher bleibt und sich effektiv in Ihre vorhandenen Geschäftstools integrieren lässt. Egal, ob Sie Ihren Plan aktualisieren, externe Dienste verbinden oder Ihr Profil anpassen, mit dem Modul „Einstellungen“ haben Sie die vollständige Kontrolle über Ihr Perkstar-Erlebnis.

Wer sollte die Einstellungen verwalten:

  • Kontoinhaber: Voller Zugriff auf alle Einstellungsregisterkarten

  • Administratoren: Zugriff auf die meisten Einstellungen (Planänderungen können eingeschränkt sein)

  • Mitarbeiterbenutzer: Begrenzter Zugriff je nach Berechtigungen

Bevor Sie beginnen

Anforderungen:

  • Aktives Perkstar-Konto

  • Kontoinhaber- oder Administratorberechtigungen für die meisten Einstellungen

  • Status des Kontoinhabers für Planänderungen und Abrechnungseinstellungen

Was Sie brauchen:

Halten Sie je nachdem, welche Einstellungen Sie konfigurieren, Folgendes bereit:

  • Zahlungsinformationen (für Plan-Upgrades)

  • API-Schlüssel oder Anmeldeinformationen (für Integrationen)

  • Webhook-URLs (für benutzerdefinierte Integrationen)

  • Aktualisierte Unternehmensinformationen (für Profiländerungen)

Einstellungskategorien verstehen

Infos: Das Modul „Einstellungen“ ist in vier Registerkarten unterteilt, die jeweils einen anderen Aspekt Ihres Kontos verwalten: Plan, persönliche Einstellungen, Integrationen und Webhooks.

Tab-Übersicht:

  • Planen: Abonnementdetails, Abrechnung und Kontokapazität

  • Persönliche Einstellungen: Ihr Profil, Kontaktinformationen und Präferenzen

  • Integrationen: Dienstverbindungen von Drittanbietern

  • Webhooks: Benutzerdefinierte Integrationen und automatisierte Datenübertragungen

Zugriff auf das Einstellungsmodul

So navigieren Sie zu den Einstellungen

Vom Bedienoberfläche aus:

  1. Melden Sie sich bei Ihrem Perkstar-Konto an

  2. Sehen Sie sich das Menü auf der linken Seite (Navigationsseitenleiste) an.

  3. Klicken Sie auf das Symbol ⚙️ Einstellungen

Hinweis: Das Modul „Einstellungen“ wird geöffnet und die Registerkarte „Plan“ wird standardmäßig angezeigt.

Layout des Einstellungsmoduls

Sobald Sie sich in den Einstellungen befinden, sehen Sie Folgendes:

  • Oben vier Registerkarten: Plan, Persönliche Einstellungen, Integrationen, Webhooks

  • Der Inhalt der aktiven Registerkarte wird unten angezeigt

  • Gegebenenfalls Schaltflächen zum Speichern (variiert je nach Registerkarte)

Infos: Klicken Sie auf eine beliebige Registerkarte, um zwischen verschiedenen Einstellungskategorien zu wechseln. Änderungen, die in einer Registerkarte vorgenommen werden, wirken sich nicht auf andere Registerkarten aus.

Registerkarte „Plan“.

Was diese Registerkarte abdeckt

Auf der Registerkarte „Plan“ werden Ihre aktuellen Abonnementinformationen, Rechnungsdetails und Kontokapazitätsgrenzen angezeigt. Hier überwachen Sie Ihre Nutzung und können Ihren Plan upgraden oder downgraden, wenn sich Ihre Geschäftsanforderungen ändern.

Angezeigte Informationen

Aktuelle Plandetails:

  • Planname (Starter, Professional, Business usw.)

  • Monatlicher oder jährlicher Abrechnungszyklus

  • Verlängerungsdatum

  • Zahlungsmethode hinterlegt

Kontokapazität:

  • Anzahl der Treuekarten, die Sie erstellen können

  • Grenzen der Kundendatenbank

  • Anzahl der Standorte, die Sie hinzufügen können (für Geo-Push)

  • Beschränkungen für Mitarbeiter/Unterkonten

  • Funktionszugriff basierend auf der Planstufe

Nutzungsmetriken:

  • Aktuelle Anzahl aktiver Karten

  • Gesamtzahl der Kunden in der Datenbank

  • Standorte konfiguriert

  • Weitere planspezifische Beschränkungen und aktuelle Nutzung

Allgemeine Aktionen in der Registerkarte „Plan“.

Upgrade Ihres Plans:

  1. Überprüfen Sie die verfügbaren Pläne und Funktionen

  2. Klicken Sie auf die Schaltfläche „Upgrade“ (falls verfügbar).

  3. Wählen Sie Ihre neue Planstufe aus

  4. Bestätigen Sie die Rechnungsdetails

  5. Vollständige Zahlung

Downgrade Ihres Plans:

  1. Klicken Sie auf die Option Plan ändern

  2. Wählen Sie einen Plan der niedrigeren Stufe

  3. Überprüfen Sie, welche Funktionen Sie verlieren werden

  4. Bestätigen Sie das Downgrade

Hinweis: Änderungen werden normalerweise im nächsten Abrechnungszeitraum wirksam.

Zahlungsinformationen aktualisieren:

  1. Klicken Sie auf „Zahlungsmethode aktualisieren“ oder eine ähnliche Option

  2. Geben Sie neue Kreditkarten- oder Zahlungsdaten ein

  3. Änderungen speichern

  4. Überprüfen Sie die erfolgreiche Aktualisierung

Wichtige Überlegungen zum Plan

Vor dem Upgrade:

  • Überprüfen Sie, welche neuen Funktionen Sie erhalten

  • Verstehen Sie, wie sich die Preise ändern (anteilig im Vergleich zum nächsten Zyklus)

  • Prüfen Sie, ob Ihre aktuellen Karten und Kunden innerhalb der neuen Grenzen liegen

Vor dem Downgrade:

  • Stellen Sie sicher, dass Ihre aktuelle Nutzung innerhalb der unteren Plangrenzen liegt

  • Verstehen Sie, auf welche Funktionen Sie keinen Zugriff mehr haben

  • Exportieren Sie alle Daten, auf die Sie möglicherweise keinen Zugriff mehr haben

  • Berücksichtigen Sie den Zeitpunkt (Herabstufung bei Verlängerung, um anteilige Gebühren zu vermeiden)

Kapazitätsgrenzen:

  • Wenn Sie die Grenzen Ihres Plans überschreiten, müssen Sie möglicherweise ein Upgrade durchführen

  • Einige Funktionen (z. B. zusätzliche Standorte) können separat erworben werden

  • Wenden Sie sich an den Support, wenn Sie benutzerdefinierte Limits benötigen, die über die Standardpläne hinausgehen

Registerkarte „Persönliche Einstellungen“.

Was diese Registerkarte abdeckt

Auf der Registerkarte „Persönliche Einstellungen“ werden Ihre individuellen Profilinformationen, Kontaktdaten, Anmeldeinformationen und persönlichen Präferenzen verwaltet. Dies ist Ihre Kontoidentität innerhalb der Perkstar-Plattform.

Einstellungen, die Sie konfigurieren können

Profilinformationen:

  • Vollständiger Name

  • Firmenname oder Firma

  • elektronische Post-Adresse

  • Telefonnummer

  • Profilfoto (falls unterstützt)

Anmeldedaten:

  • Passwort ändern

  • elektronische Post-Adresse aktualisieren (betrifft die Anmeldung)

  • Aktivieren Sie die Zwei-Faktor-Authentifizierung (falls verfügbar).

Sprache und Lokalisierung:

  • Bevorzugte Sprache der Benutzeroberfläche

  • Einstellungen für das Datumsformat

  • Zeitzoneneinstellungen

  • Währungsanzeige

Benachrichtigungseinstellungen:

  • elektronische Post-Benachrichtigungen für Kontoaktivitäten

  • Wöchentliche elektronische Post mit Statistikberichten

  • Systemwarnungen und Updates

  • Einwilligung/out für Marketingkommunikation

Unternehmensinformationen:

  • Geschäftsadresse

  • Steueridentifikationsnummern (falls zutreffend)

  • Branche oder Geschäftstyp

  • Kontaktpräferenzen

Persönliche Informationen aktualisieren

So ändern Sie Ihre Profildetails:

  1. Navigieren Sie zur Registerkarte Einstellungen → Persönliche Einstellungen

  2. Suchen Sie das Feld, das Sie aktualisieren möchten

  3. Klicken Sie in das Feld und nehmen Sie Ihre Änderungen vor

  4. Klicken Sie unten im Abschnitt auf Speichern oder Aktualisieren

Änderungen treten in Kraft:

  • Sofort für die meisten Profilinformationen

  • Nach der elektronische Post-Bestätigung, falls die elektronische Post-Adresse geändert wird

  • Nach Bestätigung des Zurücksetzens des Passworts, wenn das Passwort geändert wird

Best Practices für die Sicherheit

Passwortverwaltung:

  • Verwenden Sie ein sicheres, eindeutiges Passwort (mehr als 12 Zeichen, eine Mischung aus Buchstaben, Zahlen und Symbolen).

  • Verwenden Sie keine Passwörter von anderen Konten wieder

  • Passwort regelmäßig ändern (empfohlen alle 90 Tage)

  • Geben Sie Ihr Passwort niemals an Mitarbeiter weiter – erstellen Sie stattdessen separate Konten

elektronische Post-Adresse:

  • Verwenden Sie eine geschäftliche elektronische Post-Adresse, die Sie kontrollieren

  • Halten Sie Ihre elektronische Post-Adresse aktuell (Sie erhalten wichtige Kontobenachrichtigungen)

  • Verwenden Sie keine gemeinsamen elektronische Post-Adressen (stellt Sicherheitsrisiken dar)

Zwei-Faktor-Authentifizierung:

  • Für zusätzliche Sicherheit aktivieren, falls verfügbar

  • Verwenden Sie nach Möglichkeit eine Authentifizierungs-Anwendung anstelle von SMS

  • Speichern Sie Backup-Codes an einem sicheren Ort

Kontozugriff:

  • Melden Sie sich ab, wenn Sie gemeinsam genutzte Computer verwenden

  • Speichern Sie Anmeldeinformationen nicht in öffentlichen Browsern

  • Überprüfen Sie regelmäßig verbundene Geräte/Sitzungen (falls die Funktion verfügbar ist).

Überlegungen zu mehreren Benutzern

Wenn Sie Mitarbeiter oder Teammitglieder haben:

  • Geben Sie die Anmeldedaten Ihres Besitzerkontos nicht weiter

  • Erstellen Sie separate Mitarbeiterkonten oder Unterkonten

  • Weisen Sie entsprechende Berechtigungsstufen zu

  • Jede Person sollte über ein eigenes Login verfügen

Infos: Persönliche Einstellungen wirken sich nur auf Ihr Konto aus. Mitarbeiter verwalten ihre eigenen persönlichen Einstellungen separat. Änderungen hier wirken sich nicht auf andere Teammitglieder aus.

Registerkarte „Integrationen“.

Was diese Registerkarte abdeckt

Auf der Registerkarte „Integrationen“ können Sie Perkstar mit Diensten und Tools von Drittanbietern verbinden, die Ihr Unternehmen verwendet. Integrationen automatisieren die Datenübertragung, synchronisieren Kundeninformationen und ermöglichen erweiterte Funktionen, indem sie Ihre Treueplattform mit Ihrem breiteren Geschäftsökosystem verbinden.

Arten von Integrationen

Gemeinsame Integrationskategorien:

Kundenbeziehungsmanagement (CRM):

  • Synchronisieren Sie Kundendaten zwischen Perkstar und Ihrem CRM

  • Automatische Aktualisierung des Kundenprofils

  • Einheitliche Kundenansicht auf allen Plattformen

elektronische Post-Werbung-Plattformen:

  • Exportieren Sie Kundenlisten in elektronische Post-Werbung-Tools

  • Lösen Sie elektronische Post-Kampagnen basierend auf Treueaktivitäten aus

  • Synchronisieren Sie Segmentierung und Kundendaten

Point-of-Sale (POS)-Systeme:

  • Automatische Zuweisung von Treuepunkten/Stempeln an der Kasse

  • Synchronisierung der Transaktionsdaten

  • Kundenidentifizierung in Echtzeit

Analyse und Berichterstattung:

  • Senden Sie Treuedaten an Analyseplattformen

  • Erstellen Sie benutzerdefinierte Berichte, die Loyalitäts- und Geschäftskennzahlen kombinieren

  • Verfolgen Sie den ROI über integrierte Systeme hinweg

elektronischer Handel-Plattformen:

  • Zuteilung von Treuepunkten beim im Internet-Einkauf

  • Synchronisierung des Kundenkontos

  • Einheitliche im Internet- und Offline-Treueverfolgung

Einrichten einer Integration

Allgemeiner Integrationsprozess:

  1. Navigieren Sie zur Registerkarte Einstellungen → Integrationen

  2. Durchsuchen Sie verfügbare Integrationen oder suchen Sie nach Ihrem Dienst

  3. Klicken Sie bei der gewünschten Integration auf „Verbinden“ oder „Konfigurieren“.

  4. Folgen Sie dem Autorisierungsablauf:

    • Melden Sie sich beim Drittanbieterdienst an

    • Erteilen Sie Perkstar die Erlaubnis, auf Daten zuzugreifen

    • Konfigurieren Sie Synchronisierungseinstellungen und Feldzuordnung

  5. Testen Sie die Integration mit Beispieldaten

  6. Aktivieren Sie die Integration

Hinweis: Jede Integration ist anders. Einige erfordern API-Schlüssel vom Drittanbieterdienst, andere verwenden OAuth (Sie melden sich direkt an). Die Konfigurationskomplexität variiert je nach Integration. Einige Integrationen werden sofort synchronisiert, andere werden nach Zeitplan aktualisiert.

Verwalten aktiver Integrationen

So zeigen Sie verbundene Dienste an:

  1. Öffnen Sie die Registerkarte Einstellungen → Integrationen

  2. Überprüfen Sie die Liste der aktiven Integrationen

  3. Überprüfen Sie den Synchronisierungsstatus und die letzte Aktualisierungszeit

So ändern Sie eine Integration:

  1. Klicken Sie auf die aktive Integration

  2. Passen Sie Einstellungen wie Synchronisierungsfrequenz oder Feldzuordnung an

  3. Änderungen speichern

So trennen Sie eine Integration:

  1. Klicken Sie auf die Integration, die Sie entfernen möchten

  2. Klicken Sie auf Trennen oder Deaktivieren

  3. Bestätigen Sie das Entfernen

Infos: Bereits synchronisierte Daten verbleiben in der Regel in beiden Systemen.

Best Practices für die Integration

Vor dem Verbinden von Integrationen:

  • Verstehen Sie, welche Daten zwischen Systemen ausgetauscht werden

  • Überprüfen Sie die Auswirkungen auf den Datenschutz für Kundendaten

  • Testen Sie mit Beispieldaten, bevor Sie live gehen

  • Dokumentieren Sie Ihre Integrationseinrichtung als Referenz für das Team

Überlegungen zur Datenzuordnung:

  • Stellen Sie sicher, dass die Kundenfelder zwischen den Systemen übereinstimmen (elektronische Post, Telefon, Namensformat).

  • Entscheiden Sie, wie Konflikte gelöst werden (welches System ist die Quelle der Wahrheit)

  • Richten Sie eine ordnungsgemäße Kundenidentifikation ein (elektronische Post- oder Telefonabgleich).

Sicherheit und Datenschutz:

  • Verbinden Sie nur Integrationen, die Sie aktiv benötigen

  • Überprüfen Sie Genehmigungsanfragen sorgfältig, bevor Sie sie autorisieren

  • Überprüfen Sie regelmäßig verbundene Dienste und trennen Sie ungenutzte Integrationen

  • Stellen Sie sicher, dass die Dienste Dritter die Datenschutzbestimmungen (DSGVO, CCPA) einhalten.

Überwachungsintegrationen:

  • Überprüfen Sie regelmäßig den Synchronisierungsstatus, um Fehler frühzeitig zu erkennen

  • Richten Sie ggf. Benachrichtigungen für Synchronisierungsfehler ein

  • Testen Sie die Integrationen, nachdem Sie Änderungen in einem der Systeme vorgenommen haben

  • Halten Sie API-Schlüssel und Anmeldeinformationen sicher

Fehlerbehebung bei Integrationen

Integration synchronisiert nicht:

  • Überprüfen Sie, ob die API-Anmeldeinformationen noch gültig sind

  • Stellen Sie sicher, dass Sie die Tarifgrenzen für Drittanbieterdienste nicht überschritten haben

  • Suchen Sie im Integrationsstatus nach Fehlermeldungen

  • Autorisieren Sie die Verbindung erneut, wenn die Authentifizierung abgelaufen ist

Doppelte Kundendatensätze:

  • Überprüfen Sie die Feldzuordnung (stellen Sie konsistente Übereinstimmungskriterien sicher)

  • Entscheiden Sie sich für eine einzige Quelle der Wahrheit für Kundendaten

  • Bereinigen Sie Duplikate in beiden Systemen vor der erneuten Synchronisierung

Fehlende Daten:

  • Überprüfen Sie, ob die Integration alle Felder synchronisiert oder nur bestimmte

  • Überprüfen Sie Datumsbereiche für die Synchronisierung historischer Daten

  • Stellen Sie sicher, dass in beiden Systemen Kunden für den Abgleich vorhanden sind

Registerkarte „Webhooks“.

Was diese Registerkarte abdeckt

Infos: Die Registerkarte „Webhooks“ ermöglicht erweiterte, benutzerdefinierte Integrationen, indem Sie Echtzeitbenachrichtigungen erhalten, wenn bestimmte Ereignisse in Ihrem Perkstar-Konto auftreten. Webhooks senden automatisierte HTTP-POST-Anfragen an von Ihnen angegebene URLs, sodass Ihre eigenen Systeme oder Tools von Drittanbietern sofort auf Treueaktivitäten reagieren können.

Tipp: Webhooks übertragen Daten von Perkstar an Ihre Systeme, wenn Ereignisse eintreten, und ermöglichen so eine Automatisierung in Echtzeit ohne ständige Abfragen oder manuellen Datenexport.

Wer nutzt Webhooks:

  • Entwickler erstellen benutzerdefinierte Integrationen

  • Unternehmen mit proprietären Systemen

  • Fortgeschrittene Benutzer verbinden Perkstar mit Tools ohne native Integrationen

  • Technische Teams automatisieren komplexe Arbeitsabläufe

Häufige Webhook-Anwendungsfälle

Kundenaktivität löst Folgendes aus:

  • Neukundenregistrierung → Konto im CRM erstellen

  • Karteninstallation → Willkommens-elektronische Post über benutzerdefiniertes System senden

  • Punkte/Stempel hinzugefügt → Kundenprofil in der Datenbank aktualisieren

  • Prämie eingelöst → Fulfillment-Workflow auslösen

Transaktionsbenachrichtigungen:

  • Kauf abgeschlossen → Synchronisierung mit Buchhaltungssoftware

  • Kontostand geändert → Kunden-Bedienoberfläche aktualisieren

  • Stufe hochgestuft → Kundenerfolgsteam benachrichtigen

Engagement-Tracking:

  • Push-Benachrichtigung zugestellt → Melden Sie sich bei der Analyseplattform an

  • Kundenfeedback eingereicht → Support-Ticket erstellen

  • Empfehlung abgeschlossen → Prämienzuteilung auslösen

Business Intelligence:

  • Echtzeit-Transaktions-Feed → Live-Bedienoberfläche aktualisieren

  • Kundenmeilenstein erreicht → Alert-Team

  • Hochwertige Kundenaktivität → Vertriebsteam benachrichtigen

Einrichten eines Webhooks

Voraussetzungen:

  • URL-Endpunkt, der HTTP-POST-Anfragen empfangen kann

  • Grundlegendes Verständnis des JSON-Datenformats

  • Möglichkeit, eingehende Webhook-Daten zu analysieren

  • (Optional) Webhook-Signaturvalidierung aus Sicherheitsgründen

Konfigurationsschritte:

  1. Navigieren Sie zur Registerkarte „Einstellungen“ → „Webhooks“.

  2. Klicken Sie auf Webhook hinzufügen oder Neuen Webhook erstellen

  3. Geben Sie Ihre Webhook-Details ein:

    • Webhook-URL: Der Endpunkt, der Daten empfängt

    • Veranstaltungstypen: Wählen Sie aus, welche Ereignisse den Webhook auslösen

    • Beschreibung: Interner Hinweis zum Webhook-Zweck

    • (Optional) Geheimer Schlüssel: Zur Validierung der Webhook-Authentizität

  4. Speichern Sie die Webhook-Konfiguration

  5. Testen Sie den Webhook mit Beispielereignisdaten

  6. Überwachen Sie den Lieferstatus

Webhook-Ereignistypen

Verfügbare Ereignisse (variiert je nach Implementierung):

  • Kunden.created – Neukundenregistrierung

  • Kunden.updated – Kundenprofiländerungen

  • card.installed – Der Kunde installiert die Karte in der Brieftasche

  • transaction.completed – Punkte/Stempel hinzugefügt oder eingelöst

  • reward.issued – Dem Kunden gegebene Belohnung

  • Rückmeldung.received – Der Kunde gibt Rückmeldung ab

  • push.delivered – Push-Benachrichtigung zugestellt

  • referral.completed – Erfolgreiche Empfehlung

Veranstaltungen auswählen:

  • Wählen Sie nur Ereignisse aus, die Sie benötigen, um unnötige Webhook-Aufrufe zu reduzieren

  • Jedes ausgewählte Ereignis löst eine separate HTTP-Anfrage an Ihre URL aus

  • Großvolumige Ereignisse (Transaktionen) können zu vielen Webhook-Aufrufen führen

Struktur der Webhook-Nutzlast

Infos: Webhooks senden JSON-formatierte Daten mit Ereignistyp-ID, Zeitstempel, Kundeninformationen, ereignisspezifischen Details und Konto-/Geschäfts-ID.

Beispiel für eine Webhook-Nutzlast:

Webhooks verwalten

Aktive Webhooks anzeigen:

  • Alle konfigurierten Webhooks werden in der Listenansicht angezeigt

  • Jeder Webhook zeigt: URL, Ereignisse, Status, letzte Zustellung

Webhooks testen:

  • Verwenden Sie die integrierte Testfunktion, um Beispielnutzdaten zu senden

  • Überprüfen Sie, ob Ihr Endpunkt Daten korrekt empfängt und verarbeitet

  • Antwortcodes prüfen (200 = Erfolg, 4xx/5xx = Fehler)

Webhooks bearbeiten:

  1. Klicken Sie auf den vorhandenen Webhook

  2. Ändern Sie URL, Ereignisse oder Beschreibung

  3. Änderungen speichern

  4. Nach Änderungen erneut testen

Webhooks deaktivieren/löschen:

  • Deaktivieren: Stoppt den Webhook vorübergehend, ohne ihn zu löschen

  • Löschen: Entfernt die Webhook-Konfiguration dauerhaft

Best Practices für Webhooks

Sicherheitsüberlegungen:

  • Verwenden Sie zum Verschlüsseln von Webhook-Daten nur HTTPS-URLs (nicht HTTP).

  • Validieren Sie Webhook-Signaturen mithilfe geheimer Schlüssel

  • Überprüfen Sie nach Möglichkeit die IP-Adressen der Absender

  • Geben Sie keine sensiblen Daten in Webhook-URLs preis (verwenden Sie nur den POST-Text)

Endpunktzuverlässigkeit:

  • Stellen Sie sicher, dass Ihr Endpunkt schnell reagiert (innerhalb von 5–10 Sekunden).

  • Geben Sie den Statuscode 200 für den erfolgreichen Empfang zurück

  • Behandeln Sie Fehler ordnungsgemäß (Perkstar kann fehlgeschlagene Zustellungen erneut versuchen)

  • Warteschlangen-Webhook-Verarbeitung für asynchrone Verarbeitung, falls komplex

Überwachung und Debugging:

  • Protokollieren Sie alle eingehenden Webhook-Daten zur Fehlerbehebung

  • Überwachen Sie die Erfolgsraten der Webhook-Zustellung

  • Richten Sie Benachrichtigungen für wiederholte Fehler ein

  • Überprüfen Sie die Webhook-Protokolle regelmäßig, um Probleme frühzeitig zu erkennen

Teststrategie:

  • Testen Sie zuerst in der Staging-/Entwicklungsumgebung

  • Überprüfen Sie die Behandlung aller abonnierten Ereignistypen

  • Fehlerszenarien testen (ungültige Daten, Zeitüberschreitung, Endpunktausfall)

  • Überprüfen Sie, ob das Datenformat Ihren Erwartungen entspricht

Webhook-Grenzwerte:

  • Prüfen Sie, ob es Ratenbeschränkungen für Webhook-Zustellungen gibt

  • Vermeiden Sie die Erstellung redundanter Webhooks für dieselben Ereignisse

  • Erwägen Sie die Stapelung, wenn Sie große Mengen erhalten

  • Dokumentieren Sie Ihre Webhook-Konfigurationen als Referenz für das Team

Fehlerbehebung bei Webhooks

Webhooks werden nicht empfangen:

  • Überprüfen Sie, ob die URL korrekt und öffentlich zugänglich ist

  • Überprüfen Sie die Firewall-Einstellungen (stellen Sie sicher, dass Perkstar-IPs nicht blockiert werden).

  • Bestätigen Sie, dass der Endpunkt mit dem Statuscode 200 antwortet

  • Überprüfen Sie die Webhook-Protokolle auf Fehlermeldungen

Empfang doppelter Webhooks:

  • Einige Ereignisse können (beabsichtigt) mehrmals ausgelöst werden.

  • Implementieren Sie Idempotenzschlüssel, um Duplikate zu verarbeiten

  • Überprüfen Sie, ob mehrere Webhooks für dasselbe Ereignis konfiguriert sind

Fehlende Felder für Webhook-Daten:

  • Überprüfen Sie, ob der Ereignistyp die benötigten Felder enthält

  • Überprüfen Sie die API-Dokumentation auf die Struktur der Ereignisnutzlast

  • Einige Felder sind möglicherweise optional (null, wenn nicht zutreffend).

Signaturvalidierung schlägt fehl:

  • Stellen Sie sicher, dass die geheimen Schlüssel in beiden Systemen übereinstimmen

  • Überprüfen Sie die Signaturberechnungsmethode (normalerweise HMAC SHA256).

  • Suchen Sie nach Leerzeichen oder Codierungsproblemen

Best Practices für Kontoeinstellungen

Regelmäßige Überprüfung der Einstellungen

Vierteljährliches Einstellungsaudit:

  • Überprüfen Sie aktive Integrationen und trennen Sie ungenutzte Integrationen

  • Überprüfen Sie Webhook-Konfigurationen und entfernen Sie veraltete Endpunkte

  • Aktualisieren Sie persönliche Daten, wenn sich Geschäftsdaten geändert haben

  • Überprüfen Sie die Kapazität und Nutzung des Plans (aktualisieren Sie, wenn die Grenzen dauerhaft erreicht werden).

Nach geschäftlichen Änderungen:

  • Aktualisieren Sie Unternehmensinformationen bei einem Rebranding oder einem Umzug

  • Passen Sie Integrationen an, wenn Sie neue Tools einführen

  • Ändern Sie Webhooks, wenn sich die Systemarchitektur ändert

Sicherheitswartung

Passwort und Zugang:

  • Passwort alle 90 Tage ändern

  • Überprüfen Sie verbundene Sitzungen und melden Sie nicht verwendete Geräte ab

  • Aktivieren Sie die Zwei-Faktor-Authentifizierung, falls verfügbar

  • Geben Sie niemals Anmeldedaten weiter – erstellen Sie stattdessen Mitarbeiterkonten

Integrationssicherheit:

  • Überprüfen Sie die Integrationen von Drittanbietern vierteljährlich

  • Entfernen Sie Integrationen, die Sie nicht mehr verwenden

  • Überprüfen Sie die Berechtigungsbereiche regelmäßig

  • Bewahren Sie API-Schlüssel sicher auf und rotieren Sie, wenn sich das Personal ändert

Webhook-Sicherheit:

  • Verwenden Sie nur HTTPS-Endpunkte

  • Validieren Sie Webhook-Signaturen

  • Überwachen Sie auf ungewöhnliche Webhook-Aktivitäten

  • Aktualisieren Sie geheime Schlüssel, wenn sie kompromittiert sind

Teamkoordination

Dokumentieren Sie Ihre Einstellungen:

Führen Sie eine interne Dokumentation von:

  • Aktive Integrationen und ihre Zwecke

  • Webhook-Konfigurationen und was sie tun

  • Planen Sie Kapazität und Upgrade-Auslöser

  • Änderungsverlauf der Einstellungen

Besitz zuweisen:

  • Kontoinhaber: Planen und abrechnen

  • Technische Leitung: Webhooks und Integrationen

  • Geschäftsführer: Persönliche Einstellungen für ihr Profil

Kommunikation ändern:

  • Benachrichtigen Sie das Team, wenn Sie Einstellungen ändern, die alle betreffen

  • Dokumentieren Sie, warum Änderungen vorgenommen wurden

  • Testen Sie Änderungen möglichst außerhalb der Produktion

Kostenoptimierung

Planverwaltung:

  • Überwachen Sie die Nutzung regelmäßig, um zu vermeiden, dass Sie für ungenutzte Kapazität bezahlen müssen

  • Gegebenenfalls während der langsamen Jahreszeit ein Downgrade durchführen

  • Erwägen Sie die jährliche Abrechnung von Rabatten

  • Fügen Sie bei Bedarf zusätzliche Kapazität à la carte statt eines vollständigen Upgrades hinzu

Integrationseffizienz:

  • Trennen Sie Integrationen, die keinen Mehrwert bieten

  • Konsolidieren Sie redundante Integrationen

  • Überprüfen Sie ggf. die Integrationspreise

Fehlerbehebung

Auf das Einstellungsmodul kann nicht zugegriffen werden

Problem: Das Einstellungssymbol wird nicht angezeigt oder ist ausgegraut

Ursachen und Lösungen:

  • Unzureichende Berechtigungen: Nur Kontoinhaber und Administratoren können auf die Einstellungen zugreifen. Wenden Sie sich an Ihren Kontoinhaber, wenn Sie ein Mitarbeiterbenutzer sind

  • Browserprobleme: Cache und Cookies löschen, anderen Browser ausprobieren

  • Sitzung abgelaufen: Melden Sie sich ab und wieder an

Änderungen werden nicht gespeichert

Problem: Sie klicken auf „Speichern“, aber die Einstellungen werden auf die vorherigen Werte zurückgesetzt

Ursachen und Lösungen:

  • Fehler bei der Formularvalidierung: Suchen Sie nach roten Fehlermeldungen in der Nähe von Feldern

  • Erforderliche Felder fehlen: Geben Sie alle erforderlichen Informationen ein

  • Sitzungszeitüberschreitung: Aktualisieren Sie die Seite und versuchen Sie es erneut

  • Browserprobleme: Deaktivieren Sie Browsererweiterungen, die Formulare beeinträchtigen könnten

Ein Upgrade oder eine Änderung des Plans ist nicht möglich

Problem: Die Upgrade-Schaltfläche funktioniert nicht oder die Zahlung schlägt fehl

Ursachen und Lösungen:

  • Problem mit der Zahlungsmethode: Aktualisieren Sie die Kartendetails auf der Registerkarte „Plan“.

  • Nicht übereinstimmende Rechnungsadresse: Überprüfen Sie, ob die Adresse mit der Zahlungsmethode übereinstimmt

  • Kartenlimit überschritten: Kontaktieren Sie Ihre Bank oder probieren Sie eine andere Zahlungsmethode aus

  • Kontobeschränkung: Wenden Sie sich an den Perkstar-Support, wenn das Upgrade blockiert ist

Integrationsverbindung schlägt fehl

Problem: Der Dienst eines Drittanbieters führt keine Autorisierung oder Verbindung durch

Ursachen und Lösungen:

  • Falsche Anmeldeinformationen: Überprüfen Sie API-Schlüssel oder Anmeldedaten

  • Berechtigungen nicht erteilt: Stellen Sie sicher, dass Sie während OAuth auf „Zulassen“ oder „Autorisieren“ klicken.

  • Dienst vorübergehend nicht verfügbar: Versuchen Sie es später erneut oder überprüfen Sie die Statusseite des Drittanbieters

  • Kontostatus: Stellen Sie sicher, dass Ihr Konto beim Drittanbieterdienst aktiv ist

Webhook liefert nicht

Problem: Es treten Ereignisse auf, aber der Webhook wird nicht ausgelöst

Ursachen und Lösungen:

  • URL falsch: Überprüfen Sie die Webhook-URL noch einmal (keine Tippfehler)

  • Endpunkt antwortet nicht: Testen Sie Ihren Endpunkt separat, um sicherzustellen, dass er zugänglich ist

  • Falsche Veranstaltung ausgewählt: Stellen Sie sicher, dass Sie die richtigen Veranstaltungstypen abonniert haben

  • Webhook deaktiviert: Überprüfen Sie den Webhook-Status auf der Registerkarte „Webhooks“.

Häufig gestellte Fragen

Wer kann auf das Modul „Einstellungen“ zugreifen?

Kontoinhaber und Administratoren können auf alle Einstellungsregisterkarten zugreifen. Mitarbeiterbenutzer haben je nach Berechtigungsstufe möglicherweise eingeschränkten Zugriff. Planänderungen und Abrechnungseinstellungen sind normalerweise nur Kontoinhabern vorbehalten.

Hat die Änderung meiner elektronische Post-Adresse Auswirkungen auf mein Login?

Ja. Wenn Sie Ihre elektronische Post-Adresse in den persönlichen Einstellungen ändern und sich per elektronische Post anmelden, müssen Sie die neue elektronische Post-Adresse für zukünftige Anmeldungen verwenden. Normalerweise erhalten Sie an die neue Adresse eine Bestätigungs-elektronische Post, um die Änderung zu bestätigen.

Wie aktualisiere ich meinen Plan?

Gehen Sie zur Registerkarte „Einstellungen“ → „Plan“, überprüfen Sie die verfügbaren Pläne und klicken Sie auf die Schaltfläche „Upgrade“. Wählen Sie Ihren neuen Plan aus, bestätigen Sie die Rechnungsdetails und schließen Sie die Zahlung ab. Upgrades werden in der Regel sofort wirksam und Ihnen wird ein anteiliger Betrag für den aktuellen Abrechnungszeitraum in Rechnung gestellt.

Wann treten Plan-Downgrades in Kraft?

Herabstufungen werden in der Regel bei Ihrem nächsten Abrechnungszeitraum wirksam, um anteilige Gebühren zu vermeiden. Bis zum Verlängerungsdatum haben Sie weiterhin Zugriff auf die Funktionen Ihres aktuellen Plans. Den genauen Zeitpunkt finden Sie in der Downgrade-Bestätigung.

Kann ich eine Integration trennen, ohne meine Daten zu verlieren?

Ja. Das Trennen einer Integration stoppt die zukünftige Datensynchronisierung, löscht jedoch normalerweise keine Daten, die bereits in einem der Systeme synchronisiert wurden. Bestätigen Sie dies jedoch mit der spezifischen Integration, bevor Sie die Verbindung trennen, um Überraschungen zu vermeiden.

Was passiert mit meinen Webhooks, wenn ich eine Integration trenne?

Webhooks sind unabhängig von Standardintegrationen. Das Trennen einer Integration hat keine Auswirkungen auf Ihre Webhooks, es sei denn, der Webhook hat Daten an diesen integrierten Dienst gesendet. Überprüfen Sie Ihre Webhook-Konfigurationen, nachdem Sie die Integrationen getrennt haben.

Sind Webhooks in allen Plänen enthalten?

Die Verfügbarkeit von Webhooks hängt von Ihrer Tarifstufe ab. Überprüfen Sie die Registerkarte „Plan“ oder wenden Sie sich an Perkstar, um zu bestätigen, ob Webhooks in Ihrem aktuellen Abonnement enthalten sind.

Kann ich mehrere Webhooks für dasselbe Ereignis haben?

Ja. Sie können mehrere Webhook-URLs konfigurieren, um denselben Ereignistyp zu empfangen. Dies ist nützlich, wenn Sie Daten an mehrere Systeme oder Dienste senden.

Woher weiß ich, ob mein Webhook funktioniert?

Verwenden Sie die integrierte Testfunktion auf der Registerkarte „Webhooks“, um eine Beispielnutzlast an Ihren Endpunkt zu senden. Überprüfen Sie Ihre Endpunktprotokolle, um den Empfang zu bestätigen. Überwachen Sie außerdem den Webhook-Zustellungsstatus in der Webhook-Listenansicht.

Was ist der Unterschied zwischen Integrationen und Webhooks?

Bei Integrationen handelt es sich um vorgefertigte Verbindungen zu beliebten Drittanbieterdiensten mit geführter Einrichtung. Webhooks sind benutzerdefinierte Integrationen, die Sie selbst erstellen, indem Sie eine URL bereitstellen, die Echtzeit-Ereignisdaten empfängt. Nutzen Sie Integrationen für unterstützte Dienste und Webhooks für benutzerdefinierte Lösungen.

Kann ich meinen Plan mitten im Abrechnungszeitraum ändern?

Ja. Upgrades werden in der Regel sofort wirksam und die Kosten werden anteilig berechnet. Herabstufungen werden normalerweise mit Ihrem nächsten Abrechnungszeitraum wirksam. Überprüfen Sie den Bestätigungsbildschirm auf genaue Details, bevor Sie fortfahren.

Werde ich durch das Ändern meines Passworts von anderen Geräten abgemeldet?

Dies hängt von den Sicherheitseinstellungen von Perkstar ab. Einige Systeme melden Sie aus Sicherheitsgründen von allen Geräten ab, wenn Sie Ihr Passwort ändern. Möglicherweise müssen Sie sich auf Ihren anderen Geräten (Telefon, Tablet usw.) erneut anmelden.

Wie aktiviere ich die Zwei-Faktor-Authentifizierung?

Suchen Sie, sofern verfügbar, auf der Registerkarte „Persönliche Einstellungen“ nach der Option „Zwei-Faktor-Authentifizierung“ oder „2FA“. Folgen Sie dem Einrichtungsassistenten, um eine Authentifizierungs-Anwendung zu verknüpfen. Möglicherweise verfügen nicht alle Konten über diese Funktion. Überprüfen Sie die Details Ihres Plans.

Können Mitarbeiter Kontoeinstellungen ändern?

Es hängt von ihrer Berechtigungsstufe ab. Mitarbeiter können in der Regel ihre eigenen persönlichen Einstellungen verwalten, dürfen jedoch nicht auf die Registerkarten „Plan“, „Integrationen“ oder „Webhooks“ zugreifen. Kontoinhaber steuern die Berechtigungsstufen.

Was soll ich tun, wenn ich nicht auf die Einstellungen zugreifen kann?

Wenden Sie sich an Ihren Kontoinhaber oder Administrator, um Ihre Benutzerberechtigungsstufe zu überprüfen. Wenn Sie der Kontoinhaber sind und immer noch nicht auf die Einstellungen zugreifen können, wenden Sie sich an den Perkstar-Support.

Tipp: Benötigen Sie weitere Hilfe? Wenden Sie sich an den Perkstar-Support, um Unterstützung bei bestimmten Einstellungskonfigurationen, Fragen zur Rechnungsstellung oder technischem Integrationssupport zu erhalten.