Zum Inhalt springen

RevenueCat

Aktualisiert am

Kunden in Ihrer iOS-App fragen den Chatbot nach ihrem eigenen Abonnement, und er antwortet aus RevenueCat: ob es aktiv ist, wann es sich verlängert oder endet, ob es ein Zahlungsproblem gibt und wo man es verwaltet. Die Einrichtung dauert etwa zehn Minuten und braucht ein wenig Code in Ihrer App.

Was Ihre Kunden fragen können

  • Was sie haben: jedes Abonnement, ob es aktiv ist oder in einer kostenlosen Testphase, und wo sie es gekauft haben.
  • Wann es sich verlängert oder endet und ob sie die Verlängerung ausgeschaltet haben.
  • Warum der Zugang endete: eine fehlgeschlagene Zahlung, die erneut versucht wird, oder ein Abonnement, das ausgelaufen ist, und wann.
  • Wie sie es kündigen oder ändern. Der Chatbot schickt sie zu dem Store, in dem sie es gekauft haben, und dort erledigen sie es selbst.

Er liest nur. Kündigungen, Erstattungen und Tarifwechsel bleiben Sache des Stores und des Kunden: Eine Erstattung für einen Kauf im App Store wird bei Apple beantragt. Ein Kauf in einer Testumgebung wird als Testkauf bezeichnet, sodass Sie alles ausprobieren können, bevor Sie live schalten. Dazu gehören auch die Käufe eines TestFlight-Builds, die den Tester nichts kosten; ein Testkauf beweist also nie, dass jemand bezahlt hat. Datumsangaben sind Kalendertage in UTC.

Wie Ihre App zeigt, wer fragt

Der Chatbot liest nur das Abonnement des Kunden, dessen Identität Ihre App bestätigt, nie eines, das jemand im Chat nennt: Er fragt weder nach einer E-Mail-Adresse noch nach einer Nutzer-ID oder einem Kaufbeleg und nimmt auch keine davon an. Ihre App zeigt auf einem von vier Wegen, wer der Kunde ist, und ChatFrom prüft das bei jeder Nachricht, bevor etwas gelesen wird.

  1. Ein Token von Ihrem Server, für Kunden, die sich in Ihrer App anmelden. Ihr Server signiert ein kurzlebiges Token mit dem Signing Secret Ihres Chatbots: HS256, die App User ID des Kunden bei RevenueCat in sub und ein exp, das höchstens 24 Stunden in der Zukunft liegt. Ihre App übergibt es als Nutzer-Token. Das funktioniert auch auf Ihrer Website.
  2. Das eigene Zugriffstoken von RevenueCat, wenn Ihre App Kunden mit der Authentifizierung von RevenueCat anmeldet, die bei RevenueCat noch in der Beta ist. Übergeben Sie es stattdessen als Nutzer-Token; der Chatbot prüft es mit den Schlüsseln Ihres Projekts bei RevenueCat.
  3. Die anonyme ID von RevenueCat, für eine App ohne eigenen Server, sobald Sie das auf der Karte erlauben. RevenueCat erzeugt eine für jeden Kunden, der sich nicht angemeldet hat, und niemand kann sie erraten; daher übergibt die App sie unverändert. Wer eine besitzt, kann nach dem Abonnement dieses Kunden fragen, wie beim SDK von RevenueCat selbst. Eine ID, die Sie selbst gewählt haben, etwa eine E-Mail-Adresse oder eine Nummer, ließe sich erraten und braucht daher immer ein Token.
  4. Die Bestätigung des App Store, sobald Sie die Bundle-ID Ihrer App auf der Karte eingeben. Das iOS-SDK liest die Abonnements mit StoreKit und gibt weiter, was Apple signiert hat; ChatFrom prüft das mit Apples eigenem Zertifikat, und es zählt nur für Ihre App. So kann der Chatbot auch antworten, während RevenueCat nicht erreichbar ist. Es betrifft die Person, die auf dem Gerät im App Store angemeldet ist, und das ist nicht immer die Person, die in Ihrer App angemeldet ist.

Die letzten beiden funktionieren nur in Ihrer App, wo das SDK sie übergibt. Ein Token von Ihrem Server erreicht auch die Tool-Server, die Sie für das Nutzer-Token angehakt haben, sodass einer Ihrer Server es mit demselben Secret prüfen kann.

