Your AI Connector Docs

Facebook Potansiyel Müşteri Formları

Potansiyel müşterileri yakalamak için Facebook reklamları mı yayınlıyorsunuz? Bu entegrasyon, bu potansiyel müşterileri otomatik olarak Your AI Connector içine gönderir, böylece onları WhatsApp, SMS veya başka herhangi bir bağlı kanal aracılığıyla parmağınızı bile kıpırdatmadan takip edebilirsiniz.

Bu, Facebook Potansiyel Müşteri Reklamlarını (Lead Ads) bir otomasyon platformu (Pabbly, Zapier veya Make gibi) aracılığıyla Your AI Connector'a bağlayarak çalışır. Bu platformlar, Facebook ile Your AI Connector arasında bir köprü görevi görerek, API’yi (farklı yazılımların otomatik olarak veri alışverişi yapmasını sağlayan bir yol) kullanarak potansiyel müşteri bilgilerini birinden diğerine aktarır.

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

  • Potansiyel Müşteri Reklamları oluşturma iznine sahip Facebook Reklam Yöneticisi erişimi.
  • Aktif bir API anahtarına sahip bir hesap (Ayarlar → Entegrasyonlar → API Anahtarı kısmından bir tane oluşturun — tam adımlar için API Erişimi bölümüne bakın).
  • Bir otomasyon platformu hesabı — Pabbly Connect, Zapier veya Make (Integromat). Bu kılavuzda örnek olarak Pabbly kullanılmıştır, ancak adımlar herhangi bir platformda benzerdir.
  • Your AI Connector içinde yeni potansiyel müşterilerin ekleneceği bir kişi listesi — Listeleri ve Kişileri Düzenleme bölümüne bakın.

Genel Bakış

Entegrasyon üç aşamada çalışır:

  1. Bir potansiyel müşteri, Facebook Potansiyel Müşteri Formunuzu doldurur.
  2. Otomasyon platformunuz yeni potansiyel müşteriyi algılar ve bilgileri otomatik olarak (iki API çağrısı kullanarak) Your AI Connector'a gönderir.
  3. Your AI Connector kişiyi oluşturur ve belirttiğiniz listeye ekler.

Oradan itibaren, atadığınız bir yayın, kampanya veya Yapay Zeka Temsilcisi gerisini halleder; ister yapay zeka destekli bir karşılama mesajı, ister bir damla dizisi veya manuel bir takip olsun.

1. Adım: Facebook Potansiyel Müşteri Formunuzu Oluşturun

  1. Facebook Reklam Yöneticisi’ni açın.
  2. Potansiyel Müşteriler hedefiyle yeni bir kampanya oluşturun.
  3. Reklam düzeyinde, potansiyel müşteri yöntemi olarak Anında Form’u seçin.
  4. Formunuzu ihtiyacınız olan alanlarla oluşturun. En azından şunları ekleyin:
    • Ad
    • Telefon numarası (ülke kodu ile)
    • İsteğe bağlı: Soyadı, e-posta
  5. Reklamı yayınlayın veya formu test etmek için taslak olarak kaydedin.

2. Adım: Potansiyel Müşteri Formunu Test Edin

Otomasyonu bağlamadan önce bir test potansiyel müşterisi gönderin:

  1. Reklam Yöneticisi’nde Potansiyel Müşteri Formunuza gidin.
  2. Önizleme’ye tıklayın ve formu test verileriyle doldurun.
  3. Test potansiyel müşterisinin Facebook Potansiyel Müşteri Merkezi’nde (Facebook Sayfanızdaki Yayınlama Araçları altında veya Reklam Yöneticisi’nde “Potansiyel Müşteriler” altında) göründüğünü doğrulayın.

Bu test girişi, otomasyon platformunuzdaki alan eşlemesini ayarlamak için kullanılacaktır.

3. Adım: Otomasyonu Ayarlayın

Facebook Lead Ads’i Tetikleyici Olarak Bağlayın

  1. Otomasyon platformunuza (Pabbly, Zapier veya Make) giriş yapın.
  2. Yeni bir iş akışı / senaryo / zap oluşturun.
  3. Tetikleyiciyi “Facebook Lead Ads - New Lead” olarak ayarlayın.
  4. Facebook hesabınızı bağlayın ve Sayfa ile Potansiyel Müşteri Formunu seçin.
  5. Bağlantının çalıştığını doğrulamak ve alanları eşleştirmek için test verisini çekin.

