TikTok

TikTok Entegrasyonu, TikTok Business Messaging API altyapısı üzerinden TikTok Business hesabınıza gelen direkt mesajları (DM) Supsis AI omnichannel iletişim platformuna bağlayan yeni nesil bir iletişim kanalıdır.

Bu entegrasyon sayesinde işletmeler, TikTok mobil uygulamasındaki gelen kutusunu sürekli takip etmek zorunda kalmadan tüm müşteri mesajlarını diğer kanallarla (WhatsApp, Instagram, Telegram, Canlı Destek, E-posta vb.) aynı Supsis gelen kutusunda toplar. Gelen talepler ortak temsilci havuzuna dağıtılabilir, Chatbot senaryolarıyla 7/24 otomatik yanıtlanabilir ve kapsamlı müşteri hizmetleri raporlarına dahil edilebilir. Kanal ilk bağlandığında son 90 günün konuşma geçmişi de otomatik olarak Supsis'e aktarılır.

ℹ️ Kapsam Notu: Bu doküman TikTok Entegrasyonunun Direkt Mesajlaşma (DM) yeteneklerini, bağlantı gereksinimlerini, 48 saatlik mesajlaşma penceresini ve mesaj limitlerini kapsamaktadır. TikTok Yorum/Mention yönetimi, TikTok Otomatik Mesajlar (Karşılama Mesajı / Önerilen Sorular / Sohbet İpuçları) ve TikTok Leads özellikleri ayrı bölümlerde ele alınmaktadır.

1- TikTok Entegrasyonuna Genel Bakış

1.a – TikTok Entegrasyonu Nedir ve Amacı

TikTok, özellikle dinamik ve genç kitleye hitap eden e-ticaret ve hizmet markaları için hızla büyüyen bir satış ve iletişim kanalıdır. Ancak standart TikTok mobil uygulamasının gelen kutusu bir kurumsal müşteri destek aracı değildir: * Birden fazla temsilciye sohbet atanamaz, * Hazır yanıt şablonları, Chatbot otomasyonları veya CRM kişi kartı entegrasyonu bulunmaz, * Yanıt süreleri, çözüm oranları ve temsilci performansı raporlanamaz, * İletişim tek bir fiziksel mobil cihaza veya yetkiliye bağımlı kalır.

Supsis TikTok Entegrasyonu, resmi TikTok Business Messaging API üzerinden doğrudan OAuth ile bağlanarak TikTok DM iletişimini kurumsal, çok kullanıcılı ve denetlenebilir bir omnichannel müşteri destek hattına dönüştürür.

1.b – İki Yönlü Çalışma Mimarisi ve İletişim Akışı

Entegrasyon iki temel eksende kesintisiz olarak çalışır:

1.c – Terimler Sözlüğü

Entegrasyon ekranlarında, TikTok geliştirici altyapısında ve dokümantasyonda geçen temel kavramlar aşağıdaki tabloda açıklanmıştır:

2- Bağlantı Öncesi 3 Kritik Koşul ve Gereksinimler

TikTok kanalınızı Supsis'e bağlamadan önce TikTok tarafında aşağıdaki 3 teknik ve operasyonel koşulun eksiksiz sağlandığından emin olunmalıdır. Bu koşullardan biri dahi sağlanmazsa entegrasyon mesaj alamaz veya bağlantı kurulamaz.

2.a – 1. Koşul: TikTok Hesabının "Business Hesabı" Olması

TikTok Business Messaging API yalnızca Business (İşletme) hesaplarında çalışır. Bireysel (Personal) veya İçerik Üretici (Creator) hesaplarında TikTok API erişimine izin vermez.

• Hesap Türünü Kontrol Etme ve Business Hesabına Geçiş:
• TikTok mobil uygulamasını açın ve profilinize gidin.
• Sağ üstteki Menü (☰) simgesine dokunun.
• Ayarlar ve gizlilik → Hesap → Hesabı değiştir yolunu izleyin.
• İşletme Hesabına Geç (Switch to Business Account) seçeneğini seçin ve sektör kategorinizi belirleyerek işlemi tamamlayın.

⚠️ Önemli: Hesabınız kişisel hesapta kaldığı sürece TikTok bağlantı ekranında onay verseniz dahi API erişimi engellenecektir.

2.b – 2. Koşul: "Herkesten Direkt Mesaj Al" Ayarının Açık Olması

