Skip to main content

Integrasi Donasi

Donasi dari platform luar tidak otomatis terlihat di live TikTok kamu. Integrasi Donasi menyambungkannya, sehingga donasi masuk bisa memicu alert, suara, dan TTS seperti gift TikTok biasa.

Apa itu Integrasi Donasi

IndoFinity mendukung tujuh platform:

Saweria · Sociabuzz · Trakteer · Tako · BagiBagi · Sibagi · TipTap

Sambungannya lewat webhook: kamu menempelkan link webhook milik IndoFinity ke pengaturan platform donasi, lalu platform itu mengirim pemberitahuan ke IndoFinity setiap ada donasi masuk.

Sebelum mulai

Kamu butuh akun aktif di platform donasi yang mau dihubungkan, dan akses ke halaman pengaturannya.

Langkah setup

Polanya sama untuk ketujuh platform.

  1. Buka menu Integrasi Donasi di dashboard.
  2. Pindah ke tab Setup Webhook.
  3. Pilih platform yang mau dihubungkan.
  4. Klik kolom Link Webhook untuk menyalinnya.

2. Pasang di platform donasi

Buka pengaturan webhook di platform donasi kamu, lalu tempel link tadi. Letak menunya berbeda-beda tiap platform — biasanya di bagian pengaturan integrasi atau developer.

3. Isi token di IndoFinity

Tiap platform memberimu sebuah kunci yang harus dimasukkan kembali ke IndoFinity. Namanya berbeda-beda:

PlatformNama kolom di IndoFinity
SaweriaSaweria Streamkey
SociabuzzSociabuzz Webhook Token
TrakteerTrakteer Webhook Token
TakoTako Webhook Token
BagiBagiBagiBagi Webhook Token
SibagiSibagi Webhook Token
TipTapTipTap Token Verifikasi

Isi kolomnya, lalu klik Simpan.

Jaga kerahasiaan link webhook dan token

Peringatan ini muncul di setiap halaman setup: "Jaga link webhook dan streamkey Anda tetap aman, jangan sampai orang lain mengetahui data tersebut."

Siapa pun yang punya link webhook kamu bisa mengirim donasi palsu ke overlay kamu. Kalau terlanjur bocor, kamu bisa meminta link baru ke admin.

4. Buat alert untuk donasi

Menghubungkan platform saja belum membuat apa pun muncul di layar. Kamu masih perlu membuat Interaksi dan Aktivitas:

  1. Buka Pusat Interaksi, buat Interaksi — misalnya Show Alert (User + Teks) dengan Format Teks:

    {nickname} donasi {amount} — {message}
  2. Buat Aktivitas dengan pemicu [Integrasi] Mengirim Donasi Saweria (atau platform yang kamu pakai).

  3. Arahkan ke Interaksi tadi.

Tiga variabel khusus donasi: {nickname}, {message}, dan {amount}. Lihat Variabel Pesan.

Aksi berbeda untuk nominal berbeda

Di Aktivitas, pilih Kisaran jumlah (min - max) kalau kamu ingin donasi kecil dan donasi besar memicu alert yang berbeda. Buat beberapa Aktivitas dengan rentang yang tidak bertumpuk.

Tab Dukungan Masuk

Tab Dukungan Masuk menampilkan riwayat donasi yang sudah diterima IndoFinity: waktu, nama, email, jumlah, pesan, dan media.

Ini alat diagnosis terbaik untuk integrasi donasi. Kalau donasi muncul di tabel ini tapi alert tidak keluar, berarti webhook sudah benar dan masalahnya ada di Interaksi atau Aktivitas. Kalau tabel ini kosong padahal ada donasi masuk, berarti webhook-nya yang belum tersambung.

Tombol Refresh memuat ulang daftarnya.

Masalah umum

Gejala: tabel Dukungan Masuk kosong padahal donasi sudah masuk di platformnya. Webhook belum tersambung. Cek ulang link webhook sudah tertempel benar di pengaturan platform, dan token sudah disimpan di IndoFinity.

Gejala: donasi muncul di tabel, tapi tidak ada alert di layar. Webhook sudah benar. Yang kurang adalah Aktivitas dengan pemicu [Integrasi] Mengirim Donasi …, atau Interaksi-nya diarahkan ke Screen yang overlay-nya belum dipasang.

Gejala: alert donasi muncul tapi nominal dan pesannya kosong. Format teks memakai variabel yang salah. Donasi memakai {nickname}, {message}, dan {amount} — bukan {username}, {comment}, atau {coins}.

Gejala: format streamkey Saweria ditolak. Pesannya: "Format streamkey yang kamu masukkan salah". Salin ulang dari Saweria, pastikan tidak ada spasi ikut tersalin.

Uji tanpa donasi sungguhan

Panel Simulator di Pusat Interaksi punya tab Donasi — pilih platform dan nominal, lalu kirim. Ini menguji Interaksi dan Aktivitas kamu tanpa perlu ada yang benar-benar berdonasi.

Perhatikan: simulator menguji alert-nya, bukan sambungan webhook-nya. Untuk memastikan webhook benar-benar jalan, lihat tab Dukungan Masuk.

Lihat juga