Webhook nasıl kurulur? (fatura ödendi, teklif kabul edildi… bildirimleri)

Webhook, Loggerise Finans'ta bir olay olduğunda belirlediğiniz adrese otomatik istek göndermesidir. Örneğin fatura tamamen ödendiğinde CRM'inizdeki fırsat "kazanıldı" olabilir.

Adım adım

1. Bildirimi alacak adresi hazırlayın (https).
2. Olayları seçin:
   • invoice.paid — fatura tamamen ödendi
   • einvoice.status_changed — e-Fatura / e-Arşiv belge durumu değişti
   • einvoice.incoming.received — yeni gelen e-Fatura alındı
   • einvoice.outgoing.failed — giden e-Fatura gönderilemedi
   • quote.accepted / quote.declined — teklif kabul / red
   • expense.paid — gider banka/kasadan ödendi
3. Yapay zekâyla: asistana adres ve olayları söyleyin; onay özetini kabul edin.
4. API ile: POST /api/v1/webhooks ucuna adres, olaylar ve gizli anahtarla istek gönderin (alanlar /api/docs'ta).
5. Gelen isteklerin imzasını HMAC-SHA256 ile gizli anahtarınızla doğrulayın.
6. Gönderim sonuçlarını API'deki teslimat listesinden ya da asistana "webhook gönderimleri" diye sorarak izleyin; başarısız gönderim 5 kez yeniden denenir.

Sık sorulanlar

Adresim iç ağda, çalışır mı?

Hayır. Güvenlik gereği iç ağ ve yerel adreslere gönderim yapılmaz.

Webhook'u nasıl kapatırım?

API ile pasife alın ya da silin; asistan araçlarında silme olmadığından pasife alma kullanılır.

Bir olayı kaçırırsam?

Başarısız gönderimler yeniden denenir; yine de kritik işlerde API'den durumu düzenli sorgulayın.

Bu makale Loggerise Finans · ön muhasebe kılavuzunun parçasıdır. Markdown sürümü