Web kancaları, Smartsupp'ın seçtiğiniz herhangi bir URL'ye gerçek zamanlı bildirimler göndermesini sağlar — bir görüşme açıldığı, bir kişi oluşturulduğu veya bir mesaj iletildiği anda sisteminiz bundan haberdar olur. Bu makalede web kancalarının ne olduğu, kontrol panelinizde nasıl kurulacağı ve Make ile n8n gibi otomasyon platformlarına nasıl bağlanacağı açıklanmaktadır.
Makaleyi birkaç bölüme ayırdık:
Web kancaları ne işe yarar?
Web kancası, seçilen bir olay her gerçekleştiğinde Smartsupp'ın seçtiğiniz bir URL'ye gönderdiği otomatik bir HTTP mesajıdır. Araçlarınız değişiklikleri düzenli olarak sorgulamak yerine, bir olay gerçekleştiği anda verileri alır.
Tipik kullanım örnekleri şunlardır:
Otomasyon platformları — CRM'e kişiler eklemek, Slack'te bildirimler yayınlamak veya potansiyel müşterileri bir elektronik tabloya kaydetmek için Make, n8n veya benzer araçlarda iş akışları tetikleyin
Dahili sistemler — görüşme ve kişi verilerini kontrol panellerine, veri ambarlarına veya destek talebi sistemlerine gerçek zamanlı olarak aktarın
Bildirimler — görüşmeler değerlendirildiğinde veya mesaj iletimi başarısız olduğunda takımınızı bilgilendirin
İpucu: Web kancaları şu planlarda kullanılabilir: Plus ve üzeri planlar — Plus 1 web kancası, Expert 3 web kancası içerir ve Ultimate özel bir limit sunar. Planları karşılaştırın →
Bir web kancası oluşturun
Smartsupp kontrol panelinizde bir web kancası kurmak yalnızca birkaç adım gerektirir:
1. Ayarlar Bölümünü açın ve Web kancaları Bölümüne gidin.
2. Yeni bir web kancası eklemek için tıklayın ve Uç nokta URL'nizi Girin — bu, Smartsupp'ın olay verilerini göndereceği adrestir.
3. Almak istediğiniz Olayları Seçin (tam listeyi bir sonraki bölümde görebilirsiniz).
4. Web kancasını kaydedin. Bu andan itibaren seçilen olaylar, JSON veri yükleri içeren HTTP POST istekleri olarak iletilir.
Not: Daha önce yapılandırılan web kancaları normal şekilde çalışmaya devam eder. Mevcut tüm web kancalarının yeni kontrol paneli bölümünde görünür ve yönetilebilir olması için çalışmalar sürmektedir.
⚠️ Daha önce web kancaları oluşturdunuz mu? Eski web kancaları henüz bu bölümde görünmüyor — eskisi gibi çalışmaya devam ediyorlar. Her şeyin tek bir yerden yönetilebilmesi için eski ve yeni sistemi birleştiriyoruz.
Kullanılabilir olaylar
Smartsupp, üç kategorideki olaylar hakkında uç noktanıza bildirim gönderebilir. Yalnızca iş akışınızın gerçekten ihtiyaç duyduğu olayları seçin — bu, uç noktanızın yükünü hafifletir ve gereksiz trafiği önler.
Kişiler
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Görüşmeler
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Ziyaretçiler
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
İlgili kaynaklar: Smartsupp geliştirici belgeleri — her olay türü için eksiksiz JSON veri yükü şemaları.
Web kancanızı test edin
Canlı kullanıma geçmeden önce, uç noktanızın erişilebilir olduğunu ve Make veya n8n senaryonuzun doğru kurulduğunu doğrulamak için yerleşik test özelliğini kullanın.
Kontrol panelindeki web kancası ayarlarınızda Test gönderSeçeneğine tıklayın. Smartsupp, uç nokta URL'nize örnek bir veri yükü gönderecektir. Verilerin beklenen biçimde ulaştığını doğrulamak için alıcı hizmetinizi kontrol edin.
İpucu: Make'te, testi göndermeden önce senaryonuz etkin ve dinleme durumunda olmalıdır. n8n'de Webhook düğümünü üretim URL'sine geçirin ve iş akışının etkin olduğundan emin olun.
İletim, yeniden denemeler ve güvenlik
Smartsupp, uç noktanız geçici olarak kullanılamadığında bile web kancası olaylarını güvenilir şekilde iletmek üzere tasarlanmıştır.
Biçim — tüm olaylar, olayı ve verilerini açıklayan bir JSON gövdesi içeren HTTP POST istekleri olarak gönderilir
Yanıt — uç noktanız mümkün olduğunca hızlı bir şekilde 2xx HTTP durum koduyla yanıt vermelidir; yavaş yanıtlar yeniden denemeleri geciktirebilir
Yeniden denemeler — iletim başarısız olursa Smartsupp, giderek artan bekleme süreleriyle 3 güne kadar yeniden dener
Otomatik devre dışı bırakma — sürekli başarısız olan uç noktalar otomatik olarak devre dışı bırakılır; bunları kontrol panelinde istediğiniz zaman yeniden etkinleştirebilirsiniz
Güvenlik — her web kancası isteği, gerçekten Smartsupp'tan geldiğini doğrulayabilmeniz için imzalanır; imza doğrulama ayrıntıları için docs.smartsupp.com Adresine bakın
Not: Uç noktanız tekrarlanan hatalar nedeniyle devre dışı bırakıldıysa, sorunun temel nedenini giderdikten sonra Ayarlar → Web kancaları Bölümünde yeniden etkinleştirin. Smartsupp, olayları göndermeye hemen devam edecektir.
Smartsupp'ı Make veya n8n'e bağlayın
Smartsupp'ı bir otomasyon platformuna bağlama işlemi dört adımdan oluşur. İşlem Make ve n8n için aynıdır — yalnızca tetikleyici düğümü farklıdır.
1. MakePlatformunda Web kancaları → Özel web kancası Tetikleyicisini ekleyin ve oluşturulan URL'yi kopyalayın. n8nPlatformunda Web kancası Tetikleyici düğümünü ekleyin ve üretim URL'sini kopyalayın.
2. Smartsupp'ta Ayarlar → Web kancalarıBölümüne gidin, yeni bir web kancası oluşturun ve kopyaladığınız URL'yi yapıştırın.
3. İhtiyacınız olan olayları seçin ve web kancasını kaydedin.
4. Test gönder Seçeneğine tıklayarak Make veya n8n'in veri yapısını yakalamasını sağlayın — ardından senaryonuzun veya iş akışınızın geri kalanını bu yapı üzerine kurun.
İpucu: Make'te testi göndermeden önce senaryonuzu etkinleştirin — aksi takdirde web kancası verileri yakalanmaz. n8n'de Smartsupp web kancasını kurarken Üretim URL'sini kullanın (test URL'sini değil).
Sırada ne var?
Smartsupp REST API — Smartsupp verilerini programatik olarak okumak ve yazmak için API'nin tamamını keşfedin.
Otomasyonlar — harici bir araç olmadan doğrudan Smartsupp içinde tetiklenen kural tabanlı otomasyonlar kurun.
Entegrasyonlara genel bakış — CRM'ler, e-ticaret platformları ve daha fazlasıyla kullanılabilen tüm yerleşik entegrasyonları görüntüleyin.
💡 Daha fazla yardıma mı ihtiyacınız var? Bizim Destek takımımızla İletişime geçin — size yardımcı olmaktan memnuniyet duyarız!