Ihr ServerJavaScript
import { SignJWT } from "jose";

// Auf Ihrem Server, nie in der App: das Signing Secret, das die Karte gezeigt hat, als Text, so wie es ist.
const secret = new TextEncoder().encode(signingSecret);

// Die App User ID des Kunden bei RevenueCat: das, was Ihre App an Purchases.logIn übergibt.
const userToken = await new SignJWT({})
  .setProtectedHeader({ alg: "HS256" })
  .setSubject(customer.revenueCatId)
  .setExpirationTime("1h")
  .sign(secret);
Ihre AppSwift
// Wege 1 und 2: ein Token, von Ihrem Server oder von RevenueCat.
ChatFrom.identify(userId: user.id, userToken: userToken)

// Weg 3: die anonyme ID von RevenueCat, für einen Kunden, der sich nicht angemeldet hat.
ChatFrom.revenueCatAppUserId = Purchases.shared.appUserID

// Weg 4: die Bestätigung des App Store selbst zu den Abonnements.
ChatFrom.sharesAppStoreSubscriptions = true

Setzen Sie revenueCatAppUserId jedes Mal neu, wenn sich die ID bei RevenueCat ändert, wie beim An- oder Abmelden. ChatFrom.logout() vergisst sie, setzen Sie danach also die nächste. Die Details stehen im README des iOS-SDK, und wie Sie den Chat in Ihre App einbauen, steht in der iOS-Anleitung.

In RevenueCat

  1. Öffnen Sie Ihr Projekt, gehen Sie zu API keys und klicken Sie auf + New secret API key. Nennen Sie den Schlüssel ChatFrom, wählen Sie V2 und geben Sie ihm nur Customer information: Subscriptions: Read.
  2. Kopieren Sie die Projekt-ID aus Project settings, General.

In ChatFrom

  1. Öffnen Sie Ihren Chatbot und gehen Sie zu Tools. Klicken Sie unter Verbindungen bei RevenueCat auf +.
  2. Fügen Sie die Projekt-ID und den Schlüssel ein und klicken Sie auf RevenueCat verbinden. ChatFrom prüft den Schlüssel bei RevenueCat, ohne einen echten Kunden zu lesen, und schaltet das Tool ein.
  3. Kopieren Sie das Signing Secret, das die Karte anzeigt, für Ihren Server. Es wird nur einmal angezeigt. Falls es je nach außen gelangt, klicken Sie auf Neues Secret erstellen: Mit dem alten signierte Tokens funktionieren sofort nicht mehr, und ein neuer Schlüssel lässt das Secret unverändert.
  4. Erlauben Sie die anonymen IDs von RevenueCat oder geben Sie die Bundle-ID Ihrer App ein, falls Ihre App diese Wege nutzt.
  5. Melden Sie sich in Ihrer App an, öffnen Sie den Chat und fragen Sie: „Wann verlängert sich mein Abonnement?“

Was geschützt bleibt

  • Ihr Schlüssel und das Signing Secret werden verschlüsselt gespeichert, und der Schlüssel wird nie wieder angezeigt. Beim Trennen der Verbindung werden beide gelöscht.
  • Wer der Kunde ist, gelangt versiegelt von der Nachricht zum Tool, nur für diese Unterhaltung und diese Person und nur für wenige Minuten. Nichts, was im Chat gesagt wird, kann das ändern.
  • Ein Token wird bei jeder Nachricht geprüft: Eines, das nicht mit Ihrem Secret signiert ist, abgelaufen ist oder länger als 24 Stunden gilt, wird abgelehnt.
  • Nimmt RevenueCat den Schlüssel nicht mehr an, bietet der Chatbot eine Übergabe an, und die Karte bittet um einen neuen Schlüssel.
  • Der Chatbot kann kein Abonnement kündigen oder ändern und nichts erstatten.

Zum Beenden schalten Sie Abonnement-Tool aus oder klicken auf Trennen, um den gespeicherten Schlüssel und das Secret zu löschen; löschen Sie danach auch den Schlüssel in RevenueCat. Womit sich ein Chatbot sonst noch verbinden lässt, steht auf der Seite Verbindungen.