Web Sitesi Formlarından Hipcall'a Lead Aktarma (Takip Kodu Alan Eşleştirmesi)

Hipcall takip kodunu (h.js) sitenize eklediğinizde, web sitenizdeki formlardan
gelen müşteri adaylarını (lead) doğrudan Hipcall CRM'e aktarabilirsiniz. Bu
makale, form alanlarınızı nasıl etiketleyeceğinizi ve hangi alanların Hipcall'a
gönderildiğini açıklar.

Bu makale ne işinize yarar?

Sitenizdeki bir iletişim/teklif formundan gelen kişileri otomatik olarak
Hipcall'da kişi (lead) olarak oluşturmak
Hangi form alanlarının tanındığını ve nasıl eşleştiğini öğrenmek
company_name (firma adı) gibi alanların Hipcall'da tam olarak nereye
yazıldığını anlamak

Ön koşullar

Hipcall takip kodunun sitenizin tüm sayfalarına eklenmiş olması.
Lead toplamak istediğiniz formun, Hipcall Ayarlar → Pazarlama → Lead
Formları bölümünde tanımlanmış olması (forma ait token buradan alınır).
Formunuza, gönderildiğini belirten data-hipcall-form="<token>" özniteliğinin
eklenmesi.

Not: Takip kodu, formunuzun normal çalışmasına asla müdahale etmez.
Kendi gönderim/yönlendirme akışınız aynen devam eder; Hipcall sadece arka
planda bir kopya alır.

Adım 1: Formu Hipcall için işaretleyin

Formunuzun <form> etiketine, Lead Formları ekranından aldığınız token
değerini ekleyin:

<form data-hipcall-form="form_xxxxxxxxxxxxxxxx" ...>

Adım 2: Form alanlarını etiketleyin

Hipcall yalnızca data-hipcall özniteliği taşıyan alanları okur. Diğer
alanlarınız (şifre, mesaj vb.) hiçbir zaman okunmaz — bu bir gizlilik kuralıdır.

Bir alanı etiketlemek için ilgili input'a data-hipcall="<alan_adı>" ekleyin.

Standart (tanınan) alanlar

Etiket	Açıklama	Hipcall'da karşılığı
`data-hipcall="email"`	E-posta adresi	Kişinin e-postası (eşleştirmede 1. öncelik)
`data-hipcall="phone"`	Telefon numarası	Uluslararası biçime (E.164) çevrilip kişiye yazılır (eşleştirmede 2. öncelik)
`data-hipcall="first_name"`	Ad	Kişinin adı
`data-hipcall="last_name"`	Soyad	Kişinin soyadı
`data-hipcall="name"`	Ad Soyad (tek alan)	`first_name`/`last_name` yoksa ilk boşluktan bölünür
`data-hipcall="company_name"`	Firma adı	⚠️ Aşağıdaki nota bakın

İpucu: En az bir tanımlayıcı bilgi (ad, e-posta veya telefon)
bulunmalıdır. Hiçbiri yoksa kayıt oluşturulmaz.

⚠️ `company_name` alanı hakkında önemli bilgi

company_name tanınan bir standart alandır, ancak şu an için:

Hipcall'da ayrı bir Firma (Company) kaydı oluşturmaz veya eşleştirmez.
Değeri, oluşturulan kişinin açıklama (not) alanına Firma: <değer>
biçiminde yazılır.
Yalnızca yeni bir kişi oluşturulurken yazılır. Form, daha önce var olan
bir kişiyle eşleşirse (örneğin aynı e-posta), bu not yazılmaz ve mevcut
kişinin bilgileri değiştirilmez.

Adım 3 (isteğe bağlı): Özel alanlar

Standart listede olmayan bir bilgiyi de göndermek isterseniz
data-hipcall="field:<isim>" kullanın:

<input type="text" name="sektor" data-hipcall="field:sector">

