# Formulir Prospek Facebook

Menjalankan iklan Facebook untuk mendapatkan prospek? Integrasi ini secara otomatis mengirimkan prospek tersebut ke <span data-t="appName">Your AI Connector</span> sehingga Anda dapat menindaklanjutinya melalui WhatsApp, SMS, atau saluran terhubung lainnya — tanpa perlu repot.

Cara kerjanya adalah dengan menghubungkan Facebook Lead Ads ke <span data-t="appName">Your AI Connector</span> melalui platform otomatisasi (seperti Pabbly, Zapier, atau Make). Platform-platform ini bertindak sebagai jembatan antara Facebook dan <span data-t="appName">Your AI Connector</span>, meneruskan informasi prospek dari satu ke yang lain menggunakan API (cara bagi perangkat lunak yang berbeda untuk bertukar data secara otomatis).

---

## Prasyarat

Sebelum memulai, pastikan Anda memiliki:

- Akses **Facebook Ads Manager** dengan izin untuk membuat Lead Ads.
- **Sebuah akun** dengan kunci API aktif (buat satu di **Pengaturan → Integrasi → Kunci API** — lihat [Akses API](api-access.md) untuk langkah-langkah pastinya).
- **Akun platform otomatisasi** — Pabbly Connect, Zapier, atau Make (Integromat). Panduan ini menggunakan Pabbly sebagai contoh, namun langkah-langkahnya serupa di platform mana pun.
- **Daftar kontak** di <span data-t="appName">Your AI Connector</span> tempat prospek baru akan ditambahkan — lihat [Mengatur Daftar & Kontak](../get-started/list-and-contact-management.md).

---

## Ikhtisar

Integrasi ini bekerja dalam tiga tahap:

1. Prospek mengisi Formulir Prospek Facebook Anda.
2. Platform otomatisasi Anda mendeteksi prospek baru dan mengirimkan informasi tersebut ke <span data-t="appName">Your AI Connector</span> secara otomatis (menggunakan dua panggilan API).
3. <span data-t="appName">Your AI Connector</span> membuat kontak dan menambahkannya ke daftar yang Anda tentukan.

Dari sana, siaran, kampanye, atau Agen AI yang telah Anda tetapkan akan menangani sisanya — baik itu pesan sambutan bertenaga AI, urutan pesan (drip sequence), atau tindak lanjut manual.

---

## Langkah 1: Buat Formulir Prospek Facebook Anda

1. Buka **Facebook Ads Manager**.
2. Buat kampanye baru dengan tujuan **Prospek**.
3. Di tingkat iklan, pilih **Formulir Instan** sebagai metode prospek.
4. Buat formulir Anda dengan kolom yang diperlukan. Minimal, sertakan:
   - **Nama depan**
   - **Nomor telepon** (dengan kode negara)
   - Opsional: Nama belakang, email
5. Publikasikan iklan atau simpan formulir sebagai draf untuk pengujian.

---

## Langkah 2: Uji Formulir Prospek

Sebelum menghubungkan otomatisasi, kirimkan prospek uji:

1. Di Ads Manager, buka Formulir Prospek Anda.
2. Klik **Pratinjau** dan isi formulir dengan data uji.
3. Konfirmasikan bahwa prospek uji muncul di **Pusat Prospek Facebook** Anda (di bawah Alat Penerbitan di Halaman Facebook Anda, atau di Ads Manager di bawah "Prospek").

Entri uji ini akan digunakan untuk mengatur pemetaan kolom di platform otomatisasi Anda.

---

## Langkah 3: Atur Otomatisasi

### Hubungkan Facebook Lead Ads sebagai Pemicu (Trigger)

1. Masuk ke platform otomatisasi Anda (Pabbly, Zapier, atau Make).
2. Buat alur kerja / skenario / zap baru.
3. Atur **pemicu** ke "Facebook Lead Ads - New Lead."
4. Hubungkan akun Facebook Anda dan pilih Halaman serta Formulir Prospek (Lead Form).
5. Ambil data prospek uji untuk memastikan koneksi berfungsi dan untuk memetakan bidang.

### Konfigurasi Panggilan API 1: Buat Kontak

Tambahkan langkah tindakan dengan HTTP / Webhook / Permintaan API:

- **Metode:** `POST`
- **URL:** `https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY`
- **Header:**
  ```
  Content-Type: application/json
  ```
- **Isi (JSON):**
  ```json
  {
    "firstName": "{{first_name}}",
    "lastName": "{{last_name}}",
    "phone": "{{phone_number}}",
    "email": "{{email}}"
  }
  ```

Ganti `{{placeholders}}` dengan pemetaan bidang yang sebenarnya dari langkah pemicu Anda.

