#Webhooks

#Nedir

Bir webhook, Wapix'in bir şey olduğunda başka bir araca otomatik olarak gönderdiği bir mesajdır. Örneğin: "bir müşteri bir potansiyel müşteri formunu tamamladı" veya "bir anlaşma kazanıldı".

Wapix'e bir uç nokta olarak adlandırılan bir web adresi verirsiniz ve hangi olayları duyması gerektiğini seçersiniz.

Bu, Webhooks bölümünden erişilen bir Yönetici alanıdır ve Webhooks'u içeren bir plana ihtiyaç duyar.

#Çözdüğü sorun

Wapix, bir işletmenin kullandığı tek araç nadiren olur. Bir CRM, bir elektronik tablo, Slack gibi bir ekip sohbeti veya Zapier, Make veya n8n gibi bir otomasyon aracı kullanıyor olabilirsiniz.

Webhooks olmadan, bir kişi bilgileri elle kopyalamak zorundadır: Wapix'deki potansiyel müşteriyi okumak, CRM'ye yazmak, sohbet içinde ekibe bildirmek. Bu yavaş ve bazı şeyler gözden kaçabilir.

Webhooks ile Wapix, bu araçlara kendisi hemen haber verir:

• bir potansiyel müşteri formu tamamlanır ve elektronik tablonuza bir satır eklenir;
• bir konuşma bir kişiye devredilir ve ekip sohbetiniz bilgilendirilir;
• bir anlaşma kazanılır ve CRM'iniz güncellenir.

#Nasıl çalışır

Bir webhook'u, Wapix'in size verdiğiniz bir adreste kapı zili çalması ve bir not bırakması olarak düşünün.

1. Wapix'de bir şey olur, örneğin bir anlaşma kazanılır.
2. Wapix, o olayı duymak için hangi uç noktaların talep ettiğini kontrol eder.
3. Her birine, JSON adı verilen standart bir formatta detaylarla birlikte küçük bir mesaj gönderir.
4. Diğer araç bunu alır ve sizin ayarladığınız şekilde işlem yapar.

Webhooks mu yoksa API mi? Bir webhook, Wapix'in başka bir araca bir şeyin olduğunu bildirmesidir. API ise başka bir aracın Wapix'den bir şey yapmasını veya göstermesini istemesidir. Birçok kurulum her ikisini de kullanır.

Zapier, Make veya n8n gibi bir araçla webhook'ları kullanmak için programcı olmanıza gerek yoktur. Size yapıştırmanız için bir adres verirler. Kendi alıcınızı oluşturuyorsanız, bir geliştirici Entegrasyonlar & API sayfasını tam formatlar için okumalıdır.

#1. Bir uç nokta ekleme

1. Webhooks bölümüne gidin ve Uç nokta ekle'ye tıklayın.
2. Mesajları alması gereken URL'yi yapıştırın. Bu, diğer aracınız tarafından sağlanır.
3. Bu uç noktanın alması gereken olayları işaretleyin. Her biri ne zaman gönderildiğini belirtir. Uç nokta yalnızca bunları alır.
4. Kaydet.

Wapix, aşağıdakileri gösteren uç noktanın sayfasını açar:

• imza sırrı, bu yalnızca bir kez;
• Gönderdiğimiz şey: Wapix'in yaptığı istek ve işaretlediğiniz her olay için bir örnek mesaj;
• Test gönder, şimdi uç noktanıza bu örneklerden birini göndermek için;
• teslimat kaydı.

#Test gönderme

Zapier, Make ve n8n gibi araçlar, alanlarını eşleştirmeden önce bir mesaja ihtiyaç duyar. Gerçek bir olayı beklemek yerine, uç noktayı açın, Gönderdiğimiz şey altında bir olayı seçin ve Test gönder'e basın. Wapix, gösterilen örneği, gerçek bir mesaj gibi imzalanmış olarak, alıcınızın ayırt edebilmesi için "test": true ekleyerek gönderir. Sonuç hemen görünür ve teslimat kaydında yer alır. Bir test bir kez gönderilir ve asla yeniden denenmez.

#2. Olaylar

