Your AI Connector Docs

Formulir Prospek Facebook

Menjalankan iklan Facebook untuk mendapatkan prospek? Integrasi ini secara otomatis mengirimkan prospek tersebut ke Your AI Connector sehingga Anda dapat menindaklanjutinya melalui WhatsApp, SMS, atau saluran terhubung lainnya — tanpa perlu repot.

Cara kerjanya adalah dengan menghubungkan Facebook Lead Ads ke Your AI Connector melalui platform otomatisasi (seperti Pabbly, Zapier, atau Make). Platform-platform ini bertindak sebagai jembatan antara Facebook dan Your AI Connector, 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 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 Your AI Connector tempat prospek baru akan ditambahkan — lihat Mengatur Daftar & Kontak.

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 Your AI Connector secara otomatis (menggunakan dua panggilan API).
  3. Your AI Connector 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):
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

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

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):
    {
  "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 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 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 

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 

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

Tambahkan Kontak ke Daftar - Permintaan 

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