Authentifiez les utilisateurs du chat intégré avec OAuth Whop et une connexion gérée par le SDK.
Avec OAuth, les utilisateurs se connectent eux-mêmes à Whop via une page de connexion ou une webview iOS. Votre application reçoit des jetons utilisateur Whop qui peuvent authentifier le chat intégré et agir au nom de l’utilisateur connecté.Utilisez OAuth lorsque votre application a besoin d’accéder au compte Whop de l’utilisateur, ou lorsque vous ne souhaitez pas générer de jetons utilisateur limités à un compte depuis votre propre backend.
Guide OAuth complet
Consultez le guide OAuth général pour le flux complet OAuth 2.1 + PKCE, l’échange de jetons, leur rafraîchissement et leur révocation.
Configuration
L’objet App renvoyé par apps.create dans la version actuelle de @whop/sdk n’expose pas de champ client_secret. Copiez plutôt le secret client depuis l’onglet Tableau de bord.
API
Tableau de bord
Utilisez l’endpoint Create App pour créer une application OAuth par programmation :
Mettez à jour les URI de redirection ultérieurement avec l’endpoint Update App.
1
Créer ou sélectionner votre application
Enregistrez votre application dans le tableau de bord Whop > Developer pour obtenir un ID d’application.
2
Ajouter une URL de redirection
Dans l’application que vous avez créée, ouvrez OAuth et ajoutez une URL de redirection.
Pour les applications React ou JavaScript vanilla, utilisez l’URL de callback de votre application, par exemple https://yourapp.com/oauth/callback.
Pour les applications Swift, utilisez votre bundle ID, par exemple com.yourapp.bundle://oauth/callback, ou configurez une URI de redirection personnalisée.
3
Sélectionner les scopes
Sur la même page, copiez les scopes requis depuis View available scopes.
Scopes requis
Votre configuration OAuth doit inclure ces scopes :
Scope
Usage
openid, profile, email
Informations de profil de base
chat:message:create, chat:read
Canaux
dms:read, dms:message:manage, dms:channel:manage
Messages privés
support_chat:read, support_chat:message:create
Chats d’assistance
Endpoint de jeton web
Votre serveur doit fournir un endpoint de jeton qui renvoie un jeton OAuth valide avec les scopes requis. Les éléments de chat React et JavaScript vanilla appellent cette fonction chaque fois qu’ils doivent s’authentifier.
async function getToken() { const response = await fetch("/api/token"); const data = await response.json(); return data.token;}
Consultez le guide OAuth pour implémenter l’échange de jetons côté serveur.
OAuth géré par le SDK sur iOS
Appelez configureWithOAuth au lancement de l’application. Le SDK gère l’ensemble du flux : affichage d’une webview de connexion, obtention des jetons et rafraîchissement automatique.
Assurez-vous que l’URI de redirection correspond à celle que vous avez configurée dans le tableau de bord Whop > Developer > App > OAuth.Lorsqu’un utilisateur accède à une vue de chat, le SDK déclenche automatiquement le flux OAuth s’il n’est pas déjà authentifié. Vous pouvez aussi déclencher manuellement la connexion et la déconnexion :
Utilisez le modificateur .whopAuthState pour suivre de manière réactive si l’utilisateur s’est connecté :
struct ChatView: View { @State private var isAuthenticated = false var body: some View { VStack { if isAuthenticated { Text("Signed In") } else { Text("Not Signed In") } } .whopAuthState($isAuthenticated) }}
Préremplir les jetons
Si vous disposez déjà des jetons Whop de l’utilisateur provenant d’une autre source, vous pouvez les préremplir pour éviter la webview de connexion au premier lancement. Ces sources peuvent être un flux OAuth web ou des jetons synchronisés depuis votre backend. Cette étape est facultative et ne concerne que les utilisateurs qui se sont déjà authentifiés auprès de Whop ailleurs.
Le SDK extrait la date d’expiration du jeton à partir du JSON Web Token (JWT) et gère automatiquement le rafraîchissement. Si le SDK ne parvient pas à rafraîchir des jetons préremplis expirés, le flux OAuth normal démarre.
Étapes suivantes
Authentification
Comparez OAuth et les jetons limités à un compte pour le chat intégré.
Guide OAuth général
Implémentez le flux OAuth complet, l’échange de jetons, leur rafraîchissement et leur révocation.
Élément Chat
Découvrez les props, événements, styles et options de liens profonds de l’interface de chat.
Démarrage rapide du chat intégré
Affichez votre première expérience de chat intégré.
Assistant
Responses are generated using AI and may contain mistakes.