Connect link
Biarkan klien menghubungkan akun sosialnya sendiri ke salah satu profile-mu, tanpa akun Tebar.
Connect link adalah link sekali pakai ke halaman Tebar tempat klienmu login ke platform (Instagram, Threads, TikTok, dan lainnya) dan memberi izin. Akunnya masuk ke profile yang kamu tentukan, lalu klien dikembalikan ke aplikasimu. Klien tidak perlu punya akun Tebar dan tidak pernah melihat dashboard-mu.
1. Izinkan domain aplikasimu
Klien hanya bisa dikembalikan ke domain yang sudah kamu daftarkan. Daftarkan sekali, dari dashboard (Integrasi → Domain redirect) atau lewat API:
curl -X POST https://api.tebar.app/v1/connect/redirect-origins \
-H "Authorization: Bearer tb_live_xxx" -H "Content-Type: application/json" \
-d '{ "origin": "https://app.contoh.com" }'Atur juga nama yang tampil di halaman connect ("Hubungkan akunmu ke …") di Integrasi → Nama yang tampil, atau PATCH /v1/connect/settings { "brand_name": "Agensi Kamu" }.
2. Buat link untuk klien
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", "state": "sesi-abc123" }'{
"url": "https://publish.tebar.app/connect/s/1z35fNMp…",
"profile_id": "9d09…",
"expires_at": "2026-10-20T12:30:00.000Z"
}{id}di path boleh ID profile atauexternal_id.state(opsional) dikembalikan apa adanya, berguna untuk mencocokkan klien di sistemmu.platforms(opsional), misalnya["instagram", "tiktok"], membatasi tombol platform yang tampil.- Link berlaku 30 menit dan hanya bisa dipakai sekali. Buat link baru setiap kali klien ingin menghubungkan akun.
Dari dashboard, link bisa dibuat lewat menu ⋯ di profile → Buat connect link.
Perlakukan link seperti kunci
Siapa pun yang membuka link bisa menghubungkan akunnya ke profile itu. Kirim link hanya ke klien yang sudah login di aplikasimu, dan jangan memasangnya di halaman publik.
3. Terima klien kembali
Setelah selesai, klien diarahkan ke redirect_url dengan query tambahan:
https://app.contoh.com/tebar/selesai?status=connected&profile_id=…&account_ids=…&state=sesi-abc123Kalau gagal atau dibatalkan:
https://app.contoh.com/tebar/selesai?status=error&error=access_denied&state=sesi-abc123error | Arti |
|---|---|
access_denied | Klien membatalkan di halaman izin platform |
permission_missing | Klien tidak mencentang semua izin yang dibutuhkan |
account_in_other_profile | Akun itu sudah terhubung di profile lain milikmu |
plan_account_limit | Batas akun di paketmu sudah penuh |
expired | Link kedaluwarsa sebelum klien selesai |
Link yang gagal masih bisa dicoba lagi sampai kedaluwarsa.
Selalu cek ulang lewat API
Query di URL bisa diubah oleh siapa pun yang memegangnya. Pastikan akun benar-benar terhubung
dengan GET /v1/accounts dan header Tebar-Profile, atau dengan webhook
account.connected.
Login Facebook bisa memberi akses ke beberapa Halaman sekaligus. Klien lalu memilih Halaman yang ingin dihubungkan di halaman Tebar yang sama, dan semua Halaman yang dipilih masuk ke profile itu.