Web formu, webhook ve API ile başvuru almak

Başvurular yalnız Instagram/Facebook reklam formlarından gelmez. Piyzi'de üç yol daha var; hepsinde başvuru Başvurular ekranına düşer, telefon numarasıyla müşteri listenize bağlanır ve aynı otomasyonları çalıştırır:

• Web formu: Piyzi'nin hazır başvuru formu. Bağlantısını paylaşırsınız ya da kendi web sitenize gömersiniz.

• Webhook: başka bir araçtaki formunuzu (Zapier, Make, Typeform, Jotform, Tally, Google Forms…) size özel gizli bir adresle bağlarsınız.

• Piyzi API: yazılımcınız kendi sitenizden ya da sisteminizden başvuruyu doğrudan gönderir.

Hepsini Başvurular › Formlar ve kaynaklar sekmesinden yönetirsiniz. Görmek için Başvuruları görebilir, eklemek ve değiştirmek için Entegrasyonları yapabilir yetkisi gerekir (işletme sahibinde ikisi de her zaman vardır).

Web formu oluşturma

1. 1

   Yeni form

   Formlar ve kaynaklar sekmesinde Yeni web formu düğmesine tıklayın.

2. 2

   Adı ve başlığı yazın

   Form adı panelde ve başvurularda görünür; otomasyon mesajlarında form adı olarak bu yazılır. Sayfa başlığı ve isteğe bağlı Açıklama ziyaretçinin formun üstünde gördüğü metindir.

3. 3

   Alanları seçin

   Ad Soyad ve Telefon her formda vardır ve zorunludur. E-posta alanını sorulmasın, isteğe bağlı ya da zorunlu yapabilirsiniz. Soru ekle ile en çok 10 soru ekleyin: kısa cevap, uzun cevap ya da seçenekli (her satıra bir seçenek). Soruları oklarla sıralayabilir, zorunlu yapabilirsiniz.

4. 4

   Son dokunuşlar

   İsterseniz düğme metnini ve gönderimden sonra gösterilecek teşekkür mesajını değiştirin, sonra Oluştura tıklayın.

Formu paylaşma ve sitenize gömme

Form oluşunca Paylaş penceresi açılır (sonra satırdaki Paylaş düğmesinden de açılır):

• Form bağlantısı: site adresinizin sonuna /basvuru/… eklenmiş adres. Instagram biyografinize, reklamınıza, WhatsApp mesajınıza ya da bir QR koduna koyabilirsiniz.

• Gömme kodu: kendi web sitenizde formun görüneceği yere yapıştırın. Form, sayfanızın içinde kendi yüksekliğini ayarlar.

• Formun altında, bilgilerin başvuruyla ilgili iletişim için kullanılacağı yazar ve KVKK aydınlatma metninize bağlantı verilir (Ayarlar › Diğer Ayarlar › Sözleşmeler).

• Kötüye kullanıma karşı aynı internet bağlantısından saatte en çok 30, aynı numaradan saatte en çok 5 başvuru alınır; botların doldurduğu gönderimler kaydedilmez.

• Bir işletmede en çok 20 web formu açabilirsiniz.

Webhook ile başka bir aracı bağlama

1. 1

   Yeni webhook

   Yeni webhook düğmesine tıklayın ve bir ad verin (örn. "Typeform kampanya formu").

2. 2

   Adresi kopyalayın

   Size özel gizli adres yalnız bir kez gösterilir; hemen kopyalayın. Kaybederseniz satırın menüsündeki Adresi yenile ile yenisini oluşturursunuz (eski adres hemen çalışmaz olur).

3. 3

   Aracınıza yapıştırın

   Zapier, Make ya da form aracınızda bir Webhook adımı ekleyin, yöntem olarak POST seçin, adresi yapıştırın. Veriyi JSON ya da form verisi olarak gönderin.

• Alan adları serbesttir. Ad, telefon ve e-posta Türkçe ya da İngilizce adlarından tanınır (ad_soyad, isim, name, telefon, cep, phone, email, e-posta…); diğer her alan başvurunun cevabı olur ve müşterinin notuna yazılır.

• En az bir ad, telefon ya da e-posta gönderilmelidir.

• Araç aynı başvuruyu tekrar gönderebiliyorsa externalId (ya da submission_id, event_id) alanı gönderin: aynı kimlikle gelen ikinci istek yeni başvuru açmaz.

• Denemek için test: true gönderin: başvuru "Test" olarak kaydedilir, müşteri açılmaz ve otomasyon çalışmaz.

• Bir webhook saatte en çok 600 başvuru alır. Bir işletmede en çok 10 webhook açabilirsiniz.

• Google Forms: formun Apps Script'inde gönderim tetikleyicisiyle cevapları bu adrese POST edebilirsiniz.

Piyzi API ile göndermek

Pi Store'da Piyzi API açıksa yazılımcınız başvuruyu POST /v1/leads ucuyla gönderebilir. Kimlik doğrulama ve IP izin listesi Piyzi API makalesindekiyle aynıdır; gövde kuralları webhook ile aynıdır. Cevapta başvurunun kimliği, yeni mi yoksa daha önce gönderilmiş mi olduğu ve müşterinin açıldığı ya da bağlandığı yazar.

Piyzi API ile ilk başvuru gelince Formlar ve kaynaklar sekmesinde Piyzi API satırı belirir; buradan müşteri kartı açmayı kapatabilir ya da API'den başvuru almayı devre dışı bırakabilirsiniz.

Başvuru gelince ne olur?

• Telefon Türkiye cep numarasıysa müşteri oluşturulur. Kanalı Web Formu, ayrıntısında formun ya da webhook'un adı yazar.

• Numara zaten kayıtlıysa yeni müşteri açılmaz; başvuru o müşteriye bağlanır. Müşterinin adı değişmez; farklı ad gelirse başvuruda Ad farklı işareti çıkar.

• Telefon yoksa ya da yurt dışı numaraysa müşteri açılmaz; başvuru yalnız Başvurular ekranında kalır.

• Cevaplar müşterinin Notlar sekmesine "Başvuru formu" kaynağıyla yazılır.

• Kaynağın Başvurudan müşteri kartı aç ayarını kapatırsanız yeni kişiler için müşteri açılmaz.

• Form Başvurusu Geldiğinde otomasyonu çalışır: Hazır Otomasyonlar'daki "Form başvuruları" kategorisiyle sahibe bildirim ve başvurana "başvurunuz alındı" mesajı kurabilirsiniz. Sınırlar Meta formlarıyla aynıdır (aynı numaraya 24 saatte bir mesaj, form başına günde 200).

Devre dışı bırakma ve silme

• Devre dışı bırak: web formu "Form kullanılamıyor" der, webhook ve API yeni başvuruyu reddeder. Yeniden etkinleştirince kaldığı yerden çalışır.

• Sil: bağlantı ya da adres kalıcı olarak çalışmaz olur. Gelmiş başvurular ve müşteriler silinmez.