Papo (https://papo.global/) webhook bağlantısını otomasyonu etkinleştirmeden önce test etmek için Webhook.site gibi harici bir araç kullanarak hedef URL'yi doğrulayabilir, JSON payload biçimini kontrol edebilir ve gerçek kişileri etkilemeden gönderim hatalarını düzeltebilirsiniz. Bu süreç hem hesap webhook'ları hem de Otomasyon Flow'larındaki “Webhook Gönder” eylemi için çalışır.
Erken doğrulama, bozuk bir entegrasyonun veri kaybetmesini veya müşteri yolculuklarını kesintiye uğratmasını önler. Geçici bir test URL'si ile Papo'nun tam olarak ne gönderdiğini — başlıklar, gövde ve yanıt kodları — inceleyebilir ve nihai sisteme yönlendirmeden önce ayarlamalar yapabilirsiniz.
Test sürecinin özeti
| Aşama | Eylem | Araç / yer |
|---|---|---|
| 1. Test URL'si alın | Webhook.site'a gidin ve oluşturulan URL'yi kopyalayın. | Webhook.site |
| 2. Papo'da webhook'u test URL'si ile yapılandırın | URL'yi webhook hedef alanına (Entegrasyonlar bölümüne veya Flow eylemine) girin. | Papo paneli |
| 3. Webhook'u tetikleyin | Hesap webhook'ları için bağlı gelen kutusuna bir WhatsApp mesajı gönderin. Flow'lardaki webhook'lar için akışa bir test kişisi kaydedin. | Gelen kutusu veya Flow |
| 4. Alınan payload'ı inceleyin | Webhook.site panelinde gelen isteği görün: yöntem, başlıklar ve gövde JSON'u. | Webhook.site |
| 5. Düzeltin ve üretim URL'si ile değiştirin | Payload doğruysa test URL'sini sisteminizin gerçek URL'si ile değiştirin ve otomasyonu etkinleştirin. | Papo paneli |
Hesap webhook'ları nasıl test edilir (Entegrasyonlar)
Papo'nun yerel webhook'ları, bir gelen kutusunda alınan her yeni mesajda tetiklenir. Bunları risksiz doğrulamak için:
- Papo panelinde Ayarlar > Entegrasyonlar > Webhook'lar bölümüne gidin ve yeni bir webhook oluşturun.
- Tetikleyiciyi tanımlayın — örneğin, Tüm mesajlar — ve URL alanına Webhook.site'ın geçici adresini yapıştırın.
- Webhook'u kaydedin.
- İzlenen gelen kutusuna bir test mesajı gönderin (WhatsApp veya bağlı başka bir kanal üzerinden).
- Webhook.site'da paneli yenileyin ve yeni gelen isteği bulun. JSON gövdesini kontrol edin: gönderen numarası, mesaj içeriği ve konuşma kimliği gibi verileri içermelidir.
- JSON boş veya hatalı biçimdeyse seçilen tetikleyiciyi gözden geçirin ve mesajın gerçekten gelen kutusu tarafından alındığını doğrulayın.
- Doğruladıktan sonra webhook'u düzenleyin ve URL'yi hedef sisteminizin URL'si ile değiştirin.
Otomasyon Flow'larında “Webhook Gönder” eylemi nasıl test edilir
Flow düzenleyicisinde Webhook Gönder eylemi, yolculuğun belirli bir adımında veri tetiklemenizi sağlar. Test, geçici olarak etkinleştirilmiş bir akış ve bir kontrol kişisi ile yapılır:
- Flow'u oluşturun ve Webhook Gönder düğümünü istediğiniz noktaya ekleyin.
- Düğüm yapılandırma panelinde URL alanına Webhook.site adresini girin, POST yöntemini seçin ve Papo değişkenlerini kullanarak JSON gövdesini oluşturun:
{{contact.name}}ve{{contact.phone}}gibi. - Flow'u etkinleştirin.
- CRM'de bu akışa manuel olarak bir test kişisi kaydedin (otomasyon Flow'larını test etme prosedürünü izleyerek).
- Flow yürütme geçmişini izleyin ve aynı zamanda Webhook.site'ı gözlemleyin.
- Alınan istek, değişkenlerin yerine test kişisinin gerçek değerlerini içeren JSON'u göstermelidir. Aksi halde gövdeyi kontrol edin (
"nome": "{{contact.name}}"kullanın ve kişinin alanlarının dolu olduğundan emin olun). - İstek 4xx veya 5xx hatası döndürürse yöntemin doğru olup olmadığını (genellikle POST) ve
Content-Type: application/jsonbaşlığının eklenip eklenmediğini kontrol edin. - Doğrulamadan sonra Flow'u devre dışı bırakın, hedef URL'yi üretim URL'si ile değiştirin ve yeniden etkinleştirin.
Bu süreç kimler için uygundur
- Entegrasyonları yayına almadan önce bütünlüklerini garanti etmesi gereken yöneticiler ve sistem analistleri.
- CRM'lere, elektronik tablolara veya otomasyon araçlarına webhook gönderen Flow'lar kuran ve gerçek adayları etkilemeden payload'ı hata ayıklamak isteyen ekipler.
- Hesap webhook'larını özelleştiren ve olayların doğru şekilde gönderildiğini onaylamak isteyen her kullanıcı.
Sık sorulan sorular
Webhook'u gerçek bir mesaj göndermeden test edebilir miyim?
Hesap webhook'ları için mümkün değildir, çünkü bunlar gelen mesajlarla tetiklenir. Olayı oluşturmak için bir test WhatsApp numarası (kendinizin veya bir iş arkadaşınızın) kullanın. Flow'lar için ise bir kontrol kişisinin manuel kaydı, adayın gerçek bir müşteri olmadan test yapılmasına olanak tanır.
Webhook.site ücretsiz mi? Üretimde kullanmalı mıyım?
Evet, Webhook.site geçici genel URL'ler oluşturur ve trafiği gerçek zamanlı gösterir; hata ayıklama için idealdir. Bu URL'leri asla üretimde kullanmayın — testten sonra hedef sisteminizin URL'si ile değiştirin.
Webhook tetiklendi ama payload boş. Neyi kontrol etmeliyim?
Hesap webhook'ları için tetikleyiciyi (doğru mesaj türünü yakalayıp yakalamadığını) ve gelen kutusu izinlerini kontrol edin. Flow eylemi için gövdedeki değişkenleri gözden geçirin — {{contact.name}} gibi alanlar yalnızca kişide ad alanı kayıtlıysa doldurulur. Verileri eksiksiz bir kişiyle test edin.
401 (yetkisiz) veya 403 (yasak) hataları nasıl düzeltilir?
Bu hatalar hedef sistemin isteği reddettiğini gösterir. Harici aracın belgelerinin önerdiği şekilde webhook yapılandırmasının Headers alanına bir kimlik doğrulama başlığı ekleyin (örneğin, Authorization: Bearer sizin-token).
Kanban webhook'larını da aynı şekilde test edebilir miyim?
Evet. Kanban modülünde yapılandırılan webhook'lar Webhook.site'ın geçici URL'si ile test edilebilir — bir kartı bir sütundan diğerine taşımanız (olayı tetikleyen eylem) ve test panelinde payload'ı incelemeniz yeterlidir.
Webhook'u test etmek için Flow'un etkin kalması gerekiyor mu?
Evet. Yalnızca Etkin durumdaki Flow'lar webhook düğümünü işler. Akışı etkinleştirin, testi yapın ve gerekirse hemen ardından devre dışı bırakın.
Ayrıca okuyun
- Otomasyon Flow'unu etkinleştirmeden önce nasıl test edersiniz
- Webhook ile yeni kişilerin verilerini Google Sheets'e nasıl gönderirsiniz
İlk kullanıcı ücretsiz olduğu için webhook'lar oluşturabilir ve entegrasyonları taahhüt olmadan test edebilirsiniz.