# Headless connect (/api/connect-link-headless)

Biasanya [connect link](/api/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 [#cara-kerjanya]

1. Aplikasimu membuat connect link untuk profile klien lewat API.
2. Klien menekan tombol di webmu, misalnya **Hubungkan Instagram**, dan langsung masuk ke halaman login platform.
3. Klien login dan memberi izin. Akunnya masuk ke profile yang kamu tentukan.
4. Klien kembali ke `redirect_url` di webmu, membawa hasilnya (berhasil, ditolak, atau gagal).

## Siapa yang bisa memakainya [#siapa-yang-bisa-memakainya]

- **Paket Agency:** langsung bisa dipakai, tanpa perlu mengajukan. Lihat [Paket](/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.

<Callout type="warn" title="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](https://tebar.app/terms), dan
  jangan menyamarkan atau menyembunyikan peran Tebar.
</Callout>

## Sebelum mulai [#sebelum-mulai]

Daftarkan domain webmu sebagai domain redirect, sama seperti connect link biasa. Caranya ada di [Connect link](/api/connect-link#1-izinkan-domain-aplikasimu).

## Membuat link [#membuat-link]

Kirim `headless: true` dan `redirect_url`:

```bash
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"] }'
```

```json
{
  "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_urls` hanya berisi platform yang bisa dihubungkan saat ini untuk akunmu. Kalau tidak ada satu pun, permintaan dijawab `422 platform_not_supported`.
- `redirect_url` wajib (`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 [#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](/api/connect-link). Akun yang baru terhubung juga dikirim lewat [webhook](/api/webhook) bila kamu memakainya.

## Kalau akses berhenti [#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.
