Ugrás a fő tartalomhoz
Was this helpful?

Webhook-hibák

A PrimeCal automatizálási szabályait bejövő webhook-ok is kiválthatják — egy külső szolgáltatás JSON-payloadot küld POST-kéréssel egy egyedi URL-re, és az automatizálás lefut. Ez az oldal azt mutatja be, mit kell ellenőrizni, ha egy webhook nem a várt módon aktiválódik.

A webhook URL megértése​

Minden webhook.incoming triggerrel rendelkező automatizálási szabálynak saját egyedi URL-je van:

POST https://app.primecal.eu/api/automation/webhooks/{token}/receive

A {token} az adott szabályra jellemző. Az Automatizálás → [A szabályod] → Webhook menüben találod meg.

A webhook nem aktiválódik​

1. lépés: Ellenőrizd, hogy az URL helyes-e.

Másold ki a webhook URL-t a szabály Webhook részéből a PrimeCal-ban, és ellenőrizd, hogy megegyezik-e azzal, amelyre küldesz. A tokenek hosszú véletlenszerű karakterláncok — egyetlen karakter különbség is azt jelenti, hogy a webhook nem egyezik meg egy szabályával sem.

2. lépés: Ellenőrizd, hogy a kérés eléri-e a PrimeCalt.

Ellenőrizd, hogy a külső szolgáltatásod (Slack, Zapier, saját szolgáltatásod stb.) ténylegesen elküldi-e a HTTP-kérést:

  • Nézd meg a szolgáltatásod kimenő webhook-naplóit
  • Ellenőrizd, hogy a kérés 2xx állapotkódot kap-e a PrimeCal-tól

A 404 azt jelenti, hogy a token hibás. A 400 azt jelenti, hogy a payload-formátum helytelen. A 200 azt jelenti, hogy a PrimeCal megkapta.

3. lépés: Ellenőrizd az automatizálási szabály feltételeit.

A webhook csak akkor váltja ki a szabályt, ha a feltételek teljesülnek. Ha az automatizálásodban olyan feltételek szerepelnek, mint például webhook.data.status egyenlő "completed", a szabály nem fut le, ha a bejövő payload más értéket tartalmaz.

Menj az Automatizálás → [A szabályod] → Napló menübe, ahol láthatod, hogy a webhook megérkezett-e, és hogy miért futott le vagy nem.

A napló „Megérkezett, de a feltételek nem teljesültek" üzenetet mutat​

Ez a leggyakoribb eset. A webhook sikeresen megérkezett a PrimeCal-hoz, de a szabály feltételei nem egyeztek meg a payloaddal.

Ellenőrizd a feltételértékeket:

  • A webhook.data.status a JSON-törzs data.status elemét éri el
  • Az összehasonlítás az equals operátornál megkülönbözteti a kis- és nagybetűket
  • Használj contains operátort az equals helyett, ha részleges egyezést szeretnél

Példa payload:

POST /api/automation/webhooks/abc123.../receive
{
  "event": "order.completed",
  "data": {
    "status": "completed",
    "customer_id": "cust_456"
  }
}

Ennél a payloadnál a webhook.data.status mező értéke "completed" lenne.

A webhook URL 401-es vagy 403-as hibát ad vissza​

A webhook URL-ek nyilvánosak, és nem igényelnek hitelesítést — maga a token az engedélyezési mechanizmus. Ha 401-es vagy 403-as hibát kapsz:

  • Ellenőrizd, hogy nem küldesz-e véletlenül olyan Authorization fejlécet, amely ütközik
  • Ellenőrizd, hogy a webhook URL-t nem generálták-e újra — ha a tokent újra kellett generálni, a régi URL érvénytelen

Token újragenerálásához (ami egyben érvényteleníti a régi URL-t is): menj a szabály részleteihez → Webhook fül → Token újragenerálása. Ezután frissítsd az URL-t a külső szolgáltatásban.

A webhook 200-as kódot ad vissza, de semmi sem történik​

Ha a napló azt mutatja, hogy a webhook megérkezett és a feltételek teljesültek, de az akció nem futott le:

  1. Ellenőrizd az akció konfigurációját — a set_event_color esetén léteznie kell egy eseménynek a megfelelő naptárkontextusban
  2. Ellenőrizd, hogy a szabály engedélyezve van-e (nincs szüneteltetve)
  3. Vedd figyelembe a sebességkorlátozást: az automatizálási szabályoknál futások között 1 perces várakozási idő van, hogy megakadályozzák az elszabaduló ciklusokat. Ha egy második webhook az első után egy percen belül érkezik, előfordulhat, hogy kihagyják

Webhook kézi tesztelése​

A webhook-ot curl-lel vagy bármely HTTP-klienssel tesztelheted:

curl -X POST https://app.primecal.eu/api/automation/webhooks/YOUR_TOKEN_HERE/receive \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"status": "completed"}}'

Ezután nézd meg az automatizálási szabály naplóját, hogy látható legyen, megérkezett-e és feldolgozták-e a kérést.

Még mindig elakadtál?​