Genel Bakış
OneSignal HubSpot entegrasyonu, HubSpot CRM’inizi yerel workflow eylemleri aracılığıyla OneSignal’a bağlar — üçüncü taraf bir ara katman yazılımına gerek yoktur. Şunları yapabilirsiniz:- Mesaj gönderin — HubSpot Workflow’larından anlık bildirim, e-posta ve SMS tetikleyin
- Kullanıcı oluşturun — HubSpot kişilerini e-posta ve SMS abonelikleriyle birlikte OneSignal ile senkronize edin
- Etiketleri yönetin — HubSpot kişi özelliklerine göre OneSignal Etiketlerini ayarlayın veya silin
- Uygulama içi mesajları hedefleyin — HubSpot tarafından ayarlanan etiketleri kullanarak uygulama içi mesaj teslimini kontrol eden segmentler oluşturun
Ön Koşullar
- HubSpot Süper Yönetici rolü veya Uygulama Pazaryeri İzinleri
- Ücretli bir OneSignal planı (ücretsiz planlarda mevcut değil)
HubSpot, orijinal üçüncü taraf OneSignal uygulamasını Aralık 2024’te kullanımdan kaldırdı. OneSignal artık genişletilmiş işlevselliğe sahip kendi HubSpot uygulamasını sunmaktadır. Önceki entegrasyonu kullandıysanız aşağıdaki geçiş adımlarına bakın.
Eski HubSpot entegrasyonundan geçiş
Eski HubSpot entegrasyonundan geçiş
Yeni entegrasyonu yükleyinAşağıdaki HubSpot’u OneSignal’a Bağlama bölümünde açıklandığı gibi OneSignal kontrol panelindeki Veri > Entegrasyonlar altından HubSpot entegrasyonunu etkinleştirin.Workflow’larınızı taşıyınMevcut workflow’larınızdaki eylemleri değiştirmeden önce yeni entegrasyonu test etmek için yeni bir workflow oluşturmanızı öneririz.
- Workflow’unuzu kopyalayın — HubSpot Workflow’lar sayfasında mevcut workflow’unuzun yanındaki Kopyala’ya tıklayın.
- Tetikleyicileri kaldırın — Kopyalanan workflow’da, yayımlandığında otomatik olarak tetiklenmemesi için tüm kayıt tetikleyicilerini kaldırın.
- Eski eylemleri değiştirin — Her eski OneSignal eylemini kaldırın ve yeni sürümüyle değiştirin. Her iki uygulama da yüklüyse eski uygulama “Built by HubSpot” gösterir — göstermeyen olanı kullanın.
- Tek bir kişiyle test edin — Workflow’u kaydedin ve yayımlayın, ardından bir test kişisini manuel olarak kaydedin. Eylemlerin başarıyla tamamlandığını doğrulamak için kayıt geçmişini kontrol edin.
- Değiştirin veya güncelleyin — Workflow’un doğru çalıştığını doğruladıktan sonra orijinal workflow’u klonla değiştirin ya da aynı değişiklikleri orijinal workflow’a uygulayın.
support@onesignal.com adresiyle iletişime geçin.HubSpot’u OneSignal’a Bağlama
Entegrasyonu etkinleştirme
OneSignal’da Veri > Entegrasyonlar > Katalog bölümüne gidin ve HubSpot’u seçin.
Harici ID ile kullanıcıları eşleştirme
HubSpot kişilerini OneSignal kullanıcılarına bağlamak için OneSignal’daki Harici ID’yi HubSpot’taki benzersiz bir özellikle (ör. kullanıcı kimliği veya e-posta adresi) eşleşen bir değere ayarlayın. Uygulamanızda veya web sitenizde SDKlogin metodunu kullanarak Harici ID’yi ayarlayın. Eşleştirmenin güvenilir olması için hem uygulamanızda hem de HubSpot’ta kolayca erişilebilen bir özellik seçin.
Kimlik ve abonelik yönetimi hakkında ayrıntılar için Kullanıcılar ve Abonelikler bölümlerine bakın.
HubSpot workflow’u oluşturma
HubSpot’ta Otomasyon > Workflow’lar bölümüne gidin ve Workflow oluştur’a tıklayın. Kişi tabanlı’yı seçin ve kayıt tetikleyicilerinizi yapılandırın. OneSignal eylemi eklemek için workflow düzenleyicisinde +‘ya tıklayın ve “OneSignal” aratın.
- OneSignal Uygulaması — kurulum sırasında bağladığınız uygulama
- Harici ID — OneSignal’daki Harici ID ile eşleşen HubSpot kişi özelliği
OneSignal Eylemleri
HubSpot’tan OneSignal kullanıcıları oluşturma
Kullanıcı Oluştur eylemi, bir kişi workflow’dan geçtiğinde OneSignal’da bir Kullanıcı oluşturur. Yeni kişiler eklendikçe OneSignal ve HubSpot’u senkronize tutmak için kullanın. Aşağıdaki HubSpot özellikleri ayarlandığında OneSignal otomatik olarak karşılık gelen Abonelikleri oluşturur:- E-posta → OneSignal’da e-posta aboneliği oluşturur
- Telefon numarası → OneSignal’da SMS aboneliği oluşturur
HubSpot’tan OneSignal etiketlerini düzenleme
Etiketleri Düzenle eylemi, eşleşen OneSignal kullanıcısındaki Etiketleri ayarlar veya siler. Etiketler Mesaj Kişiselleştirmeyi ve Segmentasyonu etkinleştirir ve HubSpot’tan uygulama içi mesajları hedeflemenin mekanizmasıdır.Etiket ayarlama
Etiketler alanına bir JSON nesnesi girin:Etiket silme
Bir etiketi kaldırmak için değeri boş bir dize olarak ayarlayın:
HubSpot workflow’larından mesaj gönderme
Bildirim Gönder eylemi, eşleşen OneSignal kullanıcısına bir anlık bildirim, e-posta veya SMS iletir.
Ad) eklemenizi sağlar.
HubSpot ile uygulama içi mesajlar gönderme
Uygulama içi mesajlar bir HubSpot workflow’undan doğrudan gönderilemez. Bunun yerine kullanıcıları etiketlemek için HubSpot’u kullanın, ardından OneSignal’da segment tabanlı bir uygulama içi mesajla bu kullanıcıları hedefleyin.HubSpot'tan kullanıcıları etiketleyin
HubSpot workflow’unuzda kişilere etiket ayarlamak için Etiketleri Düzenle eylemini kullanın. Örneğin:
{ "hubspot_campaign": "spring_promo" }.OneSignal'da bir segment oluşturun
OneSignal kontrol panelinde Kitle > Segmentler bölümüne gidin ve Yeni Segment’e tıklayın. HubSpot tarafından ayarlanan etiket anahtar ve değeriyle eşleşen bir Kullanıcı Etiketi filtresi ekleyin (ör.
hubspot_campaign değeri spring_promo).Uygulama içi mesajı oluşturun
Mesajlar > Uygulama İçi bölümüne gidin ve yeni bir uygulama içi mesaj oluşturun. Kitle altında Belirli Segment(ler)e Göster’i seçin ve oluşturduğunuz segmenti seçin.Kullanıcılar HubSpot workflow’undan geçip etiketi aldıkça hemen segmente eklenir.
Tetikleyiciyi yapılandırın
Etiketler tek başına uygulama içi mesajları tetiklemez. Etiket kullanıcı uygulamayı aktif olarak kullanırken ayarlanırsa uygulama içi mesaj bir sonraki oturuma kadar görüntülenmez (uygulama 30+ saniye arka planda kalırsa yeni bir oturum başlar).Kullanılabilir tetikleyiciler:
- Uygulama açılışında — kullanıcı uygulamayı bir sonraki açışında görüntülenir
- Oturum süresi — oturumda belirli bir saniye sonra görüntülenir
- Son uygulama içi mesajdan bu yana geçen süre — arka arkaya mesajları önler
- Programatik — OneSignal SDK kullanarak uygulama kodunuzdan tetikleyin
Yaygın workflow kalıpları
HubSpot workflow’ları kayıt tetikleyicilerini (workflow’u başlatan olay) OneSignal eylemleriyle (OneSignal’da kullanıcıya ne olacağı) birleştirir. Aşağıda yaygın kullanım senaryoları için önerilen kalıplar yer almaktadır.Aşağıdaki tüm workflow kalıpları, HubSpot’u OneSignal’a zaten bağladığınızı ve kullanıcıları Harici ID aracılığıyla eşleştirdiğinizi varsayar.
Karşılama ve kullanıcı alıştırma
Yeni bir kullanıcı kaydolduğunda bir karşılama mesajı gönderin ve kullanıcı alıştırma uygulama içi mesajları için etiketleyin.| Adım | Tür | Yapılandırma |
|---|---|---|
| Kayıt tetikleyicisi | HubSpot | Kişi özelliği Müşteri olma tarihi biliniyorsa |
| Eylem 1 | OneSignal: Kullanıcı Oluştur | Harici ID’yi uygulamanızla eşleşen HubSpot kişi özelliğine (ör. kullanıcı kimliği veya e-posta adresi) ayarlayın |
| Eylem 2 | OneSignal: Etiketleri Düzenle | { "onboarding": "active", "name": "<First Name>" } — ad değeri için HubSpot Ad özellik tokenını ekleyin |
| Eylem 3 | OneSignal: Bildirim Gönder | Karşılama push şablonu kullanın veya kişiselleştirilmiş selamlama ile satır içi oluşturun |
Yeniden etkileşim
Uygulamanızı yakın zamanda ziyaret etmemiş kullanıcılara ulaşın.| Adım | Tür | Yapılandırma |
|---|---|---|
| Kayıt tetikleyicisi | HubSpot | Kişi özelliği Son etkinlik tarihi 14 günden fazla önce |
| Eylem 1 | OneSignal: Bildirim Gönder | Yeniden etkileşim push şablonu kullanın (ör. “Sizi özledik — işte yenilikler”) |
| Gecikme | HubSpot: 3 gün bekle | — |
| If/then dalı | HubSpot | Kişinin kayıttan bu yana sitenizi ziyaret edip etmediğini kontrol edin |
| Evet dalı | OneSignal: Etiketleri Düzenle | { "reengaged": "true" } |
| Hayır dalı | OneSignal: Bildirim Gönder | Daha güçlü teşvik içeren e-posta şablonu kullanın |
Yaşam döngüsü aşaması değişikliği
Farklı kullanıcı segmentlerini hedefleyebilmek için HubSpot’taki yaşam döngüsü aşaması değişikliklerini OneSignal etiketleriyle senkronize edin.| Adım | Tür | Yapılandırma |
|---|---|---|
| Kayıt tetikleyicisi | HubSpot | Kişi özelliği Yaşam döngüsü aşaması herhangi bir değere değişir |
| Eylem 1 | OneSignal: Etiketleri Düzenle | { "lifecycle_stage": "<Lifecycle Stage>" } — değer için HubSpot Yaşam Döngüsü Aşaması özellik tokenını ekleyin |
| If/then dalı | HubSpot | Yaşam döngüsü aşaması = Müşteri mi kontrol edin |
| Evet dalı | OneSignal: Bildirim Gönder | ”Ailemize hoş geldiniz” push veya e-posta şablonu kullanın |
Anlaşma kapandı / satın alma sonrası
Bir anlaşma kapandıktan sonra teşekkür mesajı tetikleyin ve üst satış kampanyaları için kullanıcıları etiketleyin.| Adım | Tür | Yapılandırma |
|---|---|---|
| Kayıt tetikleyicisi | HubSpot | Anlaşma özelliği Anlaşma aşaması = Kapalı Kazanıldı |
| Eylem 1 | OneSignal: Etiketleri Düzenle | { "customer": "true", "deal_value": "<Amount>" } — değer için HubSpot Anlaşma Tutarı özellik tokenını ekleyin |
| Eylem 2 | OneSignal: Bildirim Gönder | Teşekkür e-posta şablonu kullanın |
| Gecikme | HubSpot: 7 gün bekle | — |
| Eylem 3 | OneSignal: Bildirim Gönder | Üst satış/çapraz satış push şablonu kullanın |
Anlaşma tabanlı workflow’lar HubSpot’ta Anlaşma tabanlı workflow türü gerektirir. OneSignal kullanıcısını eşleştirmek için ilişkili kişinin Harici ID’sini kullanın.
Uygulama içi mesaj aracılığıyla tanıtım kampanyası
HubSpot listesi veya formu tarafından tetiklenen bir uygulama içi mesajla belirli bir kitleyi hedefleyin.| Adım | Tür | Yapılandırma |
|---|---|---|
| Kayıt tetikleyicisi | HubSpot | Kişi statik veya aktif listenin üyesi olur (ör. “İlkbahar İndirimi Uygun Olanlar”) |
| Eylem 1 | OneSignal: Etiketleri Düzenle | { "promo": "spring_2025" } |
promo = spring_2025 ile eşleşen bir OneSignal segmenti oluşturmak ve bu segment için bir uygulama içi mesaj yapılandırmak üzere HubSpot ile uygulama içi mesajlar gönderme adımlarını takip edin.
Kampanya sona erdiğinde kullanıcıları kampanyadan çıkarmak için etiketi silen ikinci bir workflow oluşturun:
| Adım | Tür | Yapılandırma |
|---|---|---|
| Kayıt tetikleyicisi | HubSpot | Tarih tabanlı, kampanya bitiş tarihine ayarlanmış |
| Eylem 1 | OneSignal: Etiketleri Düzenle | { "promo": "" } |
Sorun Giderme
Workflow eylemi HubSpot’ta “Başarısız” olarak görünüyor
- Hata mesajını kontrol edin — HubSpot workflow kayıt geçmişinde başarısız eylemi genişletin. Hata mesajı çoğunlukla nedeni belirtir (ör. “Kullanıcı bulunamadı,” “Geçersiz uygulama kimliği”).
- Harici ID’yi doğrulayın — Harici ID olarak kullanılan HubSpot kişi özelliğinin OneSignal’daki bir kullanıcıyla eşleştiğini doğrulayın. OneSignal > Kitle > Kullanıcılar bölümünde kullanıcı profilini kontrol edin ve Harici ID ile aratın.
- Entegrasyonun aktif olduğunu doğrulayın — OneSignal > Veri > Entegrasyonlar > HubSpot bölümüne gidin ve bağlantı durumunun aktif olduğunu doğrulayın.
Mesaj gönderildi ama kullanıcı almadı
- Abonelikleri kontrol edin — Kullanıcının gönderdiğiniz kanal (push, e-posta veya SMS) için aktif bir aboneliği olmalıdır. Bunu OneSignal’daki kullanıcı profilinde Abonelikler altında doğrulayın.
- Segment üyeliğini kontrol edin — Segment hedeflemeli bir şablon kullanıyorsanız kullanıcının hedef segmente ait olduğunu doğrulayın.
- Mesaj raporlarını inceleyin — OneSignal kontrol panelinde Mesajlar bölümüne gidin, mesajı bulun ve mesajın teslim edilip edilmediğini, reddedilip edilmediğini veya hata verip vermediğini görmek için teslim raporunu kontrol edin.
Etiketler OneSignal kullanıcısında görünmüyor
- Harici ID eşleşmesini doğrulayın — Workflow’daki Harici ID mevcut bir OneSignal kullanıcısıyla eşleşmezse Etiketleri Düzenle eylemi sessizce başarısız olur. Kullanıcının mevcut olduğundan emin olmak için Etiketleri Düzenle’den önce Kullanıcı Oluştur eylemini kullanın.
- JSON formatını kontrol edin — Etiketler geçerli bir JSON nesnesi olmalıdır. Yaygın hatalar arasında anahtarlar veya değerler etrafındaki tırnak işaretlerinin eksikliği, sondaki virgüller veya çift tırnak yerine tek tırnak kullanımı sayılabilir.
- Boş değerleri kontrol edin — Etiket değerini
""olarak ayarlamak etiketi siler. Eklenen HubSpot kişi özelliklerinin boş olmadığını doğrulayın.
Uygulama içi mesaj görüntülenmiyor
Aşağıdaki SSS’deki Etiket ayarlandıktan sonra uygulama içi mesajım neden görüntülenmedi? bölümüne bakın.SSS
HubSpot ile OneSignal arasında hangi veriler paylaşılır?
| HubSpot | Yön | OneSignal | Açıklama |
|---|---|---|---|
| Kişi özellikleri | → | Harici ID, Etiketler | HubSpot kişi verileri, Harici ID ve Etiketler aracılığıyla OneSignal kullanıcılarını eşleştirir ve zenginleştirir. |
| Workflow’lar | ← | Mesaj Şablonları | OneSignal Şablonları, HubSpot workflow eylemlerinde seçim için kullanılabilir. |
Harici ID bir OneSignal kullanıcısıyla eşleşmezse ne olur?
Bildirim Gönder ve Etiketleri Düzenle eylemleri sessizce başarısız olur — mesaj gönderilmez ve etiket ayarlanmaz. Kullanıcının OneSignal’da mevcut olduğundan emin olmak için workflow’unuzdaki diğer OneSignal eylemlerinden önce her zaman bir Kullanıcı Oluştur eylemi ekleyin.OneSignal segmentlerini hedeflemek için HubSpot listelerini kullanabilir miyim?
Doğrudan değil. HubSpot listeleri ve OneSignal segmentleri bağımsız sistemlerdir. Bunları bağlamak için bir HubSpot listesinden kişileri kaydeden ve etiketi ayarlamak için Etiketleri Düzenle eylemini kullanan bir workflow oluşturun. Ardından bu etikete dayalı bir OneSignal segmenti oluşturun. Çalışan bir örnek için Uygulama içi mesaj aracılığıyla tanıtım kampanyası bölümüne bakın.HubSpot’tan hangi OneSignal kanallarına gönderim yapabilirim?
Anlık bildirimler şablonlar veya form alanları kullanılarak gönderilebilir. E-posta ve SMS yalnızca OneSignal’da oluşturulan Şablonlar kullanılarak gönderilebilir. Uygulama içi mesajlar HubSpot workflow’larından gönderilemez — bunun yerine etiket ve segment kalıbını kullanın.Etiket ayarlandıktan sonra uygulama içi mesajım neden görüntülenmedi?
Etiketler tek başına uygulama içi mesajları tetiklemez. Etiket kullanıcıyı bir segmente ekler, ancak uygulama içi mesajın görüntülenmesi için yine de bir tetikleyici gerekir. Etiket kullanıcı uygulamayı aktif olarak kullanırken ayarlanırsa mesaj bir sonraki oturuma (30+ saniye arka planda) kadar görünmez. En güvenilir davranış için uygulama içi mesaj tetikleyicisini Uygulama açılışında olarak ayarlayın. Tüm tetikleyici seçenekleri için Uygulama İçi Mesaj Tetikleyicileri bölümüne bakın.OneSignal API’sini doğrudan çağırmak için HubSpot webhook’larını kullanabilir miyim?
Evet. HubSpot’un Özel Kod workflow eylemi, harici API’lere HTTP istekleri yapmanızı sağlar. Yerel entegrasyon dışında mesaj göndermek, kullanıcı oluşturmak veya etiket güncellemek için OneSignal REST API’sini çağırabilirsiniz. Bu, yerel eylemlerin kapsamadığı kullanım senaryoları (ör. bireysel kullanıcı yerine segmente gönderme) için kullanışlıdır.OneSignal mesaj olaylarını HubSpot’a geri gönderebilir miyim?
Evet. OneSignal mesaj olaylarını (gönderilen, tıklanan vb.) bir webhook uç noktasına dışa aktarmak için Olay Akışlarını kullanın. Bu olayları HubSpot’un Özel Etkinlikler API’sine yönlendirebilir veya OneSignal etkileşim verilerine göre HubSpot kişi özelliklerini güncellemek için bir ara yazılım hizmeti kullanabilirsiniz.HubSpot’tan bir OneSignal Journey’i tetikleyebilir miyim?
HubSpot kullanıcılarını bir OneSignal Journey’e dahil etmek için iki seçenek vardır:- Etiketler — Kullanıcıya etiket ayarlamak için Etiketleri Düzenle eylemini kullanın. O etikete göre OneSignal’da bir segment oluşturun ve segmenti Journey giriş koşulu olarak kullanın.
- Özel Etkinlikler — Journey giriş tetikleyicisi olarak kullanılabilecek OneSignal Özel Etkinlikler API’sini çağırmak için HubSpot’un Özel Kod eylemini kullanın.
HubSpot’tan OneSignal’a özel etkinlikler gönderebilir miyim?
Yerel workflow eylemleri aracılığıyla değil. Yerel entegrasyon Kullanıcı Oluştur, Etiketleri Düzenle ve Bildirim Gönder’i destekler. Özel etkinlikler göndermek için doğrudan OneSignal Özel Etkinlikler API’sini çağırmak üzere HubSpot’un Özel Kod eylemini kullanın.Hangi HubSpot kayıt tetikleyicileri OneSignal ile çalışır?
Herhangi bir HubSpot kayıt tetikleyicisi çalışır — OneSignal eylemleri, kişinin nasıl kaydedildiğinden bağımsız olarak çalışan standart workflow eylemleridir. Yaygın tetikleyiciler şunlardır:- Kişi özelliği değişiklikleri (yaşam döngüsü aşaması, potansiyel müşteri durumu, son etkinlik tarihi)
- Form gönderimleri (kayıt formları, demo istekleri, etkinlik kayıtları)
- Liste üyeliği (statik veya aktif listeye eklendi)
- Anlaşma aşaması değişiklikleri (boru hattı ilerlemesi, kapalı kazanıldı/kaybedildi)
- Tarih tabanlı (zamanlanmış kampanyalar, bir olaydan bu yana geçen süre)
- Manuel kayıt (tek seferlik göndermeler veya test için)
Canlıya geçmeden önce bir workflow’u nasıl test ederim?
- Workflow’u oluşturun ve tüm otomatik kayıt tetikleyicilerini kaldırın
- Workflow’u kaydedin ve yayımlayın
- Tek bir test kişisini manuel olarak kaydedin
- HubSpot’taki kayıt geçmişinde eylem başarısını/başarısızlığını kontrol edin
- OneSignal kontrol panelinde kullanıcıyı, etiketleri veya mesajı doğrulayın
- Onaylandıktan sonra kayıt tetikleyicilerinizi ekleyin ve yeniden yayımlayın
Etiketler
Kişiselleştirme ve segmentasyon için kullanıcılara özel özellikler ekleyin.
Şablonlar
Push, e-posta ve SMS için yeniden kullanılabilir mesaj şablonları oluşturun.
Journey'ler
Kullanıcı davranışı tarafından tetiklenen otomatik çok kanallı mesajlaşma akışları oluşturun.
Olay Akışları
Webhook’lar aracılığıyla gerçek zamanlı mesaj olaylarını harici platformlara dışa aktarın.
Segmentasyon
Etiketlere, davranışa ve kullanıcı özelliklerine göre kitle segmentleri oluşturun.
Uygulama İçi Mesaj Tetikleyicileri
Uygulama içi mesajların kullanıcılara ne zaman ve nasıl görüntüleneceğini kontrol edin.