Entegrasyon kurulduktan sonra en sık karşılaşılan "Bağlantı başarılı ama müşterilerin mesajları Supsis'e düşmüyor" probleminin temel sebebi mobil gizlilik ayarlarıdır. TikTok gizlilik kuralları gereği, eğer gelen kutunuz yalnızca takipçilere veya karşılıklı arkadaşlara açıksa, TikTok harici webhook tetiklemesini devre dışı bırakır. İşletme profilinizin herkese açık mesaj alabilmesi için TikTok mobil uygulamasından 4 kritik ayarın tamamlanması gerekir.

Adım Adım Mobil Yapılandırma

1. Ayarlar ve Gizlilik Ekranına Erişim (Genel Ekran):
2. TikTok mobil uygulamasını açın ve profilinize gidin.
3. Sağ üst köşedeki Menü (☰) simgesine dokunun ve Ayarlar ve gizlilik (Settings and privacy) menüsünü seçin.
4. Etkileşimler (Interactions) grubu altında yer alan Direkt mesajlar (Direct messages) seçeneğine dokunun.

1. Direkt Mesaj Ayarlarının Yapılandırılması:
2. Açılan Direkt mesajlar (Direct messages) ekranı, mesajlaşma izinlerinin ve bildirim tercihlerinin yönetildiği ana merkezdir.
3. Bu ekranda İzin ayarları (Permission settings) ve Etkinlik durumu (Activity status) alanları kontrol edilmelidir.
4. Ayrıca Güvenli mod (Safe mode) seçeneğinin kapalı (Off) olduğundan emin olunmalıdır. Güvenli mod açık olduğunda, yeni kullanıcılardan gelen talepler doğrudan gelen kutusu yerine filtrelenmiş isteklere düşerek webhook bildirimini geciktirebilir.

1. Etkinlik Durumu (Activity Status) - Public Yapılandırması:
2. Direkt mesajlar menüsünden Etkinlik durumu (Activity status) seçeneğine dokunun.
3. Karşınıza gelen seçeneklerden mutlaka Herkese Açık (Public) seçeneğini işaretleyin.
4. Bu seçenek sayesinde hesabınızın çevrim içi durumu TikTok ağında herkese açık görünür ve gelen mesaj oturumları beklemeden aktif kanala iletilir.

1. Mesajlaşma İzin Ayarları (Permission Settings) - Herkesten Mesaj Alma:
2. Direkt mesajlar menüsünden İzin ayarları (Permission settings) seçeneğine dokunun.
3. Size kimler mesaj gönderebilir? (Who can send you messages) başlığı altındaki iki ayarı da Gelen Kutusu (Inbox) olarak belirleyin:
   • Potansiyel bağlantılar (Potential connections) → Gelen Kutusu (Inbox)
   • TikTok'taki diğer kullanıcılar (Others on TikTok) → Gelen Kutusu (Inbox)
4. Bu sayede sizi henüz takip etmeyen potansiyel müşteriler dahil TikTok üzerindeki herhangi bir kullanıcı profilinize mesaj gönderdiğinde talep doğrudan ana gelen kutusuna ve anlık olarak Supsis paneline düşer.

Gerekli Mobil Ayarlar Özeti

🛑 Kritik Kontrol: İzin ayarlarında "Others on TikTok" veya "Potential connections" alanları kısıtlıysa ("Hiç kimse" veya "Sadece Arkadaşlar"), TikTok sunucuları Supsis'e mesaj webhook'u iletmez. Entegrasyonun sessizce çalışmama ihtimalini önlemek için bu dört ekranın ayarlarını yukarıdaki gibi eksiksiz tamamlayın.

2.c – 3. Koşul: Bölge ve Ülke Kısıtı

TikTok, Business Messaging API kapsamını bölgesel veri düzenlemeleri nedeniyle sınırlandırmıştır. Aşağıdaki bölge ve ülkelerde kayıtlı TikTok hesapları TikTok tarafından bu API kapsamına alınmamıştır: * AEA (Avrupa Ekonomik Alanı) ülkeleri, * İsviçre, * Birleşik Krallık (UK), * Amerika Birleşik Devletleri (ABD).

ℹ️ Bölge Uyarısı: Bu ülkelerden açılmış bir TikTok hesabı Supsis'e bağlansa dahi TikTok sunucuları mesaj alışverişini bloklar ve mesaj akışı gerçekleşmez.

2.d – Paket ve Kanal Lisansı Şartı

