TikTok Leads Entegrasyonu; TikTok reklamlarınızda yer alan Instant Form (Anlık Form) üzerinden toplanan potansiyel müşteri (lead) verilerini gerçek zamanlı olarak Supsis AI platformuna aktaran, kişi (kontak) kartlarını otomatik oluşturan ve anında otomasyon akışlarını tetikleyen kurumsal bir reklam entegrasyonudur.
Bu entegrasyon sayesinde TikTok Ads Manager içerisindeki Lead Center'a girip manuel CSV indirme, Excel ile veri temizleme ve CRM sistemlerine elle aktarma zorunluluğu tamamen ortadan kalkar. Formu dolduran kullanıcı saniyeler içinde Supsis'te kişi olarak kaydedilir ve WhatsApp hoş geldin mesajı, satış temsilcisine otomatik atama veya harici CRM senkronizasyonu gibi aksiyonlar anında devreye girer.
Kritik Ayrım: TikTok Leads vs. TikTok DM
| Özellik / Boyut | TikTok DM Entegrasyonu | TikTok Leads Entegrasyonu |
|---|---|---|
| Temel Amaç | İki yönlü müşteri mesajlaşması (sohbet) | Reklamlardan potansiyel müşteri (lead) toplama |
| Kullanılan TikTok Servisi | TikTok Business Messaging API | TikTok Marketing API |
| Menü Konumu | Entegrasyonlar › Sosyal Medya grubu | Entegrasyonlar › Reklam grubu (/integrations/tiktok-leads) |
| Paket ve Lisans | TikTok DM Paketi | TikTok Lead Paketi (/billing/plans/tiktok-lead) |
| Kişi Platform Etiketi | TikTok |
TikTok Leads |
| Yetkilendirme (OAuth) | Mesajlaşma izinleri (message.list.*) |
Reklam hesabı ve lead okuma izinleri |
Önemli Hatırlatma: Panelinizde aktif bir TikTok DM kanalınız bulunsa dahi, TikTok Leads için ayrı bir kanal oluşturulmalı ve ayrı yetkilendirme yapılmalıdır. Çünkü TikTok mesajlaşma ve reklam verilerini iki bağımsız API üzerinden yönetmektedir.
1- TikTok Leads Nedir ve Nasıl Çalışır?
1.a – TikTok Instant Form (Anlık Form) Mantığı
TikTok'ta "Lead Generation" (Potansiyel Müşteri Toplama) hedefiyle reklam kampanyası oluşturduğunuzda, kullanıcılar video reklamınızdaki harekete geçirici mesaja (CTA) tıkladıklarında TikTok uygulamasından ayrılmadan hızlıca açılan yerel bir form ile karşılaşırlar. TikTok bu forma Instant Form veya Instant Page adını verir.
Formu dolduran her kullanıcı bir Lead (Potansiyel Müşteri) haline gelir. Geleneksel iş akışında bu lead'lere ulaşmak için: - Reklam yöneticisinin TikTok Ads Manager › Lead Center alanına girmesi, - CSV formatında dosyayı elle indirmesi, - Veriyi satış veya destek ekibine iletmesi gerekir.
Bu süreç saatler veya günler sürebilir. Oysa dijital reklamcılıkta "Speed-to-Lead" (Müşteri Adayına Dönüş Hızı) kuralı gereği, ilk 5 dakika içinde ulaşılan lead'lerin satışa dönüşme oranı saatler sonra ulaşılanlara kıyasla katlarca yüksektir.
1.b – Supsis İle Uçtan Uca Çalışma Mimarisi
- Yetkilendirme: TikTok Advertiser (Reklam Veren) hesabınızı Supsis'e bağlarsınız.
- Varlık Keşfi: Supsis yetkili reklam hesaplarını ve bu hesaplara bağlı tüm Instant Form'ları otomatik olarak çeker.
- Webhook & Lead Aboneliği: Supsis, TikTok Marketing API üzerinde otomatik olarak bir lead aboneliği (subscription) başlatır.
- Geçmiş Veri Senkronizasyonu: Kanal bağlandığı anda geçmiş lead'lerin tam senkronizasyonu arka planda başlar.
- Canlı Akış: Yeni bir kullanıcı formu doldurduğunda TikTok, Supsis Webhook uç noktasına anlık sinyal gönderir; Supsis lead detaylarını çekip kişi kaydını oluşturur ve otomasyonları çalıştırır.
2- Lead Verisinde Hangi Bilgiler Gelir?
Supsis'e aktarılan her bir TikTok lead'i için aşağıdaki veri katmanları eksiksiz olarak kaydedilir:
| Veri Katmanı | Alanlar ve Açıklama | Supsis'teki Karşılığı |
|---|---|---|
| Kişi Bilgileri | Ad, Soyad, E-posta Adresi, Telefon Numarası | Standart Kişi Kartı alanlarına otomatik eşlenir. WhatsApp, SMS ve E-posta otomasyonları bu alanları doğrudan kullanır. |
| Form Cevaplarının Tamamı | Formda sorduğunuz tüm özel ve çoktan seçmeli sorular ve kullanıcının verdiği cevaplar. | Kişi kartında ve otomasyon payload'unda soru → cevap çifti olarak saklanır. |
| Reklam Kaynağı (Attribution) | Kampanya Adı ve ID'si, Reklam Grubu (Ad Group) Adı ve ID'si, Reklam (Ad) Adı ve ID'si, Reklam Hesabı ID'si. | Kişi kartı detayına ve etkinlik geçmişine işlenir. Hangi reklamın dönüşüm getirdiği raporlanır. |
| Form Kimliği | Form Adı ve Form Kimliği (Form ID). | Form bazlı segmentasyon ve filtrelemede kullanılır. |
| Zaman Damgası | Formun TikTok üzerinde doldurulduğu tarih ve saat bilgisi. | Kişi oluşturulma ve işlem zamanı. |
Kişi Durumu ve Platform Filtresi
TikTok Leads üzerinden oluşan kişiler Supsis'te otomatik olarak "Kişi" statüsünde ve "İletişime Geçilmiş" olarak işaretlenir. Platform bilgisi TikTok Leads olarak atanır; böylece Kişiler menüsünde platform filtresinden yalnızca TikTok reklamlarından gelen kişileri listeleyebilirsiniz.
3- Kanal Detayı ve Yönetim Sekmeleri
TikTok Leads kanalı oluşturulduğunda (/integrations/tiktok-leads/{kanalId}/detail) sol menüde 6 temel yönetim sekmesi yer alır:
3.a – Detay Sekmesi
Kanal adını düzenleme, kanal kimliği, oluşturulma tarihi ve kanalın genel çalışma durumunun incelendiği alandır.
3.b – Görünürlük Sekmesi
Bu kanaldan gelen lead'leri ve bildirimleri hangi departmanların, ekiplerin veya özel müşteri temsilcilerinin görüp yönetebileceğini sınırlandırır.
3.c – Reklam Hesapları Sekmesi
Yetkilendirme ile Supsis'e bağlanan TikTok reklam hesaplarının (Advertiser) listelendiği alandır.
- Senkronize Et Butonu: TikTok Business Center üzerinde yeni bir reklam hesabı açtığınızda veya hesap yetkilerini güncellediğinizde "Senkronize et" butonuna basarak hesap listesini anında tazeleyebilirsiniz.
3.d – Formlar Sekmesi
Reklam hesaplarınız altında tanımlı tüm Instant Form'ları listeler.
- Tablo Kolonları: Form Kimliği (Form ID), Form Adı, Bağlı Olduğu Reklam Hesabı (Advertiser), Form Durumu ve O forma ait toplanmış toplam lead sayısı.
- Formları Senkronize Et: TikTok Ads Manager'da yeni bir Instant Form yayınladığınızda Supsis'in formu tanıması için bu butona basılır.
3.e – Lead'ler Sekmesi
Toplanan tüm potansiyel müşteri kayıtlarının kronolojik olarak listelendiği yönetim merkezidir.
- Kolonlar: Ad, E-posta, Telefon, Form Adı, Kampanya Adı ve Oluşturulma Tarihi.
- Filtreleme & Arama: Form bazında filtreleme yapabilir, isim veya telefonla arama yapabilirsiniz.
- Manuel Senkronizasyon: Eksik lead şüphesinde manuel senkronizasyon tetiklenebilir.
- Test Lead Oluştur Butonu: Test amacıyla yapay lead üretilmesini sağlar.
3.f – Kampanyalar Sekmesi
Seçilen reklam hesabına bağlı kampanyaların canlı durumunu gösterir.
- Bilgiler: Kampanya Kimliği (ID), Kampanya Adı, Reklam Hedefi (Objective: Lead Generation vb.) ve Yayın Durumu doğrudan TikTok Marketing API üzerinden okunur.
4- Test Lead Oluşturma Özelliği
Reklam bütçesi harcamadan ve gerçek bir kampanya yayına almadan önce entegrasyonun ve bağlı otomasyonların kusursuz çalıştığını doğrulamak için Test Lead Oluştur mekanizması kullanılır.
4.a – Test Lead Adımları:
- Lead'ler sekmesine gelin ve sağ üstteki Test Lead Oluştur butonuna tıklayın.
- Açılan pencerede hedef Reklam Hesabını ve test etmek istediğiniz Formu seçin (veya Form ID girin).
- Oluştur butonuna basın.
- Supsis, TikTok test sandbox ortamı üzerinde sentetik bir lead oluşturur; bu lead anında gerçek bir lead gibi Supsis Kişiler modülüne işlenir ve "TikTok lead geldiğinde" otomasyonunu tetikler.
5- Senkronizasyon Türleri ve Çalışma Prensipleri
Supsis TikTok Leads entegrasyonunda veri bütünlüğünü sağlamak adına 4 farklı senkronizasyon mekanizması bulunur:
| Senkronizasyon Modu | Çalışma Mantığı | Ne Zaman Kullanılır? |
|---|---|---|
| Canlı (Webhook) Senkronu | Kullanıcı formu doldurduğu anda TikTok Supsis'e anlık HTTP POST bildirimi iletir. | Standart günlük çalışma şeklidir (gerçek zamanlı). |
| İlk Kurulum Tam Senkronu | Kanal Supsis'e ilk kez bağlandığı anda arka planda otomatik çalışır. | Hesaptaki geçmiş lead'leri Supsis'e aktarmak için. |
| Manuel Tam Senkron | Lead'ler sekmesindeki senkron butonuna basılarak başlatılır. | Olası ağ gecikmesi veya eksik veri şüphesinde. |
| Form Senkronizasyonu | Formlar sekmesindeki "Formları Senkronize Et" butonuyla tetiklenir. | TikTok Ads Manager'da yeni form oluşturulduğunda. |
Hız Limiti ve Güvenlik (Rate Limiting)
TikTok Marketing API hız kotalarına takılmamak ve hesap güvenliğini korumak için tam senkronizasyon işlemleri kuyruğa alınarak saniyede 1 istek hızında çalışır. Binlerce lead içeren büyük hesaplarda senkronizasyon birkaç dakika sürebilir. Aynı anda mükerrer senkronizasyon başlatılamaz ve aynı lead tekrar çekilse dahi mükerrer kişi kaydı oluşturulmaz.
6- Otomasyon Entegrasyonu (tiktok.lead_generated)
TikTok Leads entegrasyonu, Supsis Otomasyon Motoru içerisindeki TikTok modülüne eklenen "TikTok lead geldiğinde" tetikleyicisi ile tam entegre çalışır.
6.a – Kurulabilecek Örnek Senaryolar:
- WhatsApp / SMS Hoş Geldin Mesajı: Formu dolduran kullanıcıya anında WhatsApp üzerinden teklif detayı veya katalog gönderimi.
- Temsilciye Otomatik Atama: Lead'in uzmanlık alanına göre canlı destek temsilcisine yönlendirilmesi ve bildirim gönderilmesi.
- CRM Entegrasyonu: Lead verilerinin HubSpot, Salesforce, Zoho, Pipedrive veya Monday CRM üzerine yeni müşteri veya anlaşma (deal) olarak yazılması.
- Form Bazlı Ayrıştırma: "Emlak Formu" dolduranların satış ekibine, "İnsan Kaynakları Formu" dolduranların İK departmanına yönlendirilmesi.
6.b – Otomasyonda Erişilebilen Veri Alanları:
Otomasyon içerisinde bloklar ve koşullarda lead'in tüm alanları dinamik etiket olarak kullanılabilir:
* lead_id, form_id, form_name, advertiser_id,
* campaign_id, campaign_name, adgroup_id, adgroup_name, ad_id, ad_name,
* email, phone_number, full_name,
* Formdaki tüm özel soru-cevap anahtarları.
7- Kurulum Adımları (Adım Adım Rehber)
7.a – 1. Adım: TikTok Ads Manager'da Instant Form Hazırlığı
- TikTok Ads Manager hesabınıza giriş yapın.
- Varlıklar (Assets) › Instant Form bölümünden potansiyel müşteri formunuzu oluşturun ve yayınlayın.
- Reklam kampanyanızın hedefini Lead Generation (Potansiyel Müşteri) olarak seçin ve oluşturduğunuz formu reklama bağlayın.
7.b – 2. Adım: Supsis Panelinden Kanal Ekleme
- Supsis Müşteri Panelinizi açın ve sol menüden Entegrasyonlar sayfasına gidin.
- Reklam kategorisi altındaki TikTok Leads kartına tıklayın (
/integrations/tiktok-leads). - Sağ üstteki + Kanal Ekle butonuna basın.
- Açılan modal penceredeki ön koşulları inceleyin:
- TikTok Reklam Veren (Advertiser) hesabınızın bulunması,
- Hesabınızda tanımlı bir Instant Form olması,
- DM kanalından bağımsız olarak ayrı yetkilendirme gerektiği şartını onaylayın.
- TikTok'a Bağlan butonuna tıklayın.
7.c – 3. Adım: TikTok OAuth İzinlerinin Verilmesi
- Açılan resmi TikTok yetkilendirme penceresinde oturum açın.
- İlgili reklam hesaplarınızı seçin ve Supsis AI uygulamasının lead verilerine erişim iznini onaylayın.
- Onay sonrası Supsis paneline dönerek Kanalı Oluştur butonuna basın.
7.d – 4. Adım: Doğrulama ve Canlıya Alma
- Kanal detayındaki Reklam Hesapları sekmesinden hesabınızın geldiğini doğrulayın.
- Formlar sekmesine geçip Formları Senkronize Et butonuna basarak formlarınızı içeri aktarın.
- Lead'ler sekmesinden Test Lead Oluştur ile deneme yapın ve Kişiler listesinde görüntülendiğini teyit edin.
- Otomasyon akışınızı kurgulayarak reklamlarınızı canlıya alın.
8- Paket ve Lisans Yönetimi
TikTok Leads entegrasyonu bağımsız bir modül lisansına tabidir:
* Paket Sayfası: Faturalandırma → Paketler → TikTok Lead (/billing/plans/tiktok-lead)
* Kota Mantığı: Paketinizde tanımlı kanal sayısı kadar aktif TikTok Leads kanalı bağlayabilirsiniz.
* Kota dolduğunda yeni kanal eklenirken panel paket yükseltme uyarısı görüntüler.
9- Terimler Sözlüğü
| Terim | Açıklama |
|---|---|
| Lead (Potansiyel Müşteri) | Ürün veya hizmetinizle ilgilenerek iletişim formunu dolduran kişi. |
| Instant Form (Anlık Form) | Kullanıcının TikTok uygulamasından çıkmadan reklam içinde doldurduğu yerel form. |
| Lead Generation (Hedef) | TikTok Ads Manager'da form toplamak için zorunlu olan reklam kampanya hedefi. |
| Advertiser (Reklam Hesabı) | Kampanyaların ve bütçelerin bağlı olduğu TikTok reklam hesabı. |
| Lead Center | TikTok Ads Manager içinde toplanan lead'lerin görüntülendiği yerel alan. |
| Marketing API | TikTok Leads entegrasyonunun bağlandığı resmi TikTok reklam geliştirici servisi. |
| Lead Subscription | TikTok'tan Supsis'e yeni form dolduğunda anlık bildirim gönderilmesini sağlayan webhook aboneliği. |
| Test Lead | Canlı bütçe harcamadan entegrasyonu doğrulamak için üretilen simülasyon lead'i. |
10- Sıkça Sorulan Sorular ve Sorun Giderme
10.a – "Kanalı bağladım ancak hiçbir lead gelmiyor, neden?"
- Instant Form Kontrolü: TikTok Ads Manager'da aktif bir Lead Generation kampanyanız ve buna bağlı Instant Form'unuz olduğundan emin olun. Reklam yayında değilse lead üretilmez.
- Form Senkronu: Formlar sekmesinden "Formları Senkronize Et" butonuna basıldığından emin olun.
- Hesap Yetkisi: Yetkilendirmeyi yapan TikTok kullanıcısının ilgili reklam hesabında yönetici yetkisi olmalıdır.
10.b – "TikTok DM kanalımız var, Leads için tekrar bağlamak zorunda mıyız?"
- Evet. TikTok DM kanalı mesajlaşma servisini (Business Messaging API), TikTok Leads ise reklam servisini (Marketing API) kullanır. TikTok izin mekanizması gereği ayrı yetkilendirme ve ayrı kanal oluşturulması zorunludur.
10.c – "Lead'ler Supsis'e birkaç dakika geç düşüyor, normal mi?"
- TikTok sunucuları bazı durumlarda form bildirimini gönderdikten sonra lead detayını API üzerinde birkaç dakikalık gecikmeyle hazır eder. Supsis arka planda belirli aralıklarla sorgulama yaparak lead verisini eksiksiz olarak panele aktarır.
10.d – "KVKK ve Veri Sorumluluğu kime aittir?"
- TikTok Instant Form'larında toplanan ad, telefon ve e-posta gibi kişisel verilerin aydınlatma metni ve açık rıza onayları reklam veren işletmenin sorumluluğundadır. Form oluştururken aydınlatma metni bağlantınızı eklemeniz yasal gerekliliktir.