Skip to main content

Webhook’lar

Webhook’lar, WhatsApp \u00f6rneklerinizde olaylar ger\u00e7ekle\u015fti\u011finde ger\u00e7ek zamanl\u0131 HTTP geri \u00e7a\u011fr\u0131lar\u0131 alman\u0131z\u0131 sa\u011flar. API’yi s\u00fcrekli sorgulamak yerine, Wappfy olaylar\u0131 ger\u00e7ekle\u015ftik\u00e7e sunucunuza iletir.

Desteklenen Olaylar

Wappfy 12 webhook olay t\u00fcr\u00fcn\u00fc destekler:

Webhook Olu\u015fturma

Olaylar\u0131 almaya ba\u015flamak i\u00e7in bir webhook ucu noktas\u0131 kaydedin.
Yan\u0131t:

Yap\u0131land\u0131rma Se\u00e7enekleri

instance_id alan\u0131 iste\u011fe ba\u011fl\u0131d\u0131r. Belirtilmezse webhook, hesab\u0131n\u0131zdaki t\u00fcm \u00f6rneklerden olaylar\u0131 alacakt\u0131r.

Webhook’lar\u0131 Listeleme

Yan\u0131t:

Webhook G\u00fcncelleme

Mevcut bir webhook’\u0131n URL’sini, olaylar\u0131n\u0131 veya yap\u0131land\u0131rmas\u0131n\u0131 g\u00fcncelleyin.

Webhook Silme


Teslimat Veri Y\u00fck\u00fc Format\u0131

Bir olay ger\u00e7ekle\u015fti\u011finde, Wappfy webhook URL’nize a\u015fa\u011f\u0131daki yap\u0131da bir POST iste\u011fi g\u00f6nderir:

Veri Y\u00fck\u00fc Alanlar\u0131


HMAC \u0130mza Do\u011frulamas\u0131

Webhook olu\u015ftururken bir secret sa\u011flarsan\u0131z, her teslimat istek g\u00f6vdesinin HMAC-SHA256 imzas\u0131n\u0131 i\u00e7eren bir X-Wappfy-Signature ba\u015fl\u0131\u011f\u0131 i\u00e7erecektir. \u0130ste\u011fin Wappfy’den geldi\u011finden ve de\u011fi\u015ftirilmedi\u011finden emin olmak i\u00e7in bu imzay\u0131 her zaman do\u011frulay\u0131n.

Do\u011frulama \u00d6rnekleri

Zamanlama sald\u0131r\u0131lar\u0131n\u0131 \u00f6nlemek i\u00e7in imzalar\u0131 do\u011frularken her zaman sabit zamanl\u0131 kar\u015f\u0131la\u015ft\u0131rma (timingSafeEqual veya hmac.compare_digest gibi) kullan\u0131n.

Yeniden Deneme Davran\u0131\u015f\u0131

Sunucunuz yap\u0131land\u0131r\u0131lm\u0131\u015f timeout_ms s\u00fcresi i\u00e7inde 2xx durum kodu ile yan\u0131t vermezse, Wappfy teslimati yeniden dener.
2xx yan\u0131t al\u0131nd\u0131\u011f\u0131nda veya retry_count t\u00fckendi\u011finde yeniden denemeler durur. Varsay\u0131lan yeniden deneme say\u0131s\u0131 3’t\u00fcr.

Teslimat Ge\u00e7mi\u015fini G\u00f6r\u00fcnt\u00fcleme

Ge\u00e7mi\u015f teslimat denemelerini ve sonu\u00e7lar\u0131n\u0131 g\u00f6rmek i\u00e7in webhook teslimat g\u00fcnl\u00fc\u011f\u00fcn\u00fc kontrol edin.
Yan\u0131t:

Olay Veri Y\u00fck\u00fc \u00d6rnekleri


En \u0130yi Uygulamalar

H\u0131zl\u0131 yan\u0131t verin

5 saniye i\u00e7inde 200 durumu d\u00f6nd\u00fcr\u00fcn. Zaman a\u015f\u0131m\u0131n\u0131 \u00f6nlemek i\u00e7in olay\u0131 asenkron olarak i\u015fleyin.

Tekrar\u0131 \u00f6nleyin

Yeniden denemelerden kaynaklanan tekrar teslimatlar\u0131 tespit etmek ve atlamak i\u00e7in teslimat id’sini kullan\u0131n.

\u0130mzalar\u0131 do\u011frulay\u0131n

Bir gizli anahtar yap\u0131land\u0131rd\u0131ysan\u0131z her zaman X-Wappfy-Signature ba\u015fl\u0131\u011f\u0131n\u0131 do\u011frulay\u0131n.

HTTPS kullan\u0131n

Webhook URL’leri HTTPS kullanmal\u0131d\u0131r. HTTP ucu noktalar\u0131 reddedilecektir.