Entegrasyonlar
Webhook'lar
Bazı sağlayıcılar bir sonraki eşitlemeyi beklemek yerine olayları anında bildirir. Bunun için onlara VentionDesk'ten bir webhook adresi girersin. Her adres, işletmenin tam olarak bir bağlantısına aittir.
Adresi nerede bulursun
Operasyon › Kaynaklar, bağlantıda “Webhook adresini göster” (yalnızca işletme sahibi). API aynı adresi GET /v1/integrations/:id/webhook altında döndürür. Bağlantıyı yeniden bağlasan bile adres aynı kalır.
| Sağlayıcı | Adres | Kontrol |
|---|---|---|
| Stripe | https://api.ventiondesk.com/webhooks/stripe/<workspace> | Stripe-Signature başlığındaki imza |
| Sentry | https://api.ventiondesk.com/webhooks/errors/sentry/<connection> | Sentry-Hook-Signature başlığındaki imza |
| Bugsnag | https://api.ventiondesk.com/webhooks/errors/bugsnag/<connection>/<secret> | adresteki secret |
| Rollbar | https://api.ventiondesk.com/webhooks/errors/rollbar/<connection>/<secret> | adresteki secret |
Açılı ayraçlar içindeki yer tutucuları VentionDesk doldurur — adresi her zaman “Webhook adresini göster”den kopyala, kendin oluşturma.
Stripe
Stripe › Developers › Webhooks › “Add endpoint” altında tam olarak şu olaylarla oluştur:
checkout.session.completedcheckout.session.async_payment_succeededcheckout.session.async_payment_failedcharge.refunded
Ardından endpoint'in signing secret'ını (whsec_…) kopyala ve Stripe bağlantısını VentionDesk'te onunla yeniden kaydet. Ödeme bağlantısı fatura e-postasında ve belgede ancak o zaman görünür — webhook olmadan bir ödeme, VentionDesk onu kaydetmeden gelirdi.
VentionDesk imzayı (zaman damgası ve gövde üzerinden HMAC-SHA256) bu secret ile kontrol eder ve yalnızca zaman damgası en fazla beş dakika sapan mesajları kabul eder. Anahtarından farklı moddaki olaylar (live yerine test veya tersi) kabul edilir ve atlanır. VentionDesk ödeme bağlantılarından gelen ödemeler ve iadeler kaydedilir. Tam kılavuz: Stripe'ı bağla.
Sentry
Dahili entegrasyonda “Webhooks” altında **“issue”**yu işaretle ve adresi “Webhook URL” olarak gir. Entegrasyonun client secret'ını VentionDesk'e girersin; VentionDesk Sentry-Hook-Signature imzasını (gövde üzerinden HMAC-SHA256) onunla kontrol eder. Yeni ve yeniden açılan hatalar o zaman anında görünür. Kılavuz: Sentry'yi bağla.
Bugsnag
Projede Project settings › “Integrations and email” › “Webhook” altına gir ve “New errors”, “Frequently occurring errors” ve **“Reopened errors”**ı seç. Bugsnag imzalamaz; bu yüzden secret adreste bulunur ve karşılaştırılır. Kılavuz: Bugsnag'i bağla.
Rollbar
Projede Settings › Notifications › “Webhook” altına gir ve “New Item”, “Reactivated Item”, “Resolved Item” ve **“10^nth Occurrence”**ı etkinleştir. Bugsnag'deki gibi secret adreste bulunur. Kılavuz: Rollbar'ı bağla.
Hata izleyicilerden VentionDesk yalnızca meta verileri alır — kimlik, kısaltılmış başlık, seviye, durum, sayaç, ilk ve son görülme ve bağlantı. Stack trace'ler, olay gövdeleri, kullanıcı verileri ve IP adresleri, webhook'ta gelseler bile sağlayıcıda kalır.
GitHub
GitHub için bir şey girmezsin: VentionDesk uygulaması kurulur kurulmaz push'ları, pull request'leri, check run'ları ve dağıtım durumunu otomatik olarak iletir. Bkz. GitHub'ı bağla.
VentionDesk nasıl yanıt verir
- Her teslimat bir kez sayılır. Aynı kimlikle tekrarlanan bir teslimat tanınır ve iki kez işlenmez.
- Yanlış imza veya yanlış secret: Teslimat reddedilir.
- VentionDesk bir teslimatı saklayamazsa 200 yerine bir hatayla yanıt verir — sağlayıcı o zaman yeniden teslim eder ve hiçbir şey sessizce kaybolmaz.
- IP adresi başına her webhook rotası dakikada en fazla 600 teslimat kabul eder.