Webhook'lar, Smartsupp'ın seçtiğiniz herhangi bir URL'ye gerçek zamanlı bildirimler göndermesini sağlar — bir konuşma açıldığı, bir kişi oluşturulduğu veya bir mesaj iletildiği anda sisteminiz bunu öğrenir. Bu makale webhook'ların ne olduğunu, kontrol panelinde nasıl ayarlanacağını ve Make ile n8n gibi otomasyon platformlarına nasıl bağlanacağını açıklar.

Makaleyi birkaç bölüme ayırdık:

Webhook'lar ne işe yarar?

Webhook, seçilen bir olay gerçekleştiğinde Smartsupp'ın seçtiğiniz URL'ye gönderdiği otomatik bir HTTP mesajıdır. Değişiklikleri sürekli sorgulamak yerine, araçlarınız bir şey olduğu anda verileri alır.

Tipik kullanım örnekleri:

Otomasyon platformları — Make, n8n veya benzeri araçlarda iş akışlarını tetikleyin: CRM'e kişi ekleme, Slack'e bildirim gönderme, lead'leri tabloya kaydetme
Dahili sistemler — konuşma ve kişi verilerini gerçek zamanlı olarak panolara, veri ambarlarına veya destek sistemlerine aktarın
Bildirimler — bir konuşma değerlendirildiğinde veya mesaj teslimatı başarısız olduğunda ekibinizi uyarın

İpucu: Webhook'lar Plus planı ve üzerinde kullanılabilir — Plus 1 webhook, Expert 3 içerir; Ultimate özel bir limit sunar. Planları karşılaştırın →

Webhook oluşturma

Smartsupp kontrol panelinde webhook ayarlamak yalnızca birkaç adım sürer:

1. Settings bölümünü açın ve Webhooks kısmına gidin.
2. Yeni webhook eklemek için tıklayın ve endpoint URL'nizi girin — Smartsupp'ın olay verilerini göndereceği adres.
3. Almak istediğiniz olayları seçin (tam liste bir sonraki bölümde).
4. Webhook'u kaydedin. Bu andan itibaren seçilen olaylar JSON içerikli HTTP POST istekleri olarak iletilir.

Not: Daha önce yapılandırılan webhook'lar normal şekilde çalışmaya devam eder. Mevcut tüm webhook'ların yeni panel bölümünden görünür ve yönetilebilir olması için çalışıyoruz.

Kullanılabilir olaylar

Smartsupp, endpoint'inizi üç kategorideki olaylar hakkında bilgilendirebilir. Yalnızca iş akışınızın gerçekten ihtiyaç duyduğu olayları seçin — böylece endpoint hafif kalır ve gereksiz trafikten kaçınırsınız.

Kişiler

contact.created
contact.updated
contact.acquired
contact.banned
contact.unbanned

Konuşmalar

conversation.opened
conversation.closed
conversation.closed_by_contact
conversation.rated
conversation.agent_assigned
conversation.agent_unassigned
conversation.agent_joined
conversation.agent_left
conversation.agent_replied
conversation.bot_replied
conversation.contact_replied
conversation.message_delivered
conversation.message_delivery_failed

Ziyaretçiler

visitor.connected
visitor.disconnected
visitor.updated
visitor.typing
visitor.triggered
visitor.replied

İlgili kaynaklar: Smartsupp geliştirici dokümantasyonu — her olay türü için eksiksiz JSON payload şemaları.

Webhook'unuzu test edin

Canlıya geçmeden önce, endpoint'inizin erişilebilir olduğunu ve Make veya n8n senaryonuzun doğru ayarlandığını doğrulamak için yerleşik test özelliğini kullanın.

Paneldeki webhook ayarlarından Send test düğmesine tıklayın. Smartsupp, endpoint URL'nize örnek bir payload gönderir. Verilerin beklenen formatta geldiğini alıcı serviste kontrol edin.

İpucu: Make'te testi göndermeden önce senaryonuz aktif ve dinliyor olmalıdır. n8n'de Webhook düğümünü production URL'ye geçirin ve iş akışının aktif olduğundan emin olun.

Teslimat, yeniden denemeler ve güvenlik

Smartsupp, endpoint'iniz geçici olarak kullanılamadığında bile webhook olaylarını güvenilir şekilde iletecek şekilde tasarlanmıştır.

Format — tüm olaylar, olayı ve verilerini tanımlayan JSON gövdeli HTTP POST istekleri olarak gönderilir
Yanıt — endpoint'iniz mümkün olan en kısa sürede 2xx HTTP durum koduyla yanıt vermelidir; yavaş yanıtlar yeniden denemeleri geciktirebilir
Yeniden denemeler — teslimat başarısız olursa Smartsupp, 3 güne kadar artan aralıklarla yeniden dener
Otomatik devre dışı bırakma — sürekli başarısız olan endpoint'ler otomatik olarak devre dışı bırakılır; bunları panelden istediğiniz zaman yeniden etkinleştirebilirsiniz
Güvenlik — her webhook isteği imzalanır, böylece gerçekten Smartsupp'tan geldiğini doğrulayabilirsiniz; imza doğrulama ayrıntıları için docs.smartsupp.com adresine bakın

Not: Endpoint'iniz tekrarlanan hatalar nedeniyle devre dışı bırakılırsa, sorunu giderdikten sonra Settings → Webhooks bölümünden yeniden etkinleştirin. Smartsupp olay göndermeye hemen devam eder.

Smartsupp'ı Make veya n8n'e bağlayın

Smartsupp'ı bir otomasyon platformuna bağlamak dört adım sürer. Süreç Make ve n8n için aynıdır — yalnızca tetikleyici düğüm farklıdır.

1. Make'te bir Webhooks → Custom webhook tetikleyicisi ekleyin ve oluşturulan URL'yi kopyalayın. n8n'de bir Webhook tetikleyici düğümü ekleyin ve production URL'sini kopyalayın.
2. Smartsupp'ta Settings → Webhooks bölümüne gidin, yeni bir webhook oluşturun ve kopyalanan URL'yi yapıştırın.
3. İhtiyacınız olan olayları seçin ve webhook'u kaydedin.
4. Make veya n8n'in veri yapısını yakalaması için Send test düğmesine tıklayın — ardından senaryonuzun geri kalanını bunun üzerine kurun.

İpucu: Make'te testi göndermeden önce senaryonuzu etkinleştirin — aksi halde webhook verileri yakalanmaz. n8n'de Smartsupp webhook'unu ayarlarken production URL'yi (test URL'sini değil) kullanın.

Sırada ne var?

Smartsupp REST API — Smartsupp verilerini programatik olarak okumak ve yazmak için tüm API'yi 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 mevcut tüm yerleşik entegrasyonları görün.

💡 Daha fazla yardıma mı ihtiyacınız var? Bizimle iletişime geçin: destek ekibimiz — yardımcı olmaktan memnuniyet duyarız!

Webhook'lar — Smartsupp'ı Make, n8n ve kendi araçlarınıza bağlayın