Önemli: Özel alanlar form kaydının ham verisinde saklanır (denetim/iz
kaydı), ancak şu an için kişinin CRM kartına ayrı bir alan olarak
işlenmez. Bir bilginin kişi kartına geçmesini istiyorsanız onu yukarıdaki
6 standart alandan birine eşleyin.

Adım 4 (isteğe bağlı): Alan eşleştirme (raw=canonical)

Form alanlarınızı doğrudan data-hipcall ile etiketleyemiyorsanız (örneğin
hazır bir form aracı kullanıyorsanız), Lead Formu ayarlarındaki Alan
Eşleştirme kutusunu kullanabilirsiniz. Her satıra bir eşleme, ham=standart
biçiminde yazılır:

telefon=phone
ad_soyad=name
eposta=email
firma=company_name

Kritik: Eşin sağ tarafı mutlaka şu altı standart addan biri olmalıdır,
aksi halde bilgi kişi kartına işlenmez:
email, phone, first_name, last_name, name, company_name.

Tam örnek form

<form data-hipcall-form="form_xxxxxxxxxxxxxxxx" action="/tesekkurler" method="post">
  <input type="text"  name="ad"      data-hipcall="first_name"   placeholder="Ad">
  <input type="text"  name="soyad"   data-hipcall="last_name"    placeholder="Soyad">
  <input type="email" name="eposta"  data-hipcall="email"        placeholder="E-posta">
  <input type="tel"   name="telefon" data-hipcall="phone"        placeholder="Telefon">
  <input type="text"  name="firma"   data-hipcall="company_name" placeholder="Firma">

  <!-- Bot tuzağı (honeypot): kullanıcıya gizli tutun -->
  <input type="text" name="website" data-hipcall="hp" style="display:none" tabindex="-1" autocomplete="off">

  <button type="submit">Gönder</button>
</form>

Spam koruması (honeypot): data-hipcall="hp" ile gizli bir alan ekleyin
ve CSS ile gizleyin. Gerçek kullanıcılar bu alanı görmez ve boş bırakır;
botlar genellikle doldurur. Bu alan dolu gelen gönderiler kişi olarak
oluşturulmaz.

Gönderildiğinde ne olur?

Form gönderildiğinde takip kodu, etiketli alanları + ziyaretçinin atıf
bilgilerini (kaynak, UTM, tıklama kimlikleri vb.) Hipcall'a iletir.
Hipcall, hesabınız içinde aynı e-posta veya telefona sahip bir kişi arar:
- Eşleşme varsa: mevcut kişi bu lead'e bağlanır; adı, kaynağı ve yaşam
  döngüsü bilgileri korunur (üzerine yazılmaz).
- Eşleşme yoksa: formun ayarındaki kaynak, yaşam döngüsü ve atanan
  temsilci ile yeni bir kişi oluşturulur.
Telefon numarası uluslararası biçime çevrilir; çözümlenemezse ham hâliyle
saklanır, kaybolmaz.

[Screenshot: Lead Formları ayar ekranı — token ve Alan Eşleştirme kutusu]

[Screenshot: Yeni oluşan bir lead'in CRM kişi kartı — Firma notu görünümü]

Sık sorulan sorular

Telefon numarası nasıl yazılmalı?

Tercihen ülke koduyla (+90...) yazılması en güvenlisidir. Hipcall numarayı
otomatik olarak uluslararası biçime çevirmeye çalışır.

Firma adı neden CRM'de Firma kaydı olarak görünmüyor?

Şu an için company_name, ayrı bir Firma kaydı oluşturmaz; kişinin açıklama
(not) alanına Firma: ... olarak eklenir. Bu, yalnızca kişi ilk kez
oluşturulurken yazılır.

Aynı kişi formu iki kez doldurursa ne olur?

Aynı e-posta veya telefona sahip mevcut kişi bulunur ve lead ona bağlanır;
yinelenen (mükerrer) kişi oluşturulmaz.

Formdaki diğer alanlarım (mesaj, şifre vb.) Hipcall'a gider mi?

Hayır. Yalnızca data-hipcall ile etiketlediğiniz alanlar okunur.