Dokumentasi KOL TikTok SellerCuan

Dokumen ini menjelaskan cara KOL menghubungkan akun TikTok, membuat jadwal konten, dan memahami proses auto posting dari SellerCuan.

Tujuan fitur

Fitur TikTok KOL membantu brand dan KOL menjalankan campaign konten dari satu dashboard. KOL dapat menyiapkan caption, media, tenant campaign, dan jadwal posting tanpa membagikan password TikTok ke SellerCuan atau tenant.

Cara kerja singkat

1. KOL login ke dashboard KOL.
2. KOL menekan tombol Connect TikTok.
3. TikTok meminta izin melalui halaman OAuth resmi TikTok.
4. Setelah disetujui, SellerCuan menyimpan akses akun secara terenkripsi.
5. KOL membuat jadwal konten dengan caption, URL video, tenant campaign, dan waktu posting.
6. Cron job SellerCuan mengambil konten yang sudah jatuh tempo dan mengirim request publish ke TikTok.
7. Status konten berubah menjadi PUBLISHING, PUBLISHED, atau FAILED.

Data TikTok yang digunakan

SellerCuan menggunakan data TikTok hanya untuk menjalankan fitur yang dipilih KOL:

• Identitas akun TikTok seperti open ID, display name, dan avatar.
• Token akses TikTok dari OAuth resmi TikTok.
• Scope izin yang diberikan KOL.
• Caption, URL media, jadwal posting, status publish, dan error publish.

SellerCuan tidak meminta password TikTok KOL.

Menghubungkan akun TikTok

1. Buka /kol/dashboard.
2. Pada bagian Jadwal Konten TikTok, klik Connect TikTok.
3. Login di halaman TikTok jika diminta.
4. Setujui permission yang dibutuhkan.
5. Setelah kembali ke SellerCuan, akun akan tampil di daftar Akun TikTok.

Jika muncul pesan bahwa integrasi TikTok belum dikonfigurasi, berarti environment TikTok app di server belum lengkap.

Membuat jadwal konten

Pada form Buat Jadwal Post, isi:

• Akun: akun TikTok yang akan dipakai.
• Tenant campaign: brand atau tenant campaign terkait. Boleh dikosongkan jika konten tidak spesifik untuk tenant tertentu.
• Caption: teks caption TikTok.
• Upload video: file video yang akan disimpan ke storage SellerCuan dan dipakai sebagai sumber publish TikTok. Batas upload saat ini 512MB.
• Jadwal posting: tanggal dan jam publish.

Setelah submit, jadwal akan muncul di daftar Jadwal & Riwayat.

Status konten

• DRAFT: konten tersimpan tetapi belum dijadwalkan.
• SCHEDULED: konten menunggu waktu posting.
• PUBLISHING: SellerCuan sedang mengirim konten ke TikTok.
• PUBLISHED: TikTok menerima request publish.
• FAILED: publish gagal. Detail error tampil di kartu konten.
• CANCELLED: jadwal dibatalkan sebelum dipublish.

Membatalkan jadwal

KOL dapat membatalkan konten dengan status SCHEDULED dari dashboard. Konten yang sudah PUBLISHING atau PUBLISHED tidak bisa dibatalkan dari jadwal SellerCuan.

Disconnect akun TikTok

KOL dapat menekan Disconnect pada kartu akun TikTok. Setelah disconnect:

• SellerCuan tidak memakai token tersebut untuk posting baru.
• Jadwal yang masih membutuhkan akun tersebut dapat gagal saat diproses.
• KOL bisa connect ulang kapan saja melalui tombol Connect TikTok.

Setup TikTok app

Superadmin dapat mengisi konfigurasi TikTok dari dashboard:

Administration > Setup TikTok KOL

Field yang tersedia:

• TikTok Client Key.
• TikTok Client Secret.
• Redirect URI.
• Sandbox mode.
• Enable direct post.

Untuk TikTok Developer Console, gunakan Redirect URI yang tampil di halaman setup tersebut. Contoh production:

https://domain-anda.com/api/kol/tiktok/callback

Setup server

Admin teknis tetap perlu menyiapkan secret enkripsi dan cron. Client Key, Client Secret, dan Redirect URI dapat diisi dari halaman Superadmin di atas. Environment berikut masih bisa dipakai sebagai fallback:

TIKTOK_CLIENT_KEY

Client key dari TikTok Developer app. Opsional jika sudah disimpan dari Superadmin.

TIKTOK_CLIENT_SECRET

Client secret dari TikTok Developer app. Opsional jika sudah disimpan dari Superadmin.

TIKTOK_REDIRECT_URI

Callback URL OAuth. Opsional jika sudah disimpan dari Superadmin.

KOL_SOCIAL_TOKEN_SECRET

Secret untuk enkripsi token sosial KOL.

CRON_SECRET

Secret untuk mengamankan endpoint cron.

TIKTOK_ENABLE_DIRECT_POST

Fallback env untuk mengaktifkan direct posting. Bisa juga diaktifkan dari halaman Superadmin.

Cron publish

Endpoint cron:

GET /api/cron/kol-social-posts

Jika CRON_SECRET diset, panggil endpoint dengan header:

Authorization: Bearer <CRON_SECRET>

Cron ini akan mengambil maksimal 10 jadwal TikTok yang sudah jatuh tempo dan mencoba mempublish konten.

Catatan approval TikTok

TikTok dapat membatasi fitur posting berdasarkan review app, scope, policy, atau status akun. Jika TikTok belum menyetujui direct post untuk app, SellerCuan tetap dapat menyimpan jadwal, tetapi publish otomatis akan gagal dengan error yang menjelaskan bahwa direct post belum diaktifkan.

Untuk sandbox awal, scope minimal yang dipakai SellerCuan adalah:

• user.info.basic
• video.upload

Jangan aktifkan direct post sampai TikTok app sudah punya permission publish yang sesuai. Jika OAuth menampilkan error scope, berarti aplikasi meminta scope yang belum ada atau belum approved di TikTok Developer Console.

Rekomendasi operasional

• Gunakan file video final yang siap publish. Untuk video panjang, ukuran maksimal upload adalah 512MB.
• Gunakan caption yang sesuai campaign dan aturan disclosure endorsement.
• Tenant perlu melakukan audit konten dari daftar jadwal dan fee ledger campaign.
• KOL tidak perlu membagikan password TikTok ke brand atau admin SellerCuan.