Olay	Gönderildiğinde…
message.received	Bir müşteri herhangi bir kanalda bir mesaj gönderdiğinde.
contact.created	Yeni bir iletişim bilgisi göründüğünde: biri ilk kez yazdığında veya bir iletişim bilgisi elle veya API aracılığıyla eklendiğinde. İthalatlar bunu göndermez.
conversation.escalated	Bir konuşma AI'den bir kişiye devredildiğinde. Sebep dahildir.
conversation.closed	Bir konuşma kapandığında.
answer.fallback	AI, yeterli bilgiye sahip olmadığını yanıtladığında. Bilgi bankanızdaki boşlukları tespit etmek için yararlıdır.
lead_form.submitted	Birisi bir potansiyel müşteri formunu tamamladığında. Cevaplar dahildir.
deal.created	Bir anlaşma oluşturulduğunda.
deal.stage_changed	Bir anlaşma başka bir aşamaya geçtiğinde. Eski ve yeni aşama dahildir.
deal.won	Bir anlaşma kazanıldığında.
deal.lost	Bir anlaşma kaybedildiğinde. Sebep dahildir.
booking.created	Bir randevu oluşturulduğunda.
booking.cancelled	Bir randevu iptal edildiğinde. Sebep dahildir.
booking.completed	Bir randevu tamamlandı olarak işaretlendiğinde.

Her mesajın tam içeriği Entegrasyonlar & API sayfasında listelenmiştir.

#3. Mesajın gerçekten Wapix'den geldiğini kontrol etme

#Nedir

Her webhook bir imza taşır: yalnızca Wapix ve sizin üretebileceğiniz bir kod, çünkü bu sizin imza sırrınızla oluşturulmuştur.

#Çözdüğü sorun

Bir uç nokta, kamuya açık bir web adresidir. Bunu bulan herkes, sahte mesajlar gönderebilir, örneğin yanlış bir "anlaşma kazanıldı" mesajı. İmza, alıcınızın gerçek mesajları sahte olanlardan ayırt etmesine olanak tanır.

#Nasıl çalışır

Wapix, her mesaja X-Threadline-Signature-256 adında bir başlık ekler. Değeri sha256= ile başlayan bir koddur. O kod, mesaj gövdesinin HMAC-SHA256'ıdır ve sizin imza sırrınızla yapılmıştır.

Alıcınız, aynı sır ile aynı hesaplamayı yapar. Eğer sonucu başlıkla eşleşirse, mesaj gerçektir. Aksi takdirde, reddedilmelidir.

Birçok kodsuz araç bu adımı atlar, bu düşük riskli kullanımlar için kabul edilebilir. Eğer webhook önemli bir şeyi tetikliyorsa, bir geliştiricinin kontrolü eklemesini sağlayın. Örnek kod Entegrasyonlar & API sayfasında bulunmaktadır.

#4. Yeniden denemeler

Bazen diğer araç kısa bir süreliğine kapalıdır. Eğer bir teslimat başarısız olursa, bir hata yanıtı, zaman aşımı veya bağlantı yokluğu nedeniyle, Wapix otomatik olarak yeniden dener ve her seferinde biraz daha uzun bekler.

Birçok başarısız denemeden sonra, teslimat başarısız olarak işaretlenir ve Wapix durur. Sonsuza kadar yeniden denemez.

#5. Teslimat kaydı

Son teslimatları görmek için bir uç noktayı açın. Her deneme listelenir, aşağıdakilerle birlikte:

• olay;
• başarılı mı yoksa başarısız mı olduğu;
• diğer araçtan gelen yanıt kodu;
• bir başarısızlık durumunda, hata veya yanıtın başlangıcı.

Bir şeyin ulaşmadığı durumlarda bakılacak ilk yer burasıdır. Genellikle sunucu günlüklerine ihtiyaç duymadan nedeni gösterir.

#Bilinmesi gerekenler

• Bir uç nokta, internetten erişilebilir olmalıdır. Sadece ofis ağınız içinde çalışan bir adres hiçbir şey almaz.
• Bir uç noktanın silinmesi, ona yapılan teslimatları hemen durdurur.
• Webhooks arka planda gönderilir, bu nedenle asla bir müşteriye yanıtı yavaşlatmaz.

#Sıkça Sorulan Sorular

Uç noktama hiçbir şey ulaşmıyor. Teslimat kaydını kontrol edin. Eğer her deneme bir bağlantı hatası gösteriyorsa, sunucunuz veya güvenlik duvarınız Wapix'den gelen istekleri engelliyor demektir. Sorun Giderme sayfasına bakın.

İmza sırrını kaybettim. Bu tekrar gösterilemez. Uç noktayı açın ve Yeni bir sır oluştur'a basın: yeni olan bir kez gösterilir ve uç nokta olaylarını ve teslimat kaydını korur. Mesajlar hemen yeni sır ile imzalanır, bu nedenle onu alıcınıza verin.

Sadece bazı olayları alabilir miyim? Evet. Her uç nokta yalnızca işaretlediğiniz olayları alır.

Bir otomasyondan webhook gönderilebilir mi? Evet. Bir otomasyon içindeki Bir webhook çağır adımı, bir iletişimin detaylarını seçtiğiniz anda bir adrese gönderir.