Stripe-Integration

Die Stripe-Integration in Deskwoot holt die Zahlungen, aktiven Abos und Rechnungsdaten jedes Kunden in die Seitenleiste der Konversation. So sehen deine Agenten den finanziellen Hintergrund, ohne den Tab zu wechseln oder den Kunden nach Zahlungsdetails zu fragen. Das führt zu schnelleren Lösungen und einem angenehmeren Kundenerlebnis.

Stripe verbinden

1. Gehe zu Einstellungen > Integrationen und öffne Stripe.
2. Klicke auf Im Stripe Marketplace installieren. Du landest auf dem Deskwoot-Eintrag bei Stripe.
3. Klicke auf Install und bestätige die Berechtigungen, die Deskwoot braucht: Kunden (lesen), Abos (lesen und schreiben), Zahlungen und Erstattungen (lesen und schreiben), Produkte (lesen) und Rechnungen (lesen).
4. Direkt nach der Installation zeigt Stripe einen eingeschränkten API-Schlüssel an (er beginnt mit rk_live_, im Testmodus mit rk_test_). Kopiere ihn, füge ihn in Deskwoot in das Feld Eingeschränkter API-Schlüssel ein und klicke auf Verbinden.

Danach übernimmt Deskwoot deine Stripe-Kunden als Kontakte, und zwar gleich und dann einmal am Tag. Die Schreibrechte nutzt Deskwoot nur, wenn ein Agent (oder Fynn, wenn du es erlaubst) eine Zahlung erstattet oder ein Abo kündigt. Zahlungen legt Deskwoot nicht an.

Zahlungen

Nach dem Verbinden zeigt der Tab Details einer Konversation die letzten Zahlungen des Kunden (bis zu 10), jeweils mit:

• Beschreibung, Betrag und Währung
• Datum der Zahlung
• Status: erfolgreich, fehlgeschlagen oder erstattet

Zahlungen werden über die E-Mail-Adresse zugeordnet. Die E-Mail des Kontakts in Deskwoot muss also mit der E-Mail bei Stripe übereinstimmen, damit die Daten erscheinen. Gibt es bei Stripe mehrere Kunden mit dieser E-Mail, zeigt Deskwoot den neuesten.

Agenten, die erstatten dürfen (Administratoren und im Enterprise-Plan Mitglieder, deren benutzerdefinierte Rolle das erlaubt), sehen neben einer erfolgreichen Zahlung die Schaltfläche Erstattung. Sie erstattet die Zahlung nach einer Bestätigung vollständig, und die Erstattung landet im Audit-Protokoll von Deskwoot.

Abos und Rechnungen

Bei Kunden mit Stripe-Abos zeigt der Tab Details den Tarifnamen, Preis und Abrechnungsintervall, den aktuellen Status und das Datum der Verlängerung, des Endes oder des Testphasen-Endes. Darunter stehen die letzten 5 Rechnungen mit Status, Betrag und einem Link zur Rechnungsseite bei Stripe sowie der Kundensaldo (ein Guthaben für die nächsten Rechnungen oder ein offener Betrag). Agenten, die kündigen dürfen, sehen neben einem aktiven Abo Kündigen: Das Abo endet dann mit dem laufenden Abrechnungszeitraum, und der Kunde behält, wofür er bezahlt hat.

Erstattungen im Blick

Erstattungen sind in den Zahlungen gekennzeichnet: Eine vollständig erstattete Zahlung hat den Status Erstattet. So beantworten deine Agenten Abrechnungsfragen, ohne sich bei Stripe anzumelden. Zahlungsstreitigkeiten (Chargebacks) zeigt Deskwoot nicht an, sie bleiben in deinem Stripe-Dashboard.

Fehlerbehebung

• Keine Zahlungsdaten sichtbar: Prüfe, ob die E-Mail-Adresse des Kunden in Deskwoot genau mit der E-Mail bei Stripe übereinstimmt. Schon kleine Unterschiede (etwa Groß- und Kleinschreibung) können die Zuordnung verhindern.
• Schlüssel wird abgelehnt: Füge den eingeschränkten Schlüssel ein, den Stripe nach der Installation angezeigt hat (er beginnt mit rk_live_ oder rk_test_), nicht den Publishable Key (pk_). Meldet der Tab Details, dass Stripe den verbundenen Schlüssel ablehnt, ist er vielleicht widerrufen, abgelaufen oder ihm fehlt eine Berechtigung. Prüfe dann die Stripe-Verbindung unter Einstellungen > Integrationen.
• Veraltete Daten: Zahlungsdaten werden live aus Stripe gelesen, sobald eine Konversation geöffnet wird. Wenn sie veraltet wirken, lade die Konversation neu.

Tipps aus der Praxis

• Sorge dafür, dass dein Team in Deskwoot und Stripe dieselben Kunden-E-Mail-Adressen verwendet, damit die Zuordnung zuverlässig klappt.
• Nutze die Zahlungsdaten in der Seitenleiste, um Zahlungen zu prüfen, bevor du auf Abrechnungsfragen antwortest. Das spart Hin und Her und schafft Vertrauen.
• Vollständige Erstattungen und Kündigungen zum Ende des Abrechnungszeitraums erledigst du im Tab Details. Teilerstattungen und Tarifwechsel machst du weiter im Stripe-Dashboard.

Häufige Fragen