> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# OAuth pour le chat

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

> [card] [Guide OAuth complet](https://docs.whop.com/fr/developer/guides/oauth.md)
>
> 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

> [!WARNING]
>
> 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.

> [tab] API
>
> Utilisez l'endpoint [Create App](https://docs.whop.com/fr/api-reference/apps/create-app.md) pour créer une application OAuth par programmation :
>
> ```typescript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const app = await client.apps.create({
>   name: "My App",
>   redirect_uris: [
>     "http://localhost:3000/api/auth/callback/whop",
>     "https://myapp.com/api/auth/callback/whop"
>   ],
> });
>
> console.log(app.id);            // App ID
> console.log(app.client_secret); // Client Secret
> ```
>
> Mettez à jour les URI de redirection ultérieurement avec l'endpoint [Update App](https://docs.whop.com/fr/api-reference/apps/update-app.md).

> [tab] Tableau de bord
>
> **1. Créer ou sélectionner votre application**
>
> Enregistrez votre application dans le [tableau de bord Whop](https://whop.com/dashboard/) > 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.

```typescript theme={null}
async function getToken() {
  const response = await fetch("/api/token");
  const data = await response.json();
  return data.token;
}
```

Consultez le [guide OAuth](https://docs.whop.com/fr/developer/guides/oauth.md) 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.

```swift theme={null}
.task {
    await WhopSDK.configureWithOAuth(
        appId: "app_XXXXXXXXXXXXXX",
        scopes: [
            "openid", "profile", "email",
            "chat:message:create", "chat:read",
            "dms:read", "dms:message:manage", "dms:channel:manage",
            "support_chat:read", "support_chat:message:create",
        ]
    )
}
```

Par défaut, le SDK utilise votre bundle identifier pour l'URI de redirection (`com.yourapp.bundle://oauth/callback`). Vous pouvez la personnaliser :

```swift theme={null}
await WhopSDK.configureWithOAuth(
    appId: "app_XXXXXXXXXXXXXX",
    redirectUri: "myapp://auth/callback",
    scopes: [
        "openid", "profile", "email",
        "chat:message:create", "chat:read",
        "dms:read", "dms:message:manage", "dms:channel:manage",
        "support_chat:read", "support_chat:message:create",
    ]
)
```

Assurez-vous que l'URI de redirection correspond à celle que vous avez configurée dans le [tableau de bord Whop](https://whop.com/dashboard/) > 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 :

```swift theme={null}
// Sign in
try await WhopSDK.signIn()

// Sign out
WhopSDK.signOut()
```

### Suivre l'état d'authentification

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

```swift theme={null}
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.

```swift theme={null}
let tokens = await myBackend.getWhopTokens(for: currentUser)

try await WhopSDK.preSignIn(
    accessToken: tokens.accessToken,
    refreshToken: tokens.refreshToken
)
```

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

> [card] [Authentification](https://docs.whop.com/fr/developer/guides/chat/authentication.md)
>
> Comparez OAuth et les jetons limités à un compte pour le chat intégré.

> [card] [Guide OAuth général](https://docs.whop.com/fr/developer/guides/oauth.md)
>
> Implémentez le flux OAuth complet, l'échange de jetons, leur rafraîchissement et leur révocation.

> [card] [Élément Chat](https://docs.whop.com/fr/developer/guides/chat/chat-element.md)
>
> Découvrez les props, événements, styles et options de liens profonds de l'interface de chat.

> [card] [Démarrage rapide du chat intégré](https://docs.whop.com/fr/developer/guides/chat/quickstart.md)
>
> Affichez votre première expérience de chat intégré.


## Related topics

- [Démarrage rapide du chat](https://docs.whop.com/fr/developer/guides/chat/quickstart.md)
- [Synchroniser les utilisateurs avec le chat intégré](https://docs.whop.com/fr/developer/guides/chat/sync-users.md)
- [OAuth](https://docs.whop.com/fr/developer/guides/oauth.md)