TikTok Entegrasyonu ayrı bir kanal lisansına bağlıdır: * Panelinizde Faturalandırma → Paketler → TikTok alanında tanımlı kanal kotanız kadar TikTok hesabı bağlayabilirsiniz (x / y kanal). * Kotanız dolduğunda yeni kanal eklemek için paketinizi yükseltmeniz gerekir. * Paketinize bağlı olarak "Gelen kutusunu yönet", "Chatbot ile yönet" ve "Yorumdan mesaja" yetkileri dinamik olarak etkinleşir.

3- TikTok Kanalını Supsis'e Bağlama Adımları

3.a – Entegrasyon Menüsüne Erişim

1. Supsis Müşteri Panelinize giriş yapın.
2. Sol ana menüden Entegrasyonlar seçeneğine tıklayın.
3. Sosyal Medya grubu altında yer alan TikTok Entegrasyonu kartını bulun ve tıklayın.

3.b – Yeni Kanal Ekleme ve Koşul Onayı

1. Açılan TikTok Kanalları ekranında sağ üst köşedeki + Kanal Ekle butonuna basın.
2. Karşınıza 3 ön koşul maddesini ve yasal bilgilendirmeleri içeren modal açılır.
3. TikTok Hizmet Şartları, TikTok Gizlilik Politikası ve Supsis sözleşme onay kutusunu işaretleyin.
4. TikTok'a Bağlan butonu aktif hale gelecektir; butona tıklayın.

3.c – Resmi TikTok OAuth İzinlerinin Verilmesi

Açılan güvenli TikTok OAuth penceresinde oturum açın. TikTok, Supsis'in talep ettiği şu 3 izin kapsamını listeler:

• message.list.read — Gelen konuşmaları ve mesaj geçmişini okuma yetkisi.
• message.list.send — Kullanıcılara Supsis üzerinden yanıt mesajı gönderme yetkisi.
• message.list.manage — Konuşmaları yönetme, okundu işaretleme ve yapılandırma yetkisi.

Yetkilendir (Authorize) butonuna bastığınızda TikTok penceresi otomatik kapanır ve Supsis kanal sihirbazına dönüş yapılır.

3.d – Kanalı Kaydetme ve Detay Ayarları

1. Modal ekranında bağlanan TikTok hesap bilgisi (kullanıcı adı ve profil fotoğrafı) görünür.
2. Kanalı Oluştur butonuna basarak kurulumu tamamlayın.
3. Kanal listesinde yeni kanalınız belirecektir. Kanala tıklayarak detay ayarlarını yapabilirsiniz:

• Kanal Adı: Temsilcilerinizin panoda göreceği özel bir tanımlayıcı isim (Örn: TikTok Türkiye Resmi).
• Yönlendirme Modu: Gelen mesajların doğrudan temsilciye mi yoksa Chatbot akışına mı iletileceğini belirleyin.
• Görünürlük Sekmesi: Bu kanaldan gelen mesajları hangi departman veya temsilcilerin görüp yanıtlayabileceğini seçin.

4- Sohbet Ekranında TikTok İletişimi ve Özel Kurallar

4.a – Kişi Kartı ve Kanal Görünümü

Gelen her yeni TikTok mesajında sistem otomatik olarak müşteri profili oluşturur: * Sohbet listesinde ilgili konuşmanın yanında siyah TikTok ikonu yer alır. * Müşterinin TikTok kullanıcı adı (@username), profil fotoğrafı ve kanal bilgisi sağ taraftaki Supsis Kişi Kartında toplanır. * Müşteri daha önce web sitesinden veya WhatsApp'tan yazmışsa, numarası veya ortak verisi üzerinden mevcut profiliyle birleştirilebilir.

4.b – İşletmenin İlk Mesajı Başlatamaması Kuralı

TikTok platform politikası gereği sohbeti her zaman son kullanıcı başlatmak zorundadır: * İşletmeler bir TikTok kullanıcısına durduk yere "soğuk mesaj" (cold outbound) veya toplu pazarlama mesajı atamaz. * Kullanıcı işletme hesabına DM atmadan Supsis panelinden o kullanıcıya konuşma başlatılamaz. * Böyle bir işlem denenirse sistem anında şu uyarıyı üretir ve gönderimi durdurur:
"İşletme konuşma başlatamaz, kullanıcının önce yazması gerekir."

4.c – Echo Mesaj Desteği (Mobil Uygulama Eşitlemesi)

