# Hibaelhárítás

> Hitelesítési hibák, hibás és leállított feladatok, az adatküldés elmaradása, cron-beállítás, REST API-problémák és más gyakori gondok megoldása.

## Hol kezdd

- **Első beállításnál**: ha a Zap beállításakor van gond, nézd meg a hitelesítési hibák részt lent.
- **Üzem közben**: a problémák többnyire a **WooCommerce → Zapier → Feladatelőzmények** oldalon és a Zapier **Task History** oldalán jelennek meg. A hibás feladatnál innen eljuthatsz az érintett elemhez, és megnézheted annak **Zapier-integráció előzményei** dobozát, vagy a naplókat.
- **Zapek hibái**: a Zapier beállításával, működésével kapcsolatos problémákhoz a Zapier támogatása a legjobb címzett.
- **Általános WooCommerce-hibák**: először a **WooCommerce → Állapot** oldalt és a naplókat nézd.

![A Zapier-integráció szakasz az Állapot oldalon](./kepek/zapier-integracio-allapot.webp)

*A Zapier-integráció szakasz az Állapot oldalon* (https://minta-bolt.hu/wp-admin/admin.php?page=wc-status)

### Részletes naplózás bekapcsolása

Hibakereséshez a támogatás is kérheti, hogy kapcsold be a részletes naplózást:

1. Menj a **WooCommerce → Beállítások → Zapier** oldalra.
2. Jelöld be a **Részletes naplózás engedélyezése** négyzetet.
3. Kattints a **Módosítások mentése** gombra.

Hibakeresés után kikapcsolhatod.

## A bővítmény frissítése nem megy

Ha a bővítményt a WordPress-adminból nem tudod telepíteni vagy frissíteni:

1. A **WooCommerce → Bővítmények → My Subscriptions** oldalon ellenőrizd, hogy a WooCommerce.com-fiókod csatlakoztatva van, és a bővítmény licence aktív.
2. Ugyanitt kattints a **Refresh** gombra a fiókadatok frissítéséhez.
3. A **Vezérlőpult → Frissítések** oldalon kattints az **Újraellenőrzés** gombra.
4. A bővítményfrissítés megjelenik a frissítések között: jelöld ki, és frissítsd.
5. Ha továbbra sem megy, bontsd a WooCommerce.com-fiók kapcsolatát (a My Subscriptions oldalon a jobb felső avatár fölé víve a **Disconnect account** gombbal), majd csatlakoztasd újra, és ismételd a 2-4. lépést.
6. Ha még mindig nem megy, kérj segítséget a WooCommerce támogatásától.

A WooCommerce 8.8 és újabb verzióihoz a WooCommerce.com Update Manager bővítmény is kell az automatikus frissítésekhez.

## Hitelesítési hibák

Ezek a hibák a Zapier hitelesítési ablakában jelennek meg, piros üzenetként. Jegyezd fel pontosan az üzenetet, és keresd meg lent.

A hitelesítési ablak helyes kitöltéséről az [Az első Zap](zapier-integracio-elso-zap/) fejezet szól.

| Hibaüzenet | Mit jelent, mit tegyél |
|---|---|
| **The username and/or password you supplied is incorrect** (`woocommerce_rest_cannot_authorize`) | Rossz felhasználónév vagy jelszó. Használj alkalmazásjelszót, vagy a WordPress-belépési jelszavadat. Nézd meg a biztonsági bővítmények beállításait, multisite-nál a GYIK-ot, a kompatibilitási problémákat, és használj részletes naplózást |
| **This user does not have the correct permissions** (`woocommerce_rest_cannot_authorize`) | A felhasználónév és jelszó helyes, de a fióknak nincs elég jogosultsága: nem olvashatja a WooCommerce webhookokat. Alkalmazásjelszóra is érvényes. Ha egyedi szerepkör-kezelő bővítményt használsz, a szerepkörnek kezelnie kell a WooCommerce webhookokat, és kellenek neki a `manage_woocommerce`, `promote_users`, `edit_users` jogosultságok. Biztonsági megoldás vagy tűzfal (például Cloudflare WAF) is blokkolhatja |
| **Sorry, you cannot list resources** (`woocommerce_rest_cannot_view`) | A WooCommerce elfogadta a belépést, de a REST API hitelesítésénél van gond. Ellenőrizd az SSL-ellenőrzést, frissíts a WooCommerce 4.7 vagy újabb verziójára, nézd meg a biztonsági bővítményeket, használj részletes naplózást, és olvasd el a WooCommerce REST API hitelesítés részt lent |
| **The Zapier Integration for WooCommerce plugin is missing or WordPress pretty permalinks may not be configured correctly. File Not Found (404)** | A hitelesítés HTTP 404 hibát kapott. Ellenőrizd a megadott Honlap címet: a nyitóoldal teljes címe legyen záró perjel nélkül, nem a bolt oldalának címe. Győződj meg róla, hogy a bővítmény telepítve van és naprakész, nem alapértelmezett állandó hivatkozás van beállítva, majd a **Beállítások → Állandó hivatkozások** oldalon kattints a mentésre az átírási szabályok frissítéséhez |
| **Authentication response starts with a BOM character** | A webhely legalább egy fájlja titkos bájtsorrend-jelet (BOM) tartalmaz, ezért minden válasz egy majdnem láthatatlan karakterrel kezdődik. A böngészőknek ez nem okoz gondot, a REST API-t használó alkalmazásoknak igen. A leggyakoribb ok a `wp-config.php` fájl eleje vagy vége, de lehet egy bővítmény- vagy témafájl is. Keresd meg szövegszerkesztővel, vagy ideiglenesen válts alapértelmezett témára, kapcsolj ki minden bővítményt a WooCommerce-en és a Zapier-integráción kívül, és egyenként kapcsold vissza őket. Weboldal-ellenőrzésre a W3C Internationalization Checker használható |
| **Authentication response parse failed** | A bolt nem érvényes JSON-nal válaszolt. A webhely legyen nyilvánosan elérhető, kapcsold ki a „Hamarosan” vagy karbantartási üzemmódot. A szerver, hosting vagy CDN ne blokkolja a szükséges API-végpontokat |
| **Authentication response is missing required information** | A bolt nem érvényes hitelesítési üzenettel válaszol. Lásd a REST API-hibák részt |
| **Cloudflare WAF at … is blocking Zapier** | A Cloudflare webalkalmazás-tűzfala blokkolja a Zapier kapcsolatát. Lásd a tárhelyszolgáltatóknál leírtakat |
| **Imunify360 security software at … is blocking Zapier** | Az Imunify360 blokkolja a Zapier kapcsolatát. Lásd a tárhelyszolgáltatóknál leírtakat |
| **HTTPS (secure) connection required** | A boltot HTTPS-en kell elérni, és a megadott cím `https://` kezdetű legyen. Ha a boltod nem támogatja a HTTPS-t, fordulj a tárhelyszolgáltatódhoz vagy fejlesztődhöz |
| **Sorry, your connection isn't secure. Please use TLS (HTTPS) to continue** | Lásd az SSL-ellenőrzés sikertelensége részt |
| **Moved Permanently (301)** és más átirányítási hibák (300, 302, 303, 304, 305, 307, 308) | A hitelesítés átirányítást kapott. Ellenőrizd a Honlap címet (a teljes nyitóoldal-cím záró perjel nélkül). Ne legyen olyan bővítmény vagy egyedi kód, amely a záró perjelet kényszeríti. Nézd meg az átirányítást végző bővítményeket és beállításaikat, a biztonsági bővítményeket, és próbáld ideiglenesen kikapcsolni a harmadik fél bővítményeit |
| **Bad Request (400)** | Ellenőrizd, hogy a webhely hiba nélkül elérhető-e. Nézd át a WooCommerce **Állapot** oldalát, kapcsold ki a harmadik fél bővítményeit, és használj részletes naplózást |
| **Not Acceptable (406)** | A webhely WordPress.com-on van tárolva, vagy a Jetpack WordPress.com Secure Sign On (SSO) funkcióját használja. Alkalmazásjelszóval kell hitelesíteni, lásd lent |
| **Request to `/wc-zapier-auth/v1/authenticate` failed, reason: read ECONNRESET** | Hálózati szintű probléma: a Zapier és a webhely közötti TCP-kapcsolat váratlanul megszakadt. Az ok általában a bővítményen kívül van: a tárhely vagy a webszerver tűzfala vagy biztonsági eszköze akadályozza a hitelesítési kérést. Kérd meg a tárhelyszolgáltatót, hogy ne blokkolja a hitelesítési kéréseket. Végső megoldás a webhely másik tárhelyre költöztetése. HTTPS/SSL-beállítási hiba is lehet |
| Üres hitelesítési hibaüzenet | Kapcsold be a részletes naplózást, hitelesíts újra, és nézd át a naplót. Ha a naplóban „Ping Endpoint Error” és a `/wc-zapier/v1/ping` útvonalra vonatkozó „Current Filter parse_request” üzenet szerepel, a webhely nem látja a várt hitelesítési lekérdezési paramétereket: ez gyakran a tárhely vagy szerver hibás beállítása. WP Engine tárhelynél lásd az ott leírtakat |

Ha a felhasználónév és jelszó biztosan jó, a hiba valószínűleg biztonsági szolgáltatás vagy bővítmény miatt van. Lásd a [Kompatibilitás](zapier-integracio-kompatibilitas/) fejezetet.

### Részletes naplózás a hitelesítési hiba okának kiderítésére

1. Telepítsd a bővítmény legújabb verzióját.
2. A **WooCommerce → Beállítások → Zapier** oldalon jelöld be a **Részletes naplózás engedélyezése** négyzetet, és mentsd.
3. A Zapier Zap-szerkesztőjében próbálj újra hitelesíteni.
4. A kísérlet valószínűleg újra sikertelen lesz, de most a részletes ok bekerül a WooCommerce-naplókba.
5. A **WooCommerce → Állapot → Naplók** oldalon válaszd ki a legújabb `woocommerce-zapier` kezdetű naplót, és nyisd meg a **Megtekintés** gombbal.
6. Keress `Authentication attempt failed` vagy `Authentication validation failed` üzenetet: mellette a részletes ok szerepel.

A hibakeresés végén kikapcsolhatod a részletes naplózást. Ha nem sikerül megoldani, a támogatásnak add meg a piros hibaüzenetet és a naplóbejegyzést.

## Kompatibilitási problémák hitelesítéskor

Hálózathoz csatlakozó eszközök, beállítások vagy szoftverek (CDN, terheléselosztó, tűzfal, szerverszoftver, tárhelyszolgáltató) zavarhatják a bolt és a Zapier kommunikációját. A legjobb kompatibilitás érdekében használj alkalmazásjelszót. További információ a [Kompatibilitás](zapier-integracio-kompatibilitas/) fejezetben.

## Hibás feladatok (Errored)

A feladathibák oka a feladatelőzményekben mindig látszik. Gyakori hibák és megoldásuk:

| Hibaüzenet | Megoldás |
|---|---|
| **Management of Product Prices is not available. Please update the plugin…** | Az **Update Product Price** művelethez a bővítmény megfelelően friss verziója kell. Frissítsd a bővítményt |
| **Management of Product Stock Quantities is not available. Please update the plugin…** | Az **Update Product Stock Quantity** művelethez frissítsd a bővítményt |
| **Bookings are not enabled…** | A Foglalás erőforráshoz telepítsd és aktiváld a WooCommerce Bookings bővítményt, és frissítsd a Zapier-integrációt |
| **Memberships are not enabled…** | A Tagsági csomag és Felhasználói tagság erőforráshoz telepítsd és aktiváld a WooCommerce Memberships bővítményt, és frissítsd a Zapier-integrációt |
| **Coupons are not enabled…** | Engedélyezd a kuponokat a WooCommerce beállításaiban (**WooCommerce → Beállítások → Általános → Kuponkódok használatának engedélyezése**) |
| **Subscriptions are not enabled…** | Az Előfizetés erőforráshoz telepítsd és aktiváld a WooCommerce Subscriptions bővítményt |
| **Sorry, you cannot view this resource.** (`woocommerce_rest_cannot_view`) | A WooCommerce-webhookod hibásan van beállítva. Lásd a webhookproblémák részt |
| **Create/Update/Search/List Resource response parse failed** | A bolt REST API-ja nem érvényes JSON-nal válaszol, ezért a feladat leállt. A webhely legyen nyilvánosan elérhető („Hamarosan” és karbantartási üzemmód kikapcsolva). Kapcsold be a részletes naplózást, és nézd át a REST API-naplókat. Ellenőrizd az inkompatibilis bővítményeket és a REST API-hibák részt. A probléma megoldása után játszd újra a leállított feladatokat |
| **Hook Resource response parse failed** | A bolt webhook-mechanizmusa érvénytelen JSON-t küld a Zapiernek. A webhely legyen nyilvános, nézd át a WooCommerce webhook-kézbesítési naplóit és a REST API-hibák részt |
| **Cloudflare WAF at … is blocking Zapier** | Lásd a tárhelyszolgáltatóknál leírtakat. A megoldás után a leállított feladatokat újra lejátszhatod |
| **Imunify360 security software at … is blocking Zapier** | Lásd a tárhelyszolgáltatóknál leírtakat. A megoldás után újra lejátszhatod a feladatokat |
| **Unexpected response from …** | A biztonsági szoftver elfogja a Zapier kéréseit, és váratlan választ ad. Engedélyezd (whitelist) a `User-Agent: Zapier` fejlécet a biztonsági szoftverben. A megoldás után játszd újra a feladatokat |

## Leállított feladatok (Halted)

A legtöbbször a leállított feladat várt működés: például ha Filter lépést használsz, és a bejövő adat nem felel meg a szűrőfeltételnek. Gyakori ok az is, hogy a WooCommerce nem tudja végrehajtani a feladatot az erőforráson: például olyan kuponkóddal próbálsz új kupont létrehozni, amely már létezik. A bővítmény ezeket az eseteket kezeli, hogy ne okozzon bajt a WooCommerce-ben, és a feladat részletező oldalán mindig részletes magyarázatot ad.

## Az erőforrás rossz állapottal érkezik

A bővítmény az Action Schedulert használja, amely a WooCommerce magfunkciója, és az adatküldéshez megfelelően kell működnie. Az adatok nem azonnal mennek a Zapierbe: sorba kerülnek, és aszinkron módon, a háttérben kézbesülnek. Szokásos késés tíz másodperc és egy perc között van, de tesztkörnyezetben vagy kis forgalmú webhelyen sokkal hosszabb is lehet.

Ha egy erőforrás állapota az ütemezés és a küldés között megváltozik, a WooCommerce az új állapottal küldi. Ha az **Order status changed (any status)** vagy a **Subscription status changed (any status)** szabályt használod, a Zapier ilyenkor ugyanazt az adatot többször kaphatja meg. A Zapier platform automatikusan kiszűri a duplikációkat. Ha ennek ellenére tapasztalod, vedd fel a kapcsolatot a támogatással.

## Nem érkezik adat a Zapierbe

Gyakori okok:

- Az **Order created** szabály működik, de az **Order paid** nem (lásd a [Rendelések](zapier-integracio-rendelesek/) fejezetet: az offline fizetéseknél nem fut le).
- A webhook hiányzik vagy le van tiltva.
- Action Scheduler-problémák: a feladat sikertelen, vagy még függőben van.
- WordPress Cron-problémák.

### Webhookproblémák

A bővítmény a WooCommerce beépített webhook-mechanizmusát használja az adatküldéshez.

**Hiányzó vagy letiltott webhook.** Ha a WooCommerce hibát kap a Zapierbe küldéskor, automatikusan letiltja a webhookot, és a Zapbe nem megy több adat. A **WooCommerce → Beállítások → Haladó → Webkapcsok** oldalon keress letiltott `WooCommerce Zapier` webhookokat, és szerkessz mindegyiket aktívra. Ha egy webhook hiányzik vagy véletlenül törölted, a Zapier oldalán kapcsold ki, majd be a WooCommerce Zapedet: ezzel a webhook újra létrejön. Ha egy webhookot váratlanul letiltott a WooCommerce, keresd a webhook azonosítóját az Action Scheduler sikertelen feladatai között az ok kiderítéséhez.

**Webhook-adatproblémák.** A webhookokat a bővítmény automatikusan hozza létre, és ahhoz a WordPress-felhasználóhoz kötődnek, aki létrehozta őket. Ha ezt a felhasználót törlik, vagy a jogosultságai megváltoznak (például Adminisztrátorból Közreműködő lesz), a webhookok leállnak. Ennek jele: a Zapier-feladatok a „Sorry, you cannot view this resource. Error code: woocommerce_rest_cannot_view” hibával állnak le, és a bővítmény naplójába „Unexpected WP_Error payload for Webhook” hibaüzenet kerül. A megoldás:

1. A Zapier oldalán nyisd meg a WooCommerce alkalmazás kapcsolatait.
2. A kapcsolat melletti 3 pontra kattintva válaszd a **Reconnect** lehetőséget.
3. Hitelesíts újra a követelményeknek megfelelően.
4. Ismételd meg minden WooCommerce-kapcsolatnál.
5. Az újrahitelesítés után a Zapier WooCommerce Zapek oldalán kapcsold ki, majd be mindegyik WooCommerce Zapet. Ez újra létrehozza a webhookokat.
6. Opcionálisan elküldheted az elmaradt adatokat utólag: a hibás naplóbejegyzések felsorolják az érintett erőforrások azonosítóit (például rendelés- vagy termékazonosítót).

Ha más `ERROR` üzenetet látsz a naplóban vagy a feladatelőzményekben, fordulj a támogatáshoz, és add át a bővítmény naplóinak teljes másolatát.

### Action Scheduler

Az Action Scheduler a WordPress beépített Cronját használja az ütemezéshez, ezért csak akkor működik megfelelően, ha a WordPress Cron is jól működik.

**Függőben lévő feladatok.** Az **Időzített műveletek** oldalon a **Pending** (függőben) szűrővel nézd a feladatokat. Keress `woocommerce_deliver_webhook_async` nevű feladatot: ha van ilyen, a sorba állított adat még nincs elküldve. Kézzel is futtathatod őket, de ha folyamatosan függőben maradnak, ki kell derítened, miért nem dolgozza fel automatikusan a sort az Action Scheduler: az ok általában a WordPress Cron hibás működése. Ha a gond marad, nézd át a naplókat.

**Sikertelen feladatok.** Az **Időzített műveletek** oldalon kattints a **Failed** szűrőre (ha nincs ilyen szűrő, nincs sikertelen feladatod). Itt azonosító alapján (például rendelés- vagy termékazonosítóval) rákereshetsz az erőforrásra, és ellenőrizheted, hogy egyáltalán elküldték-e a Zapierbe. Sikertelen feladat újraküldése nincs: az adatok utólagos átviteléről a [Műveletek és keresések](zapier-integracio-muveletek-es-keresesek/) fejezetben írunk.

Ha az ok időtúllépés, az gyakran azért van, mert az Action Schedulernek túl sok feladata van, és a PHP engedélyezett időkorlátja (alapból 30 másodperc) nem elég. Módosítsd a tárhelyen a PHP `max_execution_time` beállítást, lehetőleg legalább 120 másodpercre. Az Action Scheduler működését az Action Scheduler High Volume bővítménnyel is finomhangolhatod, de az csak legalább 120 másodperces `max_execution_time` mellett működik jól. Ha sikertelen feladataid vannak, vagy a High Volume bővítmény sem old meg semmit, a támogatásnak add át a napló oszlop tartalmát.

### WordPress Cron

Ha az adatok szabálytalanul vagy lassan, késéssel érkeznek a Zapierbe, a WordPress Cron rendszerében lehet hiba. Ha a cron nem működik jól, a Zapier-integráció sem.

A WP Crontrol bővítmény segít megtalálni a hibát: teszteli a WordPress Cron-indítót, és hibaüzenetet ad, ha az nem sikerül. Kézzel is ellenőrizheted az **Eszközök → Cron Events** oldalon: ha a „Next Run” oszlop értékei többnyire a múltban vannak, főleg napokkal vagy többel, a WordPress Cron nem megfelelően működik.

A cron kipróbálásához nyisd meg a böngészőben a webhely WP-Cron végpontját, például `https://pelda.hu/wp-cron.php`. Utána töltsd újra a Cron Events oldalt: ha a „Next Run” oszlopok nem változtak, mélyebb probléma van. Egyébként használd a szerveroldali cron-feladatot vagy a rendelkezésre állást figyelő szolgáltatásokat.

**Alternate Cron.** Ha a Zapek `rest_api_unavailable` vagy `The Rest API is unavailable.` hibaüzenetet kapnak, amikor a WooCommerce adatot küld a Zapierbe, ez a WooCommerce magjának ismert hibája, és akkor jelentkezik, ha a WordPress `ALTERNATE_WP_CRON` funkcióját használod. Amíg a WooCommerce nem javítja, ki kell kapcsolnod az `ALTERNATE_WP_CRON` állandót a `wp-config.php` fájlban (a sort el kell távolítani).

**Szerveroldali cron-feladat.** Ez a megbízható és időben történő kézbesítés ajánlott módja.

> Ne állíts be cron-feladatot egyszerre az Action Schedulerhez és a WordPress Cronhoz. Ha a WordPress Cron jól működik, elég az Action Schedulerhez beállítani. Különben a WordPress Cronhoz érdemes.

Ha a szerveren van WP-CLI, beállíthatsz egy cron-feladatot, amely feldolgozza az Action Scheduler vagy a WordPress Cron sorát:

```bash
cd /utvonal/a/wordpresshez/ && wp action-scheduler run
```

```bash
cd /utvonal/a/wordpresshez/ && wp cron event run --due-now
```

```bash
cd /utvonal/a/wordpresshez/ && php wp-cron.php?doing_wp_cron
```

(ahol `/utvonal/a/wordpresshez/` a WordPress-telepítés elérési útja.)

Ha a cron-beállítás működik, kikapcsolhatod a WordPress alapértelmezett WP-Cron működését a `wp-config.php` fájlba írt sorral:

```php
define('DISABLE_WP_CRON', true);
```

A cron-feladat beállításában általában segít a tárhelyszolgáltató.

**Multisite hálózatnál** a fenti szerveroldali cron-feladat a hálózat fő webhelyére fut. Ha a Zapier-integrációt a hálózat több webhelyén használod, minden webhelyhez külön cron-feladat kell, eltérő `--url=` paraméterrel, például:

```bash
cd /utvonal/a/wordpresshez/ && wp --url=pelda.hu/au action-scheduler run
cd /utvonal/a/wordpresshez/ && wp --url=pelda.hu/uk cron event run --due-now
```

(ahol `pelda.hu` az egyes webhelyek címe `https://` nélkül.) Ha nem tudod, mi legyen az `--url=` értéke, futtasd a szerveren a `wp site list` parancsot, és használd az URL oszlopot.

A cron-feladatokat érdemes kipróbálni: lépj be SSH-n a szerverre, és futtasd kézzel. Működő parancs ilyesmit ír ki: `Success: 2 scheduled tasks completed.` vagy `Success: Executed a total of 2 cron events.` Ha `command not found` hibát kapsz, kérdezd meg a tárhelyszolgáltatót, hogy a WP-CLI telepítve van-e.

**Rendelkezésre állást figyelő szolgáltatások.** Kevésbé technikai megoldás: hozz létre ingyenes Pingdom- vagy UptimeRobot-fiókot, és állítsd a webhely WP-Cron végpontjára, például `https://pelda.hu/wp-cron.php?doing_wp_cron`. Ez rendszeresen elindítja a WordPress Cront (Pingdomnál 30 másodpercenként, UptimeRobotnál 5 percenként). Multisite-nál minden webhely `wp-cron.php` oldalához külön ellenőrzés kell.

### PayPal-fizetések

Ha a boltban PayPalon át fizetnek, ellenőrizd, hogy a PayPal azonnali fizetési értesítése (IPN) jól van beállítva. A **WooCommerce → Beállítások → Fizetési módok** oldalon kattints a PayPalra, és ellenőrizd, hogy a **Receiver Email** beállítás helyes, és egyezik a PayPal e-mail-címeddel. Másik lehetőség a PayPal Payment Data Transfer (PDT) bekapcsolása a WooCommerce-ben.

## REST API-problémák

A REST API-n át kommunikál a Zapier a bolttal, ezért a REST API-nak működnie kell. Gyakori hibaüzenetek, amelyeket a REST API konfigurációs hibái okozhatnak:

- `Authentication response parse failed.`
- `Authentication response is missing required information.`
- `Create/Update/Search/List/Hook Resource response parse failed`
- `WooCommerce returned "..."` (például „There has been a critical error on this website.”)
- `Webhook Subscribe response parse failed.` és `Webhook Unsubscribe response parse failed.`
- `We're having trouble loading 'Trigger Rule' data (...)`
- `Trigger Rule response parse failed.`
- `Input Fields response parse failed.`

**„Unsupported Media Type” (415).** Ez a hiba a Zapier és a bolt REST API-ja közötti kommunikációkor jelentkezhet, például Find, Create vagy Update művelet közben. A bolt nem fogadta el a Zapier kérését. Gyakran időszakos, de tartós is lehet. Okai: a webhelyen tűzfal vagy biztonsági megoldás blokkolja a Zapier kéréseit (például a Cloudflare WAF), vagy a webszerver rosszul van beállítva. Kérd meg a tárhelyszolgáltatót, hogy ellenőrizze a webszerver beállításait, és szükség esetén engedélyezze a `Zapier` User-Agentet.

**WooCommerce REST API.** Hogy a REST API működik-e, a WooCommerce REST API „első lépések” útmutatója szerint ellenőrizheted. A Zapier összekötéséhez nem kell külön REST-hitelesítő bővítményt telepítened, és a REST API-kulcsokat vagy webhookokat sem kell kézzel kezelned: a bővítmény ezeket magától kezeli.

**Hamarosan vagy karbantartási üzemmód.** A leggyakoribb ok egyszerű: a bolt nem nyilvánosan elérhető, mert „Hamarosan” vagy „Karbantartás” üzemmódot megvalósító bővítmény aktív. Kapcsold ki, és győződj meg róla, hogy a webhely belépés nélkül látható.

**Érvénytelen vagy nem megbízható SSL-tanúsítvány.** A webhelynek érvényes és megbízható SSL-tanúsítvány kell. Ha `certificate verify failed` hibaüzenetet kapsz, a Zapier nem tud csatlakozni, mert a tanúsítványt olyan hitelesítésszolgáltató adta ki, amelyben a Zapier nem bízik. Ilyenkor a Zapier SSL-tanúsítványokra vonatkozó súgóját érdemes követni, és ha nem megy, a Zapier támogatásától kérj segítséget.

**Hibakimenet.** A WordPress vagy PHP hibakimenete érvénytelenné teheti a REST API-válaszokat, ezért a `wp-config.php` fájlban a `WP_DEBUG_DISPLAY` állandó legyen hamis:

```php
define( 'WP_DEBUG_DISPLAY', false );
```

**Az SSL-ellenőrzés sikertelen.** A WooCommerce REST API hitelesítése csak akkor működik, ha a webhely megfelelően van beállítva SSL-re. Ha az **Állapot** oldal Zapier-szakaszában az **SSL** sor piros (Nem), nem tudsz hitelesíteni. Gyakori hibaüzenetek ilyenkor: „Sorry, your connection isn't secure. Please use TLS (HTTPS) to continue.” és „Sorry, you cannot list resources.”. A napló valószínűleg ezt mutatja: `CRITICAL: Authentication validation failed via ping. TLS (HTTPS) required.` A megoldás: kérd meg a tárhelyszolgáltatót, hogy a WordPress `is_ssl()` függvénye `false` értéket ad a WooCommerce REST API kéréseinél, ami gyakran hibás HTTPS/SSL-beállításra utal. Az SSL Server Test is segíthet az általános SSL-hibák felderítésében.

**WooCommerce REST API hitelesítés.** Ha a „Sorry, you cannot list resources.” hibát a fentiek után is látod, a WooCommerce REST API nem tud szokásos fogyasztói kulccsal és titokkal hitelesíteni, ezért az integráció sem működhet. Ellenőrizd a hitelesítést: hozz létre fogyasztói kulcsot és titkot a REST API útmutatója szerint, majd kérdezd le a `https://pelda.hu/wp-json/wc/v3/orders?consumer_key=XXXX&consumer_secret=XXXX` végpontot: `HTTP 200 OK` választ kell kapnod, nem `HTTP 401 Unauthorized` választ. Ha `401` jön, nézd át az ismert inkompatibilis bővítmények listáját. Ha továbbra is `401`, használj külön teszt- vagy staging-környezetet: kapcsolj át alapértelmezett WordPress-témára, kapcsolj ki minden bővítményt a WooCommerce kivételével, és próbálj hitelesíteni. Ha működik, kapcsold vissza a bővítményeket egyenként, így kiderül, melyik okozza a hibát. Ha csak a WooCommerce mellett sem működik, a WooCommerce magjának REST API hitelesítése hibás: kérj segítséget a WooCommerce támogatásától.

## Zapier-leállások

Időnként a Zapier szolgáltatásban kiesés vagy leállás lehet, ami késéseket, kihagyott vagy hibás feladatokat okozhat. Légy türelmes a kiesés elhárításáig, és ne küldd újra az adatokat. Ha a Zapier szolgáltatásai normálisan működnek, kezdheted összegyűjteni, mely adatok hiányoznak. A Zapier **Task History** oldalán keresd meg a hibákat, és innen újra is játszhatod a feladatokat. Ha egyes adatok nem is jutottak el a Zapierbe, meglévő Zappel utólag újraküldheted őket.