::: warning
**Penting:** Nomor telepon harus menyertakan kode negara (contohnya, `+1` untuk AS atau `+31` untuk Belanda). Jika formulir prospek Anda mengumpulkan nomor telepon tanpa kode negara, tambahkan langkah pemformatan dalam otomatisasi Anda untuk menambahkannya di depan.
:::


Respons API mengembalikan ID kontak baru di `data.contactId`. Simpan nilai tersebut — Anda akan membutuhkannya untuk langkah berikutnya.

> **Anda dapat melewati panggilan kedua.** `POST /v1/contacts` juga menerima `listId` (satu daftar) atau `listIds` (beberapa daftar) dalam isi pembuatan, yang menambahkan kontak baru ke daftar tersebut dalam permintaan yang sama. Gunakan versi dua langkah di bawah ini hanya jika platform otomatisasi Anda mengharuskan kontak tersebut ada sebelum memutuskan daftar mana yang akan digunakan.

### Konfigurasi Panggilan API 2: Tambahkan Kontak ke Daftar

Tambahkan langkah tindakan kedua:

- **Metode:** `POST`
- **URL:** `https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY`
- **Header:**
  ```
  Content-Type: application/json
  ```
- **Isi (JSON):**
  ```json
  {
    "contactId": "{{contact_id_from_previous_step}}",
    "listId": "YOUR_LIST_ID"
  }
  ```

Ganti `YOUR_LIST_ID` dengan ID sebenarnya dari daftar kontak Anda (lihat [Menemukan ID Daftar Anda](#finding-your-list-id) di bawah), dan petakan `contactId` ke `data.contactId` yang dikembalikan oleh panggilan API pertama.

---

## Menemukan ID Daftar Anda

1. Di Your AI Connector, klik **Kontak**, lalu tab **Daftar**.
2. Buka menu baris ("⋯") di sebelah daftar yang Anda inginkan dan klik **Salin ID daftar**.

Lihat [Mengatur Daftar & Kontak](../get-started/list-and-contact-management.md) untuk panduan lengkap halaman Daftar.

---

## Langkah 4: Uji Alur Kerja Lengkap

1. Kirimkan prospek uji coba lainnya melalui formulir Facebook Anda (atau putar ulang prospek uji coba yang ada di platform otomatisasi Anda).
2. Periksa Your AI Connector untuk memastikan:
   - **Kontak** telah dibuat dengan nama, nomor telepon, dan email yang benar.
   - Kontak telah **ditambahkan ke daftar yang benar**.
3. Jika Anda memiliki siaran, kampanye, atau Agen AI yang diatur untuk mengirim pesan ke daftar tersebut secara otomatis, pastikan pesan tersebut terpicu sesuai harapan.

---

## Referensi Data

Di bawah ini adalah contoh data yang dikirim dan diterima selama integrasi.

### Buat Kontak - Permintaan

```json
POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts?apiKey=YOUR_API_KEY

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "jane@example.com"
}
```

### Buat Kontak - Tanggapan

```json
{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123xyz",
    "listsAdded": []
  }
}
```

### Tambahkan Kontak ke Daftar - Permintaan

```json
POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts/lists?apiKey=YOUR_API_KEY

{
  "contactId": "abc123xyz",
  "listId": "LIST_ID"
}
```

---

## Tips

- **Penanganan duplikat:** jika kontak dengan nomor telepon yang sama sudah ada, panggilan pembuatan akan mengembalikan `{"success": false, "error_code": 409}` dan tidak mengembalikan kontak yang sudah ada. Lakukan percabangan pada `error_code` (status HTTP adalah 200) dan cari kontak tersebut dengan `GET /v1/contacts?phoneNumber=...` sebelum panggilan penambahan ke daftar.
- **Beberapa formulir:** buat alur kerja otomatisasi terpisah untuk formulir prospek yang berbeda, masing-masing menargetkan daftar yang berbeda dan siaran, kampanye, atau Agen AI yang berbeda.
- **Pemberitahuan kesalahan:** konfigurasikan platform otomatisasi Anda untuk memberi tahu Anda jika panggilan API gagal, agar Anda tidak kehilangan prospek.

---

## Langkah Selanjutnya

- [Beralih dari Kampanye ke Siaran & Agen](../moving-from-campaigns.md) — siapkan sesuatu untuk mengirim pesan secara otomatis kepada prospek baru.
- [Akses API](api-access.md) — dokumentasi API lengkap untuk integrasi tingkat lanjut.
- [Webhook](webhooks.md) — dapatkan pemberitahuan saat kontak dibuat atau diberi tag.