Eğer bir yetkili Supsis paneli yerine doğrudan TikTok mobil uygulamasını açarak bir müşteriye DM yanıtı verirse: * Supsis bu giden mesajı anlık olarak yakalar (Echo Mesaj). * Mesaj Supsis sohbet akışına işlenir; böylece konuşma geçmişinde kopukluk yaşanmaz. * Önemli: TikTok uygulamasından elle atılan bu mesajlar da 48 saatlik mesajlaşma sayacından düşülür.

4.d – Reklam Kaynağı Takibi (TikTok Ads Attribution)

Kullanıcı işletmenize bir TikTok Reklamı (Spark Ads, Lead Generation veya DM hedefli reklamlar) üzerinden mesaj gönderdiyse: * Supsis reklam parametrelerini (Ad ID, Campaign ID) yakalar. * Kişi kartına ve sohbet detayına reklam kaynağı etiketi işlenir. * Böylece hangi reklam kreatifinin gerçek müşteri ve satış getirdiği analiz edilebilir.

5- 48 Saatlik Mesajlaşma Penceresi ve Mesaj Limitleri

TikTok, işletmelerin kullanıcıları spam veya rahatsız edici mesajlarla boğmasını engellemek için katı bir mesajlaşma penceresi ve kota mekanizması uygular. Supsis, bu kuralları gönderme anından önce denetler ve kural ihlali durumunda mesajı TikTok'a iletmeden temsilciye hata gösterir.

5.a – 48 Saat Kuralının Mantığı

5.b – 10 Mesaj Sınırı ve 11. Mesajdaki Limit Uyarısı

Kullanıcı bir mesaj attıktan sonra işletme peş peşe yanıt vermeye devam ederse: 1. Temsilci 1. mesajdan 10. mesaja kadar sorunsuzca mesaj gönderebilir. 2. 10 mesaj gönderildikten sonra müşteri henüz yeni bir yanıt yazmadıysa kota dolar. 3. 11. mesaj gönderilmeye çalışıldığında mesaj gönderilmez; sohbette Başarısız (Failed) olarak işaretlenir. 4. Sohbet ekranının üstünde ve mesaj altında şu bilgilendirme şeridi çıkar:
"TikTok 48 saatlik mesajlaşma penceresi kapandı. Sınırlı sayıda mesaj gönderebilirsiniz, müşteriden yanıt bekleniyor."

6- Desteklenen ve Desteklenmeyen Mesaj Tipleri

TikTok Business Messaging API'nin desteklediği formatlar ile desteklemediği formatlar aşağıdaki tabloda detaylandırılmıştır:

6.a – Karşılaştırmalı Mesaj Tipleri Tablosu

6.b – Desteklenmeyen İçerik Gönderildiğinde Temsilci Uyarısı

Temsilci Supsis panelinden TikTok müşterisine desteklenmeyen bir dosya türü (video, ses kaydı, PDF belgesi veya konum) göndermeye çalıştığında: * Gönderim engellenir. * Arayüzde şu sistem uyarısı belirir:
"TikTok üzerinden yalnızca metin, resim ve buton kartı gönderilebilir. Video ve dosya formatları desteklenmemektedir."

7- Geçmiş Mesaj Senkronizasyonu (Sync)

TikTok kanalınız Supsis'e ilk kez bağlandığı anda, arka planda otomatik bir geçmiş aktarım servisi devreye girer. Bu işlem kanal kurulumunu bekletmez.

• Aktarım Limitleri (TikTok API Sınırları):
• Zaman Kapsamı: Son 90 gün içindeki konuşmalar aktarılır.
• Konuşma Sayısı: En fazla son 100 konuşma çekilir.
• Mesaj Derinliği: Konuşma başına en son 20 mesaj aktarılır.
• Hız Limiti Koruması (Rate Limiting): TikTok API kotalarına takılmamak adına aktarım saniyede 1 istek (1 req/sec) hızında sıralı olarak işlenir.
• Mükerrer Kayıt Önleme (Dedup): Aynı mesaj hem geçmiş aktarımıyla hem de canlı webhook ile gelse dahi sistem mükerrer kayıt oluşturmaz.

8- Chatbot ile TikTok Kanalı Yönetimi

TikTok kanalınızı Supsis Chatbot modülü ile entegre ederek 7/24 otomatik karşılama ve yönlendirme sağlayabilirsiniz.

8.a – Kanal Yönlendirme Modları

Kanal detayında Yönlendirme Modu şu seçeneklere ayarlanabilir: 1. Yalnızca Canlı Temsilci: Mesajlar doğrudan temsilci havuzuna düşer. 2. Yalnızca Chatbot: Tüm mesajları Chatbot karşılar; gerekirse temsilciye aktarır. 3. Hibrit Mod: Çalışma saatleri içinde canlı destek, mesai dışında Chatbot yanıt verir.

