# Webkapcsok (webhookok)

> Webkapocs létrehozása, szerkesztése és törlése, a hibás kézbesítések kezelése és a kézbesítési napló.

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.

![A Webhook adatok űrlap a Név, Állapot, Témakör, Kézbesítési URL, Titok és API verzió mezőkkel](./kepek/beallitasok-webkapcsok-szerkeszto.webp)

*A Webhook adatok űrlap a Név, Állapot, Témakör, Kézbesítési URL, Titok és API verzió mezőkkel* (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

![A Webkapcsok lista egy webkapoccsal](./kepek/beallitasok-webkapcsok-lista.webp)

*A Webkapcsok lista egy webkapoccsal* (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.

![A Naplók fül a naplófájlok listájával és a forrás szerinti szűrővel](./kepek/beallitasok-webkapcsok-naplo.webp)

*A Naplók fül a naplófájlok listájával és a forrás szerinti szűrővel* (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.