API Çağrısı 1’i Yapılandırın: Kişi Oluştur

HTTP / Webhook / API İsteği içeren bir eylem adımı ekleyin:

  • Yöntem: POST
  • URL: https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
  • Başlıklar:
    Content-Type: application/json
  • Gövde (JSON):
    {
  "firstName": "{{first_name}}",
  "lastName": "{{last_name}}",
  "phone": "{{phone_number}}",
  "email": "{{email}}"
}

{{placeholders}} kısmını tetikleyici adımınızdaki gerçek alan eşlemeleriyle değiştirin.

Önemli: Telefon numarası ülke kodunu içermelidir (örneğin, ABD için +1 veya Hollanda için +31). Eğer potansiyel müşteri formunuz telefon numarasını ülke kodu olmadan topluyorsa, otomasyonunuza bunu başına ekleyecek bir biçimlendirme adımı ekleyin.

API yanıtı, yeni kişinin kimliğini data.contactId adresinde döndürür. Bu değeri kaydedin; bir sonraki adım için buna ihtiyacınız olacak.

İkinci çağrıyı atlayabilirsiniz. POST /v1/contacts, oluşturma gövdesinde listId (tek bir liste) veya listIds (birkaç liste) değerlerini de kabul eder; bu, yeni kişiyi aynı istek içinde bu listelere ekler. Aşağıdaki iki adımlı sürümü yalnızca otomasyon platformunuzun, hangi listenin kullanılacağına karar vermeden önce kişinin var olmasını gerektirdiği durumlarda kullanın.

API Çağrısı 2’yi Yapılandırın: Kişiyi Listeye Ekle

İkinci bir eylem adımı ekleyin:

  • Yöntem: POST
  • URL: https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
  • Üstbilgiler:
    Content-Type: application/json
  • Gövde (JSON):
    {
  "contactId": "{{contact_id_from_previous_step}}",
  "listId": "YOUR_LIST_ID"
}

YOUR_LIST_ID değerini kişi listenizin gerçek kimliğiyle değiştirin (aşağıdaki Liste Kimliğinizi Bulma bölümüne bakın) ve contactId değerini ilk API çağrısı tarafından döndürülen data.contactId ile eşleyin.

Liste ID’nizi Bulma

  1. Your AI Connector içinde Kişiler’e, ardından Listeler sekmesine tıklayın.
  2. İstediğiniz listenin yanındaki satır menüsünü (“⋯”) açın ve Liste kimliğini kopyala seçeneğine tıklayın.

Listeler sayfasının tam açıklaması için Listeleri ve Kişileri Düzenleme bölümüne bakın.

Adım 4: Tam İş Akışını Test Edin

  1. Facebook formunuz aracılığıyla başka bir test potansiyel müşterisi gönderin (veya otomasyon platformunuzdaki mevcut test potansiyel müşterisini tekrar oynatın).
  2. Şunları doğrulamak için Your AI Connector’ı kontrol edin:
    • Kişi, doğru ad, telefon numarası ve e-posta ile oluşturuldu.
    • Kişi, doğru listeye eklendi.
  3. O listeye otomatik olarak mesaj göndermek için ayarlanmış bir yayın, kampanya veya Yapay Zeka Temsilciniz varsa, beklendiği gibi tetiklendiğini doğrulayın.

Veri Referansı

Aşağıda, entegrasyon sırasında gönderilen ve alınan verilerin örnekleri yer almaktadır.

Kişi Oluştur - İstek 

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"
}

Kişi Oluştur - Yanıt 

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

Kişiyi Listeye Ekle - İstek 

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

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

İpuçları

  • Yinelenen kayıt yönetimi: Aynı telefon numarasına sahip bir kişi zaten mevcutsa, oluşturma çağrısı {"success": false, "error_code": 409} döndürür ve mevcut kişiyi döndürmez. error_code üzerinde dallanma yapın (HTTP durumu 200’dür) ve listeye ekleme çağrısından önce GET /v1/contacts?phoneNumber=... ile kişiyi aratın.
  • Birden fazla form: Farklı potansiyel müşteri formları için, her biri farklı bir listeyi ve farklı bir yayını, kampanyayı veya Yapay Zeka Temsilcisini hedefleyen ayrı otomasyon iş akışları oluşturun.
  • Hata bildirimleri: Bir API çağrısı başarısız olursa sizi bilgilendirmesi için otomasyon platformunuzu yapılandırın, böylece potansiyel müşterileri kaybetmezsiniz.

Sonraki Adımlar