TikTok API Kurulumu

TikTok entegrasyonu için admin walkthrough. Son-kullanıcı akışı: Bağlantılar → TikTok.

Genel bakış

Form alanı	Options anahtarı
Client Key	tiktok_client-key
Client Secret	tiktok_client-secret
Status	tiktok_integration_status

ENV fallback: TIKTOK_CLIENT_KEY + TIKTOK_CLIENT_SECRET.

Alan adı "Client Key", "Client ID" değil

TikTok diğer portal'ların Client ID dediği şeye Client Key der. Sosyabot'un form etiketleri TikTok adlandırmasına uygundur.

developers.tiktok.com adım adım

1. Giriş yap ve geliştirici olarak kayıt ol

https://developers.tiktok.com → app'in sahibi olmasını istediğin TikTok hesabıyla giriş yap. Geliştirici şartlarını kabul et.

2. Yeni app oluştur

Manage apps → Connect an app. Doldur:

• App adı, icon, açıklama.
• App kategorisi (örn. Productivity, Social).
• Platform: Web.
• App website URL'i: https://sosyabot.com.

3. Doğru ürünleri ekle

App'in içinde:

• Login Kit — OAuth için zorunlu.
• Content Posting API — video yayınlamak için zorunlu.

4. URL ayarlarını yapılandır

Login Kit ayarlarında:

• Redirect URIs: alan adını sabitlemeyin. /admin/api-integration/tiktok admin sayfasında gösterilen tam Callback URL'yi (bu kurulum için canlı) kopyalayın. Kalıp:

  <BASE_URL>/api/v1/auth/tiktok/callback

  <BASE_URL> backend URL'iniz; /api/v1 ayarlı API_PREFIX'tir. Bkz. OAuth Callback URL'leri.
• Sosyabot Direct Post akışını kullanır (Inbox değil), ekstra redirect yok.

5. Scope'ları talep et

Gerekli OAuth scope'ları: user.info.basic, video.publish, video.upload. Sandbox app'lar davetli tester'lara bunları anında verir; production app'lar App Review gerektirir (TikTok screencast ve gizlilik/veri-işleme belgesi ister).

6. İncelemeye gönder (yalnızca production)

Sandbox testleri yeşil olduktan sonra app'i incelemeye gönder. Birkaç hafta sürebilir. Onaylanana kadar yalnızca davetli tester hesapları bağlanabilir.

7. Client Key + Client Secret'ı al

App dashboard → App credentials. Client Key ve Client Secret'ı kopyala.

Sosyabot admin paneline yapıştırma

/admin/api-integration/tiktok. Yapıştır, Enable, Save, Test credentials.

Hata: TikTok integration disabled: client key/secret not configured.

Doğrulama

/app/channels → Connect → TikTok → OAuth → onayla. /app/publishing'den 5–10 saniyelik bir mp4 dene.

Sorun giderme

Belirti	Sebep	Çözüm
TikTok integration disabled: client key/secret not configured	Admin + ENV boş	1-7. adımlar.
Connect başarılı ama yayın permission_error ile başarısız	App Sandbox kademesinde	Test hesabını Sandbox tester olarak davet et veya Production review'a gönder.
Onay ekranında redirect_uri_mismatch	Redirect URI uyumsuz	Tam …/api/v1/auth/tiktok/callback ekle.
Video yükleme video_size_too_large döner	Varlık TikTok limitlerini aşıyor	Doğrulanmamış hesaplar için TikTok ~287 MB / 60 sn'de sınırlar; güncel limitleri TikTok docs'ta kontrol et.

ENV fallback

TIKTOK_CLIENT_KEY=<client key'in>
TIKTOK_CLIENT_SECRET=<client secret'in>

.env düzenledikten sonra ./service.sh restart.

İlgili

OAuth Kimlik Bilgileri genel

TikTok kullanıcı bağlantı

OAuth Callback URL'leri