8.b – Chatbot Bloklarının TikTok Uyumlandırması

TikTok'un mesajlaşma kuralları standart web sohbetinden farklı olduğu için Chatbot blokları otomatik adapte edilir:

• Buton Blokları: TikTok'un Buton Kartına (QA Button Card) dönüştürülür. TikTok kuralı gereği kart başına en fazla 3 buton yer alabilir. Blokta 3'ten fazla buton varsa sistem otomatik olarak ardışık birden fazla karta böler.
• Karusel / Galeri Blokları: TikTok yatay kaydırmalı karusel desteklemediği için sıralı görsel mesajları ve ardından buton kartı olarak iletilir.
• Konum İsteme Blokları: TikTok konum paylaşımını desteklemediği için düz açıklama metnine çevrilir.
• Önerilen Sorular: Kanal detayındaki "Önerilen Sorular" sekmesinden müşterinin sohbeti açtığında göreceği hazır soru butonları tanımlanabilir.

9- Bağlantı Sürekliliği, Güvenlik ve Token Yönetimi

• Token Yaşam Döngüsü:
• TikTok Access Token süresi 1 gündür.
• TikTok Refresh Token süresi yaklaşık 1 yıldır.
• Supsis sunucuları her saat başı arka planda bir kontrol görevi çalıştırır. Süresinin bitmesine 2 saatten az kalan tüm token'ları TikTok API üzerinden otomatik yeniler. Kullanıcının manuel işlem yapmasına gerek kalmaz.
• Yetki İptali ve Pasife Düşme:
• İşletme yöneticisi TikTok mobil uygulamasından veya Business Suite'ten Supsis uygulamasının izinlerini iptal ederse yenileme başarısız olur.
• Kanal otomatik olarak Token Geçersiz (Token-Invalid) durumuna düşer ve pasiflenir. Bu durumda kanal detayından tek tıkla yeniden bağlanılması gerekir.
• Kanal Silme Durumunda Veri Güvenliği:
• Bir TikTok kanalı Supsis panelinden silindiğinde daha önce aktarılmış olan konuşma ve müşteri kişi kartları silinmez, geçmişte saklanmaya devam eder. Yalnızca yeni mesaj akışı ve gönderim durur.

10- Kullanım Senaryoları ve İş Değeri

11- Sorun Giderme (Troubleshooting) Rehberi

11.a – "Kanalı bağladım ancak TikTok'tan gelen mesajlar Supsis'e düşmüyor"

1. "Herkesten DM Al" Ayarını Kontrol Edin: TikTok uygulamasında Ayarlar ve gizlilik → Gizlilik → Direkt mesajlar bölümünün "Herkes" olarak seçildiğinden emin olun. Bu ayar kapalıysa webhook gelmez.
2. Hesap Türünü Kontrol Edin: Hesabın "Business Hesabı" olduğundan emin olun (Kişisel ve Creator hesaplar mesaj iletmez).
3. Bölge Kısıtını İnceleyin: Hesabın AEA ülkeleri, İngiltere, İsviçre veya ABD kayıtlı olmadığından emin olun.

11.b – "Mesaj gönderilemiyor, pencere kapandı uyarısı alıyorum"

• Müşterinin son mesajının üzerinden 48 saat geçmiş ve 3 takip mesajı hakkınız dolmuş olabilir. Müşteri yeni bir mesaj yazana kadar TikTok API gönderimi kilitler. Müşterinin yanıt vermesini bekleyin. Mobil uygulama üzerinden mesaj göndermeye devam edebilirsiniz. Sınırlar Supsis paneli üzerinden gönderilen mesajlar için geçerlidir.

11.c – "Video veya PDF belgesi gönderemiyorum"

• TikTok Business Messaging API işletmelerin video, ses kaydı, dosya veya konum göndermesine izin vermemektedir. Müşterinize bilgi vermek için görsel (JPG/PNG) veya link kartı formatını kullanın.

11.d – "Kanal pasife düştü / Token geçersiz hatası alıyorum"

• TikTok hesabınızın şifresi değişmiş veya TikTok Güvenlik ayarlarından üçüncü taraf uygulama izinleri sıfırlanmış olabilir. Supsis panelinde Entegrasyonlar → TikTok Kanalları → İlgili Kanal yolunu izleyip Yeniden Bağlan butonuna basarak OAuth onayını tazeleyin.