RevenueCat
Zaktualizowano
Klienci w Twojej aplikacji na iOS pytają chatbota o własną subskrypcję, a on odpowiada na podstawie RevenueCat: czy jest aktywna, kiedy się odnawia lub kończy, czy jest problem z płatnością i gdzie zarządzać subskrypcją. Konfiguracja zajmuje około dziesięciu minut i wymaga odrobiny kodu w Twojej aplikacji.
O co mogą pytać Twoi klienci
- Co mają: każdą subskrypcję, to, czy jest aktywna albo w bezpłatnym okresie próbnym, i gdzie ją kupili.
- Kiedy się odnawia lub kończy i czy wyłączyli odnawianie.
- Dlaczego dostęp się skończył: nieudana płatność, która jest ponawiana, albo subskrypcja, która wygasła, i kiedy to się stało.
- Jak ją anulować lub zmienić. Chatbot odsyła ich do sklepu, w którym ją kupili, i tam robią to sami.
Chatbot tylko odczytuje dane. Anulowanie, zwrot pieniędzy i zmiana planu pozostają w gestii sklepu i klienta: o zwrot za zakup w App Store prosi się Apple. Zakup w środowisku testowym chatbot nazywa zakupem testowym, więc możesz wszystko wypróbować przed uruchomieniem. Dotyczy to też zakupów w wersjach z TestFlight, które testera nic nie kosztują, dlatego zakup testowy nigdy nie dowodzi, że ktoś zapłacił. Daty to dni w strefie UTC.
Jak Twoja aplikacja wskazuje, kto pyta
Chatbot odczytuje wyłącznie subskrypcję klienta, za którego ręczy Twoja aplikacja, nigdy tę, którą ktoś wskaże na czacie: nie prosi o adres e-mail, identyfikator użytkownika ani dowód zakupu i nie przyjmuje ich. Twoja aplikacja wskazuje, kim jest klient, na jeden z czterech sposobów, a ChatFrom sprawdza to przy każdej wiadomości, zanim cokolwiek odczyta.
- Token z Twojego serwera, dla klientów, którzy logują się w Twojej aplikacji. Twój serwer podpisuje krótki token sekretem do podpisywania (signing secret) Twojego chatbota: HS256, App User ID klienta w RevenueCat w
suborazexpnajwyżej 24 godziny naprzód. Aplikacja przekazuje go jako swój token użytkownika. Działa to też na Twojej stronie internetowej. - Własny token dostępu RevenueCat, jeśli Twoja aplikacja loguje klientów przez uwierzytelnianie RevenueCat, które jest tam wciąż w wersji beta. Przekaż go wtedy jako token użytkownika; chatbot sprawdza go kluczami Twojego projektu w RevenueCat.
- Anonimowy identyfikator RevenueCat, dla aplikacji bez własnego serwera, gdy włączysz tę opcję na karcie. RevenueCat tworzy taki identyfikator dla każdego klienta, który się nie zalogował, i nikt nie jest w stanie go odgadnąć, więc aplikacja przekazuje go bez zmian. Każdy, kto go ma, może zapytać o subskrypcję tego klienta, tak samo jak w SDK samego RevenueCat. Identyfikator wybrany przez Ciebie, np. adres e-mail albo numer, dałoby się odgadnąć, dlatego zawsze wymaga tokenu.
- Potwierdzenie z App Store, gdy wpiszesz na karcie identyfikator pakietu (bundle id) swojej aplikacji. SDK na iOS odczytuje subskrypcje przez StoreKit i przekazuje to, co podpisał Apple; ChatFrom sprawdza to certyfikatem samego Apple, a liczy się to tylko dla Twojej aplikacji. Dzięki temu chatbot może odpowiadać nawet wtedy, gdy RevenueCat jest nieosiągalny. Dotyczy to osoby zalogowanej do App Store na urządzeniu, a nie zawsze jest to ta sama osoba, która jest zalogowana w Twojej aplikacji.
Dwa ostatnie sposoby działają tylko w Twojej aplikacji, gdzie przekazuje je SDK. Token z Twojego serwera trafia też do serwerów narzędzi oznaczonych do przekazywania tokenu użytkownika, więc Twój serwer może go sprawdzić tym samym sekretem.
Ustawiaj revenueCatAppUserId ponownie za każdym razem, gdy zmienia się identyfikator w RevenueCat, np. gdy ktoś się loguje lub wylogowuje. ChatFrom.logout() go usuwa, więc potem ustaw kolejny. Szczegóły zawiera README SDK na iOS, a to, jak dodać czat do aplikacji, opisuje przewodnik dla iOS.
W RevenueCat
- Otwórz swój projekt, przejdź do API keys i kliknij + New secret API key. Nazwij klucz ChatFrom, wybierz V2 i nadaj mu wyłącznie uprawnienie Customer information: Subscriptions: Read.
- Skopiuj identyfikator projektu z Project settings, General.
W ChatFrom
- Otwórz swojego chatbota i przejdź do sekcji Tools. W grupie Connections kliknij + na kafelku RevenueCat.
- Wklej identyfikator projektu i klucz, a potem kliknij Connect RevenueCat. ChatFrom sprawdza klucz w RevenueCat bez odczytywania danych żadnego prawdziwego klienta i włącza narzędzie.
- Skopiuj signing secret pokazany na karcie: będzie potrzebny Twojemu serwerowi. Jest pokazywany tylko raz. Jeśli kiedyś wycieknie, kliknij Make a new secret: tokeny podpisane starym sekretem od razu przestają działać, a nowy klucz nie zmienia sekretu.
- Jeśli Twoja aplikacja korzysta z tych sposobów, zezwól na anonymous ids albo wpisz w polu Bundle id jej identyfikator pakietu.
- Zaloguj się w swojej aplikacji, otwórz czat i zapytaj „Kiedy odnowi się moja subskrypcja?”.
Co jest chronione
- Twój klucz i sekret do podpisywania są przechowywane w postaci zaszyfrowanej, a klucz nigdy więcej nie jest pokazywany. Rozłączenie usuwa oba.
- Informacja o tym, kim jest klient, trafia z wiadomości do narzędzia zapieczętowana: tylko dla tej rozmowy i tej osoby, i tylko na kilka minut. Nic, co padnie na czacie, nie może jej zmienić.
- Token jest sprawdzany przy każdej wiadomości: odrzucany jest każdy token, który nie jest podpisany Twoim sekretem, wygasł albo jest ważny dłużej niż 24 godziny.
- Jeśli RevenueCat przestanie akceptować klucz, chatbot proponuje przekazanie rozmowy człowiekowi, a karta prosi o nowy klucz.
- Chatbot nie może anulować subskrypcji, zmienić jej ani zwrócić za nią pieniędzy.
Aby zakończyć, wyłącz Subscription tool albo kliknij Disconnect, by usunąć zapisany klucz i sekret; potem usuń klucz także w RevenueCat. Inne usługi, z którymi może się połączyć chatbot, znajdziesz na stronie Połączenia.