Entegrasyonlar
HubSpot
Her gönderimin yanıtlarını bir HubSpot kişisine yazın. Formstep kişiyi e-postayla bulur, varsa günceller, yoksa oluşturur.
Ne elde edersiniz
- Her e-posta adresi için bir HubSpot kişisi: mevcut kişi güncellenir, yeni bir e-posta yeni bir kişi oluşturur
- Tip uyumluluk kontrolüyle kişi özelliklerine alan düzeyinde eşleme
- Katılımcının yaptığı bir düzenleme aynı kişiyi yeniden günceller
- Boş yanıtlar bir özelliği asla temizlemez; eşlemediğiniz özellikler olduğu gibi kalır
- Gerektiren hesaplar için yeni kişilere yasal dayanak
- Yalnızca ayrılmış bir test kişisine dokunan test gönderimi
- Yeni istek panelinde bir kişi bulun, isteği o kişiden ön doldurun ve yanıtları aynı kişiye geri yazın
HubSpot’ı bağlayın
- 1
Form ayarları → Entegrasyonlar bölümünü açın
CRM grubunda HubSpot’ı seçin.
- 2
Bir HubSpot hesabı bağlayın
Mevcut bir bağlı HubSpot hesabı seçin ya da yeni bir hesap bağlayın. Hesabı seçmek ve erişimi onaylamak için HubSpot’a yönlendirileceksiniz. Ardından Formstep hesabın kişi özelliklerini yükler ve kaçının eşlemeye hazır olduğunu gösterir.
- 3
Form alanlarını → kişi özelliklerine eşleyin
Her form alanını bir kişi özelliğiyle eşleştirin. Yalnızca uyumlu özellikler gösterilir. Bir form alanı E-posta ile eşlenmelidir, çünkü kişi bu şekilde bulunur. Her satırdaki ok, değerlerin hangi yöne gittiğini belirler: → yanıtlar HubSpot’ı günceller, ← seçtiğiniz bir kişi alanı ön doldurur, ↔ ikisi de. Hesap yasal dayanak istiyorsa, onu da burada seçin.
- 4
Sonlandır
"Test gönder"i kullanarak örnek değerleri formstep-test@example.com test kişisine yazın. Kaydettiğinizde yeni gönderimler kişileri güncellemeye başlar.
Bir gönderim kişisini nasıl bulur
E-posta ile eşlediğiniz form alanının yanıtı, bir gönderimin hangi kişiye ait olduğunu belirler. Tamamlanan her gönderimde Formstep şunları yapar:
- Bu e-postaya sahip HubSpot kişisini günceller; yalnızca eşlediğiniz özellikleri yazar.
- Bu e-postaya sahip bir kişi yoksa kişiyi oluşturur. Yeni kişi eşlenen yanıtları, e-postayı ve yasal dayanağı alır.
Bir katılımcı gönderimini düzenlediğinde aynı kişi yeni yanıtlarla yeniden güncellenir. Boş bırakılan bir yanıt atlanır, bu yüzden HubSpot’ta zaten bulunan bir değeri asla temizlemez; eşlemediğiniz özelliklere ise hiç dokunulmaz.
Yeni istek panelinde bir kişiden ön doldurduğunuz istek bunun dışındadır: yanıtları, hangi e-posta yazılmış olursa olsun o kişiyi günceller. Bkz. İstekler ve prefill.
E-posta sorusunu zorunlu yapın
E-posta yanıtı olmayan bir gönderimin güncelleyeceği bir kişi yoktur; bu yüzden teslimi başarısız olur ve yeniden denenmez. E-posta ile eşlediğiniz soruyu zorunlu olarak işaretleyin.
Yeni kişiler için yasal dayanak
Veri gizliliği ayarları açık olan HubSpot hesapları (AB’deki hesaplarda varsayılan olarak açıktır), verilerini işlemek için yasal bir dayanak olmadan kişi oluşturmayı reddeder. Hesabınızda bu ayar varsa Yapılandır adımı, hesabınızın kendi seçenekleriyle Yeni kişiler için yasal dayanak alanını gösterir ve devam etmeden önce birini seçmeniz gerekir.
Formstep yasal dayanağı yalnızca bir kişi oluştururken yazar. Mevcut bir kişi zaten sahip olduğu yasal dayanağı korur, çünkü bu değer ekibinizin topladığı onayı kaydeder. Yasal dayanak hiçbir zaman eşleme hedefi olarak sunulmaz.
Özellik türleri
| Form alanı | Uyumlu HubSpot özellikleri |
|---|---|
| Herhangi bir alan | Single-line text, Multi-line text |
| Sayı, Değerlendirme, Ölçek | Number, ayrıca metin |
| Tarih | Date picker, Date and time picker, ayrıca metin |
| Telefon | Phone number, ayrıca metin |
| Radyo, Açılır liste, Onay kutuları, Resim seçimi | Dropdown select, Radio select, Multiple checkboxes, ayrıca metin |
| Geçiş anahtarı | Single checkbox, ayrıca metin |
| Tekrarlayan grup (grubun tamamı) | Yalnızca metin |
Bir seçim yanıtı, dahili değeri veya etiketi Formstep seçeneğinin anahtarı veya etiketiyle (büyük/küçük harf yok sayılarak) eşleşen HubSpot seçeneğine gider. Eşleşen seçeneği olmayan bir yanıt, yazma işleminin tamamını başarısız kılmak yerine dışarıda bırakılır.
- Seçilen birden çok seçenek, bir Multiple checkboxes özelliğine birlikte gider.
Meta veriler de eşlenebilir; örneğin Submitted at bir tarih özelliğine veya PDF Link bir metin özelliğine.
Salt okunur, hesaplanan, gizli ve arşivlenmiş özellikler yazılamaz, bu yüzden sunulmaz. Özellik listesi entegrasyonu her açışınızda yenilenir; yüklenemezse Tekrar dene’ye basın.
Test etkinliği
Sonlandır adımında ve entegrasyon ayrıntı panelinin her ikisinde de bir Test gönder düğmesi bulunur. Bu düğme
formstep-test@example.com kişisine yazar, kişi yoksa oluşturur ve başka hiçbir kişiyi asla değiştirmez. Metin özellikleri
[Soru başlığı] dizelerini, sayılar 0 değerini, tarihler bugünün tarihini, Single checkbox özellikleri
Hayır değerini alır; açılır listeler ise özelliğin ilk HubSpot seçeneğini kullanır. İşiniz bittiğinde test kişisini HubSpot’ta
silin.
İstekler ve prefill
Formda bir HubSpot entegrasyonu varsa Yeni istek paneli, alıcının altında HubSpot’ta bul alanını gösterir. Ad, e-posta, telefon veya şirkete göre arayıp bir kişi seçin: kişinin e-postası ve adı alıcı olur, satırı ön dolduran (← veya ↔) her form alanı kişinin değerini alır. Pro ve Business’ta birkaç kişiyi işaretleyip hepsini tek seferde, her biri için ayrı bir istek olarak ekleyebilirsiniz: Birden çok kişiye gönderme sayfasına bakın. Göndermeden önce her şeyi yine değiştirebilirsiniz. Alıcı isteği tamamladığında, farklı bir e-posta yazmış olsa bile yanıtlar aynı kişiyi kimliğiyle günceller; kişinin e-postası hiçbir zaman değiştirilmez.
- Değerler, kişiyi seçtiğiniz anda bir kez okunur. HubSpot’ta bundan sonra yapılan bir değişiklik isteğe yansımaz.
Ön doldurulamayan bir alan düz → okunda kalır: dosya, imza, ödeme, seçenek listesi, matris, tekrarlayan grup, meta veri veya hesaplanan alan. Gizli bir alan değerini bağlam olarak alır.
Bir seçim alanı, anahtarı veya etiketi HubSpot seçeneğiyle (büyük/küçük harf yok sayılarak) eşleşen seçeneği alır. Hiçbir seçeneğe uymayan bir değer dışarıda bırakılır.
Kendin dene aynı değerleri doldurur ama HubSpot’ı asla güncellemez: test isteği entegrasyonlara ulaşmaz.
- Alıcı göndermeden önce kişi silinirse, yanıtlar bunun yerine gönderilen e-postaya sahip kişiye gider.
Yalnızca panelde
API ve MCP HubSpot’u okumaz. İstek oluşturan bir otomasyon kişiyi kendisi arar (n8n ve Zapier’ın ikisinde de bunun için bir HubSpot
adımı vardır) ve değerleri prefill içinde iletir. E-posta ile eşlenen alanı kişinin e-postasıyla ön doldurup kilitleyin;
yanıtlar o kişiyi e-postayla günceller. Bkz. Prefill.
Ne yapmaz
- Terk edilmiş gönderimler HubSpot’a gönderilmez. Yalnızca tamamlanan gönderimler ve düzenlemeler kişileri günceller.
- Bağlandığınızda mevcut gönderimler dışa aktarılmaz. Kişiler bir sonraki gönderimden itibaren güncellenir.
- Yalnızca kişilere yazar; şirketlere, fırsatlara veya destek kayıtlarına yazmaz.
HubSpot’taki özellik değişiklikleri
Formstep eşlenen özelliklerin güncel tanımlarını her teslimde okur. HubSpot’ta eşlenmiş bir özelliği silerseniz, o özellik yazma işleminin dışında bırakılır ve kişinin geri kalanı yine de güncellenir. Bir özelliğin türü veya seçenekleri değişirse yanıtlar yeni tanıma dönüştürülür; yeni tür artık form alanına uymuyorsa eşleme bir uyarı gösterir, böylece o alanı yeniden eşleyebilirsiniz.
Sorun giderme
Yetkilendirme süresi doldu — HubSpot erişim token’ları 30 dakika geçerlidir ve otomatik olarak yenilenir. Yenileme başarısız olursa, örneğin uygulama HubSpot’ta kaldırıldığı için, bağlantı süresi dolmuş olarak işaretlenir ve üzerindeki entegrasyonlar durur. Yeniden Bağlan’a basın.
Bir değer reddedildi — HubSpot bir değeri reddedebilir; örneğin özellikte tanımlı bir doğrulama kuralını çiğneyen bir değeri. Son etkinlikler altındaki başarısız kayıt HubSpot’un kendi mesajını gösterir. Form alanını veya özelliği düzeltin, ardından yeniden göndermek için başarısız teslimatlar bölümüne bakın.
Kişi özellikleri yüklenemedi — Tekrar dene’ye basın. Başarısız olmaya devam ederse hesabı yeniden bağlayın.
SSS
Kişileri okuma ve yazma, ayrıca kişi özelliği tanımlarını okuma. Formstep OAuth kullanır; yönetilecek API anahtarı yoktur ve şirketlere, fırsatlara veya diğer nesnelere erişim istemez.
Evet. HubSpot bağlantıları çalışma alanı kapsamındadır. Herhangi bir üye, entegrasyon kurarken bağlı hesapları kullanabilir.
Evet. Yeni bir entegrasyon kurulumu sırasında başka bir hesap bağlayın. Her form hangi hesabın kullanılacağını seçer.
Hayır. Düzenleme, gönderimdeki e-postaya sahip kişiyi günceller. Katılımcı e-posta yanıtının kendisini değiştirirse yeni e-posta farklı bir kişidir; bu yüzden onun yerine o kişi güncellenir veya oluşturulur.
Form ayarları → Entegrasyonlar → HubSpot’a gidin ve entegrasyonu silin. Formstep’in erişimini de iptal etmek için HubSpot’ta Settings → Integrations → Connected apps altından Formstep uygulamasını kaldırın.