Flowella ayarlarında giden webhook'ları ekleyin ve yönetin

Giden bir webhook, seçilen bir olay her gerçekleştiğinde Flowella’nın kendi sisteminize bir HTTP POST göndermesini sağlar, örneğin bir kişi WhatsApp mesajı gönderdiğinde. Bu sayfa, uygulamada webhook uç noktalarını nasıl ekleyeceğinizi, test edeceğinizi ve yöneteceğinizi gösterir. Olay türleri, istek gövdeleri, başlıklar ve imzaların nasıl doğrulanacağı için webhook başvurusu sayfasına bakın.

​

Başlamadan önce

• Owner veya Admin rolüne sahip olmanız gerekir. Diğer roller menüde Webhooks öğesini görebilir, ancak liste onlar için yüklenmez. Bkz. Ekip ve roller.
• JSON gövdeli POST isteklerini kabul eden ve 10 saniye içinde 2xx durum koduyla yanıt veren herkese açık bir URL’ye ihtiyacınız vardır.
• En az 8 karakterlik bir imzalama anahtarı seçin ve işleyicinizin okuyabileceği bir yerde saklayın. Flowella her isteği imzalamak için bunu kullanır ve kaydettikten sonra bir daha asla göstermez.

​

Webhook uç noktası ekleme

​

URL kuralları

Flowella, URL’yi kaydettiğinizde ve her teslimattan önce yeniden kontrol eder. URL:

• https:// veya http:// ile başlamalıdır. Düz http:// çalışır, ancak bu durumda yük şifrelenmeden iletilir. Bu nedenle hızlı testler dışında https:// kullanın.
• Kullanıcı adı veya parola içermemelidir.
• Herkese açık bir adresi göstermelidir. Flowella localhost adresini, .localhost veya .local ile biten ana bilgisayar adlarını ve metadata.google.internal adresini reddeder. Çözümlenmeyen ana bilgisayar adlarını da reddeder. Özel, geri döngü, bağlantı yerel ve belirtilmemiş adresler de doğrudan girilse de bir ana bilgisayar adı bunlara yönlendirse de reddedilir. Örnekler: 10.0.0.5, 127.0.0.1, 169.254.169.254, 192.168.1.10 ve ::1.
• 2.048 karakterden uzun olmamalıdır.

Bu kuralları ihlal eden bir URL Webhook URL host is not allowed hatasını gösterir.

​

Test olayı gönderme

Gerçek olaylar gelmeden önce uç noktanızın istekleri aldığını ve kabul ettiğini kontrol etmek için bir test olayı kullanın.

1. Listede, eylem menüsünü açmak için webhook satırının sonundaki … düğmesini seçin.
2. Send test event öğesini seçin. Webhook’un URL’sinin altında bir onay görünür.
3. Aynı menüden Delivery log öğesini açın. Result değeri OK olan bir webhook.test satırı, uç noktanızın 2xx durum koduyla yanıt verdiği anlamına gelir.

Test olayının türü webhook.test, data değeri ise { "test": true, "sentAt": "..." } şeklindedir. Flowella bunu, hangi olayları işaretlediğinizden bağımsız olarak ve webhook etkin olmasa bile gönderir. Webhook başvurusu tam gövdeyi gösterir.

​

Teslimat günlüğü

Son 50 teslimat denemesini en yeniden başlayarak görmek için webhook’un eylem menüsünde Delivery log öğesini seçin. Uygulamadaki günlük yanıt gövdelerini göstermez ve yeniden teslim düğmesi yoktur. Bir yanıt gövdesinin ilk 1.024 karakterini okumak veya bir olayı yeniden teslim etmek için webhook teslimatları API’sini kullanın.

​

Yeniden denemeler ve bekleme

Uç noktanız 10 saniye içinde 2xx durum koduyla yanıt verdiğinde teslimat başarılı olur. Yanıt vermezse Flowella hemen yeniden dener: toplam 3 deneme, ilk hatadan yaklaşık 1 saniye ve ikinci hatadan yaklaşık 2 saniye sonra. Üçüncü başarısız denemeden sonra Flowella o olayı bırakır ve daha sonra yeniden denemez. Akış şeması her olaya ne olduğunu ve Flowella’nın bir webhook’u ne zaman kapattığını gösterir. Arka arkaya 10 olayın tüm denemeleri başarısız olduğunda Flowella webhook’u kapatır ve durumu Inactive olarak değişir. Kuruluşun her Owner’ı, bildirim tercihleri ne olursa olsun “Outbound webhook disabled” başlıklı bir uygulama içi bildirim alır. Herhangi bir başarılı teslimat sayacı sıfırlar. Bir webhook etkin değilken Flowella ona hiçbir olay göndermez ve olayları daha sonra göndermek üzere saklamaz. Kaçırdığınız olayları telafi etmek için olayları 7 gün saklayan GET /v1/events ile olay akışını okuyun. Bkz. webhook başvurusu.

​

Uç noktaları yönetme

Her satırın eylem menüsünde Edit, Send test event, Delivery log ve Delete bulunur.

​

Bir webhook’u düzenleme

Edit webhook iletişim kutusunu açmak için Edit öğesini seçin. Şunları değiştirebilirsiniz:

• Endpoint URL.
• Events. En az biri işaretli kalmalıdır.
• Webhook active. Teslimatları bir süreliğine durdurmak için işareti kaldırın. Webhook etkin değilken gerçekleşen olaylar daha sonra gönderilmez.
• New signing secret. Geçerli anahtarı korumak için boş bırakın. Yeni bir anahtar en az 8 karakter olmalıdır, aksi halde Flowella geçerli anahtarı korur.

Değişiklikleri uygulamak için Save öğesini seçin. Düzenleme iletişim kutusu Name (optional) alanını da gösterir, ancak değiştirilen ad kaydedilmez. Bir webhook’u yeniden adlandırmak için name ile PATCH /v1/webhooks/{id} kullanın.

​

Bir webhook’u yeniden açma

Flowella bir webhook’u kapattıktan sonra önce uç noktanızdaki sorunu düzeltin. Ardından:

1. Edit öğesini seçin, Webhook active seçeneğini işaretleyin ve Save öğesini seçin.
2. Send test event öğesini seçin ve Delivery log içinde OK göründüğünü kontrol edin.

Testi atlamayın. Webhook’u uygulamada açmak hata sayısını 10’da tutar, bu nedenle tek bir başarısız olay onu yeniden kapatır. Başarılı bir test olayı gibi başarılı bir teslimat sayacı sıfırlar. POST /v1/webhooks/{id}/reactivate API çağrısı webhook’u açar ve sayacı tek adımda sıfırlar.

​

Bir webhook’u silme

Delete öğesini seçin, ardından Delete webhook? iletişim kutusunda Delete ile onaylayın. Flowella uç noktayı ve teslimat geçmişini kaldırır. Bu işlem geri alınamaz.

​

Sorun giderme

​

İlgili