Skip to main content
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.
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.

Scopes requis

Votre configuration OAuth doit inclure ces scopes :

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.
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.
Par défaut, le SDK utilise votre bundle identifier pour l’URI de redirection (com.yourapp.bundle://oauth/callback). Vous pouvez la personnaliser :
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 :

Suivre l’état d’authentification

Utilisez le modificateur .whopAuthState pour suivre de manière réactive si l’utilisateur s’est connecté :

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é.