Headless connect
Klien menghubungkan akun sosialnya langsung dari web atau aplikasimu, tanpa melihat halaman Tebar. Sudah termasuk di paket Agency.
Biasanya connect link membawa klien ke halaman Tebar dulu, baru ke halaman login platform. Dengan headless connect, klien berangkat dari web atau aplikasimu, langsung login di Instagram, Threads, TikTok, atau platform lain, lalu kembali ke webmu. Klien tidak pernah melihat halaman Tebar.
Cocok untuk agensi dan reseller yang ingin proses onboarding klien terasa sebagai bagian dari layanan mereka sendiri.
Cara kerjanya
- Aplikasimu membuat connect link untuk profile klien lewat API.
- Klien menekan tombol di webmu, misalnya Hubungkan Instagram, dan langsung masuk ke halaman login platform.
- Klien login dan memberi izin. Akunnya masuk ke profile yang kamu tentukan.
- Klien kembali ke
redirect_urldi webmu, membawa hasilnya (berhasil, ditolak, atau gagal).
Siapa yang bisa memakainya
- Paket Agency: langsung bisa dipakai, tanpa perlu mengajukan. Lihat Paket.
- Paket berbayar lain: hubungi support untuk mengajukan persetujuan.
- Tebar bisa menghentikan akses ini, juga di paket Agency, misalnya kalau banyak klien menolak di halaman izin atau melaporkannya.
Wajib: beri tahu klienmu soal Tebar
Halaman izin Instagram, Facebook, TikTok, dan platform lain selalu menyebut nama aplikasi Tebar. Sebelum mengarahkan klien, jelaskan bahwa akunnya dihubungkan lewat Tebar, supaya mereka tidak kaget atau menolak. Ini syarat di Ketentuan Layanan, dan jangan menyamarkan atau menyembunyikan peran Tebar.
Sebelum mulai
Daftarkan domain webmu sebagai domain redirect, sama seperti connect link biasa. Caranya ada di Connect link.
Membuat link
Kirim headless: true dan redirect_url:
curl -X POST https://api.tebar.app/v1/profiles/klien-42/connect-links \
-H "Authorization: Bearer tb_live_xxx" -H "Content-Type: application/json" \
-d '{ "redirect_url": "https://app.contoh.com/tebar/selesai", "headless": true, "platforms": ["instagram"] }'{
"url": "https://publish.tebar.app/connect/s/1z35fNMp.",
"profile_id": "9d09.",
"expires_at": "2026-10-20T12:30:00.000Z",
"start_urls": { "instagram": "https://api.tebar.app/connect-links/1z35fNMp./start/instagram" }
}- Arahkan browser klien ke
start_urls[platform]sebagai navigasi penuh, jangan di dalam iframe. start_urlshanya berisi platform yang bisa dihubungkan saat ini untuk akunmu. Kalau tidak ada satu pun, permintaan dijawab422 platform_not_supported.redirect_urlwajib (400 redirect_url_required).- Login Facebook menghubungkan semua Halaman yang diberikan klien di dialog Meta (yang bisa diposting), tanpa langkah pilih Halaman.
Hasil di webmu
Semua hasil kembali ke redirect_url, termasuk link yang kedaluwarsa atau sudah dipakai, dengan parameter status dan error yang sama seperti connect link biasa. Akun yang baru terhubung juga dikirim lewat webhook bila kamu memakainya.
Kalau akses berhenti
Tanpa paket Agency atau persetujuan, permintaan membuat link dijawab 403 headless_not_approved. Kalau persetujuan dicabut, akses diblokir Tebar, atau paket Agency berakhir, link yang sudah dibuat juga berhenti, termasuk alur yang sedang berjalan di halaman platform. Klien kembali ke webmu dengan error=headless_not_approved. Connect link biasa (lewat halaman Tebar) tetap bisa dipakai.