Bu rehberde: TikTok hesabınızı bağlarsınız. TikTok yalnızca video kabul eder; Content Creator açıklama yazar, videoyu siz sağlarsınız. Uygulama denetimi öncesi videoların yalnızca size görüneceğini öğrenirsiniz.
⏱ 20 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | TIKTOK |
| Kategori | Sosyal medya |
| Kimlik doğrulama | İzin ekranı (OAuth 2.0) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Video yayınlama, metrik okuma |
| Kullanan kutular | Yayınla, Zamanla, Metrik al |
| Kullanan ajanlar | Content Creator (açıklama), Social Publisher |
Ne işe yarar?
TikTok hesabınıza video yükler (adresten çekme veya dosya yükleme), açıklama ve gizlilik ayarlarını belirler; görüntüleme, beğeni, yorum ve paylaşım sayılarını okur.
Ön koşullar
- TikTok hesabı (kişisel veya işletme).
- developers.tiktok.com geliştirici hesabı.
- Platform yöneticisinin
TIKTOK_CLIENT_KEYveTIKTOK_CLIENT_SECRETtanımlamış olması. - Canlı kullanım için uygulama denetimi (audit). Denetim öncesi yayınlar yalnızca oluşturan kullanıcıya görünür.
Adım adım kurulum
A) TikTok for Developers (platform yöneticisi)
- Manage apps → ① Connect an app → ad, açıklama, kategori, simge.
- ② Platforms: Web; Website URL: uygulama alan adınız.
- ③ Add products: Login Kit ve Content Posting API. Metrikler için Display API de ekleyin.
- Login Kit → ① Redirect URI:
https://api.orqlabs.com/api/v1/integrations/oauth/tiktok/callback. TikTok yalnızca HTTPS kabul eder;localhostreddedilir. - ② Domain verification: videoları adresten çektirmek için medya alan adınızı TikTok'un verdiği
tiktok-developers-site-verificationTXT kaydıyla doğrulayın.
- ① Scopes:
user.info.basic,video.publish,video.list. - ② Content Posting API → Direct Post seçin (taslak kutusu yerine doğrudan yayın).
- ③ App review → Submit for review: kullanım açıklaması ve demo video ile gönderin.
- App details bölümünden ① Client key ve ② Client secret değerlerini yöneticiye iletin;
TIKTOK_CLIENT_KEYveTIKTOK_CLIENT_SECRETolarak tanımlanır.
B) OrqLabs'ta bağlama
- Entegrasyonlar → TikTok → Bağla.
- ① Proje seçin; ② Bağla.
- TikTok yetkilendirme ekranında giriş yapın; izinleri onaylayın.
- Kart Bağlı olur. Bağlantıyı test et: kullanıcı adı ve takipçi sayısı görünmelidir.
Erişim 24 saat, yenileme izni 365 gün geçerlidir; OrqLabs otomatik yeniler.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
user.info.basic | Profil bilgisi |
video.publish | Video yayınlama |
video.list | Yayınlanan videoları ve istatistiklerini listeleme |
Uygulama denetimi
Dikkat: Denetim öncesi yüklenen videolar zorunlu olarak yalnızca size görünür (SELF_ONLY). Herkese açık yayın için denetim şarttır.
- Denetim: TikTok, içeriğin kullanıcı onayından geçtiğini ve gizlilik ayarının gösterildiğini ister. OrqLabs onay adımını videoda gösterin. Süre 1-3 hafta.
- Alan adı doğrulaması olmadan adresten çekme reddedilir; OrqLabs dosyayı indirip yükler (daha yavaş).
Limitler
| Konu | Sınır |
|---|---|
| Yayın kotası | Kullanıcı başına 24 saatte yaklaşık 15 gönderi; dakikada 6 istek |
| Açıklama | 2.200 karakter; hashtag 5 |
| Video | MP4/WebM/MOV, 3 sn – 10 dk, en fazla 4 GB, 9:16 önerilir, 1080p |
| Medya | Yalnızca video |
| Gizlilik | PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY; denetim öncesi zorla SELF_ONLY |
| İşleme | Yayın sonrası 1-5 dk |
| Metrik | Son 20 video/sayfa; saatlik güncellenir |
Bağlantıyı test etme
② Bağlantıyı test et profil bilgisini ve kalan izin süresini gösterir. İlk yayında test modunda video adresinin erişilebilirliğini doğrulayın; sonra kısa bir test videosunu SELF_ONLY gizlilikle yayınlayın. Gizlilik değeri öğeden okunur: {{ $json.privacy ?? "PUBLIC_TO_EVERYONE" }}.
Kimlik bilgilerini yenileme
- Yenileme izni 365 gün. Kullanıcı TikTok → Ayarlar → Güvenlik → Bağlı uygulamalar üzerinden erişimi kaldırırsa Yeniden yetkilendir.
- Client secret döndürülürse yönetici
.env'i günceller; mevcut bağlantılar çalışmaya devam eder.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "redirect_uri is not registered" | Adres eşleşmiyor veya HTTP | HTTPS adresi Login Kit'e ekleyin |
AUTH – access_token_invalid | Yenileme başarısız | Yeniden yetkilendir |
INVALID – url_ownership_unverified | Medya alan adı doğrulanmamış | Doğrulama yapın veya OrqLabs yüklemesini kullanın |
INVALID – unaudited_client_can_only_post_to_private_accounts | Denetim yok | Denetim gönderin; geçici SELF_ONLY |
RATE_LIMIT – spam_risk_too_many_posts | Kota | Sıklığı düşürün |
INVALID – video_format_check_failed | Kodek, çözünürlük, süre | H.264, 30/60 fps, 1080p, 10 dk altı |
| "PROCESSING_DOWNLOAD" takıldı | Adres yavaş | Medyayı CDN'e alın; zaman aşımı 600000 |
| İstatistikler boş | video.list yok / Display API eksik | Ürünü ve kapsamı ekleyip yeniden yetkilendirin |
Sık sorulan sorular
Görsel gönderi paylaşabilir mi? Hayır. TikTok API'si yalnızca video kabul eder.
Videoyu OrqLabs üretir mi?
Hayır. Content Creator açıklama ve senaryo yazar; videoyu siz sağlarsınız (mediaUrls).
Denetim ne kadar sürer? Genellikle 1-3 hafta. O sürede videolar yalnızca size görünür.