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

# Sohbet OAuth

> Gömülü sohbet kullanıcılarının kimliğini Whop OAuth ve SDK tarafından yönetilen oturum açma ile doğrulayın.

OAuth ile kullanıcılar Whop'ta bir oturum açma sayfası veya bir iOS webview aracılığıyla kendileri oturum açar. Uygulamanız, gömülü sohbette kimlik doğrulayabilen ve oturum açmış kullanıcı adına işlem yapabilen Whop kullanıcı token'ları alır.

Uygulamanızın kullanıcının Whop hesabına erişmesi gerektiğinde veya kendi arka ucunuzdan hesap kapsamlı kullanıcı token'ları oluşturmak istemediğinizde OAuth kullanın.

> [card] [Eksiksiz OAuth kılavuzu](https://docs.whop.com/tr/developer/guides/oauth.md)
>
> Eksiksiz OAuth 2.1 + PKCE akışı, token değişimi, yenileme ve iptal ayrıntıları için genel OAuth kılavuzuna bakın.

## Kurulum

> [!WARNING]
>
> Güncel `@whop/sdk` içinde `apps.create` tarafından döndürülen `App` nesnesi bir `client_secret` alanı sunmaz. Bunun yerine istemci gizli anahtarını Kontrol paneli sekmesinden kopyalayın.

> [tab] API
>
> Programatik olarak bir OAuth uygulaması oluşturmak için [Create App](https://docs.whop.com/tr/api-reference/apps/create-app.md) uç noktasını kullanın:
>
> ```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
> ```
>
> Yönlendirme URI'lerini daha sonra [Update App](https://docs.whop.com/tr/api-reference/apps/update-app.md) uç noktasıyla güncelleyin.

> [tab] Kontrol paneli
>
> **1. Uygulamanızı oluşturun veya seçin**
>
> Bir uygulama kimliği almak için uygulamanızı [Whop Kontrol Paneli](https://whop.com/dashboard/) > Developer bölümünde kaydedin.
>
> **2. Bir yönlendirme URL'si ekleyin**
>
> Oluşturduğunuz uygulamada OAuth bölümünü açın ve bir yönlendirme URL'si ekleyin.
>
> * React veya vanilla JavaScript uygulamaları için uygulamanızın geri çağırma URL'sini kullanın, örneğin `https://yourapp.com/oauth/callback`.
> * Swift uygulamaları için `com.yourapp.bundle://oauth/callback` gibi bundle kimliğinizi kullanın veya özel bir yönlendirme URI'si yapılandırın.
>
> **3. Kapsamları seçin**
>
> Aynı sayfada, gerekli kapsamları **View available scopes** bölümünden kopyalayın.

## Gerekli kapsamlar

OAuth yapılandırmanız şu kapsamları içermelidir:

| Kapsam | Amaç |
| - | - |
| `openid`, `profile`, `email` | Temel profil bilgileri |
| `chat:message:create`, `chat:read` | Kanallar |
| `dms:read`, `dms:message:manage`, `dms:channel:manage` | Doğrudan mesajlar |
| `support_chat:read`, `support_chat:message:create` | Destek sohbetleri |

## Web token uç noktası

Sunucunuzun, gerekli kapsamlara sahip geçerli bir OAuth token'ı döndüren bir token uç noktası sağlaması gerekir. React ve vanilla JavaScript sohbet öğeleri, kimlik doğrulamaya ihtiyaç duyduklarında bu fonksiyonu çağırır.

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

Sunucu tarafı token değişimini uygulamak için [OAuth kılavuzuna](https://docs.whop.com/tr/developer/guides/oauth.md) bakın.

## iOS'ta yazılım geliştirme kiti tarafından yönetilen OAuth

Uygulama başlatıldığında `configureWithOAuth` çağırın. SDK tüm akışı yönetir: bir oturum açma webview'i gösterir, token'ları alır ve onları otomatik olarak yeniler.

```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",
        ]
    )
}
```

Varsayılan olarak SDK, yönlendirme URI'si için bundle tanımlayıcınızı kullanır (`com.yourapp.bundle://oauth/callback`). Bunu özelleştirebilirsiniz:

```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",
    ]
)
```

Yönlendirme URI'sinin [Whop Kontrol Paneli](https://whop.com/dashboard/) > Developer > App > OAuth bölümünde yapılandırdığınız değerle eşleştiğinden emin olun.

Bir kullanıcı bir sohbet görünümüne gittiğinde, henüz kimliği doğrulanmamışsa SDK OAuth akışını otomatik olarak başlatır. Oturum açma ve oturum kapatma işlemlerini manuel olarak da tetikleyebilirsiniz:

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

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

### Kimlik doğrulama durumunu izleme

Kullanıcının oturum açıp açmadığını reaktif olarak izlemek için `.whopAuthState` değiştiricisini kullanın:

```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)
    }
}
```

### Token'ları önceden doldurma

Kullanıcının Whop token'larına başka bir kaynaktan zaten sahipseniz, ilk başlatmada oturum açma webview'ini atlamak için bunları önceden doldurabilirsiniz. Kaynaklar arasında bir web OAuth akışı veya arka ucunuzdan senkronize edilen token'lar bulunur. Bu isteğe bağlıdır ve yalnızca kullanıcılarınızın kimliği başka bir yerde Whop ile zaten doğrulanmışsa geçerlidir.

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

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

SDK, token'ın son kullanma tarihini JSON Web Token'dan (JWT) çıkarır ve yenilemeyi otomatik olarak yönetir. SDK, süresi dolmuş önceden doldurulmuş token'ları yenileyemezse normal OAuth akışı başlar.

## Sonraki adımlar

> [card] [Kimlik doğrulama](https://docs.whop.com/tr/developer/guides/chat/authentication.md)
>
> Gömülü sohbet için OAuth'u hesap kapsamlı token'larla karşılaştırın.

> [card] [Genel OAuth kılavuzu](https://docs.whop.com/tr/developer/guides/oauth.md)
>
> Eksiksiz OAuth akışını, token değişimini, yenilemeyi ve iptali uygulayın.

> [card] [Chat öğesi](https://docs.whop.com/tr/developer/guides/chat/chat-element.md)
>
> Sohbet arayüzünün prop'larını, olaylarını, stillerini ve derin bağlantı seçeneklerini öğrenin.

> [card] [Gömülü sohbet hızlı başlangıcı](https://docs.whop.com/tr/developer/guides/chat/quickstart.md)
>
> İlk gömülü sohbet deneyiminizi görüntüleyin.


## Related topics

- [Sohbet Kimlik Doğrulaması](https://docs.whop.com/tr/developer/guides/chat/authentication.md)
- [OAuth](https://docs.whop.com/tr/developer/guides/oauth.md)
- [List OAuth Grants](https://docs.whop.com/tr/api-reference/users/list-oauth-grants.md)
