Webkapcsok (webhookok)

A webkapocs (webhook) egy eseményről szóló automatikus értesítés, amelyet a bolt egy általad megadott URL-re küld. Így egy webhelyen történt esemény egy másik webhelyen vagy külső szolgáltatásban indíthat el műveletet. Harmadik fél szolgáltatásaival való összekötésre jó.

A WooCommerce értesítést küldhet, amikor rendelést, terméket, kupont vagy vásárlót hozol létre, szerkesztesz vagy törölsz, vásárlás történik, és így tovább. WooCommerce-műveletekhez is köthető: például egy webkapocs minden alkalommal elindulhat, amikor valaki kosárba tesz egy terméket (woocommerce_add_to_cart). Egyedi kódok készítéséhez és testreszabásához fejlesztő segítsége kell.

Webkapocs létrehozása

1. Menj a WooCommerce → Beállítások → Haladó → Webkapcsok oldalra.
2. Kattints az Új webhook gombra. Megjelenik a Webhook adatok űrlap.
3. Töltsd ki a mezőket (lásd lent).
4. Kattints a Webhook mentése gombra.

https://minta-bolt.hu/wp-admin/admin.php?page=wc-settings&tab=advanced&section=webhooks&edit-webhook=1

A képen egy elmentett webkapocs szerkesztője látszik, alul a Webhook mentése és a Végleges törlés hivatkozással.

Mező	Mit csinál
Név	A webkapocs leírása. Ha üresen hagyod, a neve „Webhook created on” és a dátum lesz; később módosíthatod.
Állapot	Aktív: értesítést küld. Szüneteltetve: átmenetileg nem küld. Letiltva: hibák miatt áll le a kézbesítés.
Témakör	Az esemény, amely elindítja: kuponokhoz, vásárlókhoz, rendelésekhez, termékekhez kapcsolódó események és az egyedi művelet. A bekapcsolt bővítmények további témaköröket adhatnak. Az egyedi témakör haladó felhasználóknak való, a woocommerce_webhook_topic_hooks szűrővel vezethető be.
Művelet esemény	A művelet típusú témakörnél jelenik meg: add meg a műveletet, amely elindítja a webkapcsot, például woocommerce_add_to_cart.
Kézbesítési URL	Az URL, ahová az adat érkezik.
Titok	Titkos kulcs, amellyel a küldött adatról kivonat készül; a kivonat a kérés fejlécében utazik. Ha üresen hagyod, az aktuális API-felhasználó fogyasztói titka lesz.
API verzió	A küldött adat REST API-verziója.

Amikor először mentesz Aktív állapotú webkapcsot, a WooCommerce egy próbajelzést (ping) küld a kézbesítési URL-re.

Hibás kézbesítés

A WooCommerce automatikusan letiltja a webkapcsot, ha egymás után több mint öt kézbesítés sikertelen. Sikertelen minden olyan válasz, amely nem 2xx, 301 vagy 302 HTTP-állapotkód (például a 4xx és 5xx hibák). A küszöböt fejlesztő a woocommerce_max_webhook_delivery_failures szűrővel módosíthatja.

Szerkesztés és törlés

https://minta-bolt.hu/wp-admin/admin.php?page=wc-settings&tab=advanced&section=webhooks

A képen a lista a webkapocs nevével, állapotával, témakörével és kézbesítési URL-jével látszik.

1. Keresd meg a módosítandó webkapcsot a listán.
2. Vidd fölé az egeret a nevének, hogy megjelenjenek az azonosító és a Szerkesztés, illetve Végleges törlés lehetőségek.
3. A Végleges törlés törli, a Szerkesztés megnyitja a beállításait; módosítás után kattints a Webhook mentése gombra.

Több webkapcsot egyszerre is törölhetsz: jelöld be őket, és a Tömeges műveletek menüből válaszd a törlést.

Kézbesítési napló

A WooCommerce naplózza a webkapcsot elindító eseményeket. A napló alapján ellenőrizheted a kézbesítést és a fogadó szerver válaszát, ami megkönnyíti a hibakeresést.

https://minta-bolt.hu/wp-admin/admin.php?page=wc-status&tab=logs

1. Menj a WooCommerce → Állapot → Naplók oldalra.
2. Ha sok naplófájlod van, a Minden forrás listából válaszd a webhooks-delivery forrást, és kattints a Szűrés gombra.
3. A keresőmezővel a naplófájlok tartalmában is kereshetsz.

A képen még nincs webkapocs-napló, mert a példabolton nem történt kézbesítés: csak a bolt saját naplója látszik.