---
title: "Adatok küldése saját rendszereibe webhookokkal"
description: "Kérést kap a saját URL-jére, amikor valaki regisztrál, részt vesz vagy nyer – aláírt payloaddal, alapszintű hitelesítéssel, egyéni payloaddal és minden kézbesítés naplójával."
url: https://scratcher.io/hu/help/developers/webhooks
language: hu
---

1. [Súgóközpont](https://scratcher.io/hu/help)
2. [API, webhookok és MCP](https://scratcher.io/hu/help/developers)
3. Adatok küldése saját rendszereibe webhookokkal

# Adatok küldése saját rendszereibe webhookokkal

Kérést kap a saját URL-jére, amikor valaki regisztrál, részt vesz vagy nyer – aláírt payloaddal, alapszintű hitelesítéssel, egyéni payloaddal és minden kézbesítés naplójával.

A webhook abban a pillanatban adatokat küld egy Ön által választott URL-re, amikor valami történik, például amikor valaki részt vesz egy kampányban vagy nyereményt nyer. A fogadó rendszert az Ön fejlesztője állítja be.

A webhookok azoknak a csomagoknak a részei, amelyek tartalmazzák a **Webhooks & API** funkciót (Basic csomagtól felfelé).

## Kampány-webhookok vagy fiók-webhookok?

- A **kampány-webhookokat** a kampányszerkesztőben állíthatja be, és csak az adott kampánynál aktiválódnak. Ezek eseményei: „Minden alkalommal, amikor egy lead részt vesz egy kampányban” és „Amikor egy lead nyereményt nyer”, és ezek kínálják a legtöbb beállítási lehetőséget.
- A **fiók-webhookokat** a **Beállítások** > **Webhookok** menüpontban állíthatja be. Eseményük: „Amikor új lead jön létre”: személyenként egyszer aktiválódik, amikor az illető először bekerül a leadjei közé, függetlenül attól, melyik kampányból érkezett.

## Webhook hozzáadása egy kampányhoz

1. Nyissa meg a kampányt a szerkesztőben, és lépjen a **Kapcsolódás** > **Webhookok** részre.
2. Kattintson a **Webhook hozzáadása** gombra.
3. Adja meg a **Payload URL**-t. Ennek https-sel kell kezdődnie: „Csak HTTPS-en keresztüli webhookokat támogatunk, hogy a küldött adatok biztonságban maradjanak.”
4. Válassza ki a **Tartalomtípust**: **application/json** vagy **application/x-www-form-urlencoded**.
5. Válassza ki a **Metódust**. Az űrlap alapértelmezése a **GET**, amely az URL-ben küldi az adatokat. Válassza a **POST** lehetőséget, ha a kérés törzsében szeretné küldeni őket – a legtöbb rendszer ezt várja.
6. A **Hitelesítés** résznél (csak POST esetén) válassza a **Basic Auth** lehetőséget, ha az URL felhasználónevet és jelszót igényel, majd töltse ki a **Felhasználónév** és a **Jelszó** mezőt. Ellenkező esetben hagyja a **Nincs** beállítást.
7. Adjon meg egy **Titkos kulcsot** a kérések aláírásához (ajánlott). Lásd lent: „Az aláírás ellenőrzése”.
8. Kapcsolja be a **Válasz törzsének naplózása** opciót, ha látni szeretné, mit válaszol a rendszere. „Engedélyezze a válasz törzsének tárolásához hibakereséshez.”
9. Hagyja bekapcsolva az **Aktív** opciót. „Csak akkor kézbesítünk eseményeket, ha a webhook aktív.”
10. Válassza ki az eseményt: „Minden alkalommal, amikor egy lead részt vesz egy kampányban” vagy „Amikor egy lead nyereményt nyer”.
11. Kapcsolja be az **Egyéni payload** opciót, ha saját maga szeretné meghatározni a mezőket (lásd lent).
12. Kattintson a **Webhook hozzáadása** gombra. Megjelenik a „Webhook hozzáadva” üzenet.

A **Webhookok** panel felsorolja a kampány webhookjait **Aktív** vagy **Inaktív** állapottal, valamint **Az utolsó kézbesítés sikertelen** jelzéssel, ha a legutóbbi kérés nem sikerült. A **Műveletek** menüben **Szerkesztheti**, megnyithatja a **Kézbesítések megtekintése** nézetet, vagy **Törölheti** a webhookot. Szerkesztéskor hagyja üresen a **Titkos kulcs** mezőt, ha meg szeretné tartani a meglévőt.

## Fiók-webhook hozzáadása

1. Lépjen a **Beállítások** > **Webhookok** menüpontra (a **Fejlesztők** alatt). Webhookjai a **Saját webhookok** alatt találhatók (vagy több leadlista esetén az egyes listák neve alatt).
2. Kattintson a pluszjeles kártyára új webhook hozzáadásához. A **Webhook hozzáadása** párbeszédablakban ez áll: „Kérés küldése külső URL-re, amikor a kiválasztott események bekövetkeznek.”
3. Töltse ki a **Payload URL**, a **Tartalomtípus** („Válassza ki a webhook tartalomtípusát”), a **Metódus** és a **Titkos kulcs** mezőt a fentiek szerint.
4. **Mely események aktiválják a webhookot?** résznél válassza a „Amikor új lead jön létre” lehetőséget.
5. Jelölje be az „Igen, egyéni payloadot szeretnék megadni (csak haladó felhasználóknak)” opciót, ha saját mezőket szeretne.
6. Szükség esetén jelölje be a **Válasz törzsének naplózása** opciót („Ez a webhook naplózza a válasz törzsét”), és hagyja bejelölve az **Aktív** opciót („Az esemény részleteit kézbesítjük, amikor ez a hook aktiválódik”).
7. Kattintson a **Webhook hozzáadása** gombra.

Egy webhookra kattintva módosíthatja azt (**Módosítások mentése**), beállíthat **Új titkos kulcsot**, megnyithatja a **Kézbesítések megjelenítése** nézetet, vagy használhatja a **Webhook törlése** lehetőséget („Ez a művelet nem vonható vissza!”).

## Mit küldünk?

Alapértelmezés szerint a törzs egy `event` mezőt (az esemény nevét: `lead_created_on_campaign`, `new_campaign_winner` vagy `lead_created`) és egy `data` objektumot tartalmaz:

- `campaign`: a kampány `id` és `name` értéke (kampány-webhookok)
- `lead`: a lead űrlapmezői a mezőkulcsuk szerint (például `first_name`), valamint `id`, `phone_number` és `created_at`
- `lead.permissions`: minden hozzájárulási jelölőnégyzetnél, hogy elfogadták-e, a szöveg, a dátum és az IP-cím (kampány-webhookok)
- `participant`: a `channel`, ahonnan a személy érkezett, és a részvétel időpontja (kampány-webhookok)
- `quiz`: az elnevezett kvízkérdésekre adott válaszok, „Simple” kezdetű olvasható neveken is
- `prize`: a nyeremény `id`, `name`, `value`, `coupon_code` értéke és a nyerés időpontja (nyertes-webhookok)

Az üres értékek kimaradnak, ahogy a nem elfogadott hozzájárulások is. GET metódus esetén ugyanezeket az adatokat lekérdezési paraméterekként küldjük az URL-ben.

## Egyéni payload

Bekapcsolt **Egyéni payload** esetén csak az Ön által kiválasztott mezőket küldjük, `event` burkoló nélkül.

1. Az **Adatleképezés** résznél kattintson a **Leképezés hozzáadása** gombra.
2. Írja be a rendszere által várt **Mezőnevet**. Betűket, számokat, kötőjeleket és aláhúzásjeleket használhat.
3. Válassza ki a küldendő Scratcher-mezőt („Csoport → Mező”), vagy az **Egyéni érték** lehetőséget, és írjon be egy rögzített **Értéket**.
4. Ismételje meg minden mezőnél. Egy mezőt a kuka ikonnal távolíthat el (**Eltávolítás** vagy **Adatleképezés eltávolítása**).

## Az aláírás ellenőrzése

Ha megadott titkos kulcsot, minden kérés tartalmaz egy `X-Hub-Signature` fejlécet: `sha1=`, amelyet a JSON-kódolt payload (a fent leírt törzs) HMAC-SHA1 hash-e követ, kulcsként az Ön titkos kulcsát használva. Számítsa ki ugyanezt a saját oldalán, és hasonlítsa össze – így biztos lehet benne, hogy a kérés a Scratchertől érkezett.

## Kézbesítések és újrapróbálkozások

- Ha az URL nem válaszol, vagy hibát ad vissza (400-as vagy magasabb állapotkód), a Scratcher még kétszer próbálkozik: 5 másodperc és egy perc elteltével.
- Az átirányításokat nem követjük, ezért a végleges URL-t használja.
- Nyissa meg a kézbesítéseket (kampányban **Kézbesítések megtekintése**, fiók-webhookoknál **Kézbesítések megjelenítése**), hogy lássa az egyes kéréseket és válaszokat. Minden kézbesítésnél látható az **Azonosító**, a **Kérés** és a **Válasz** az állapotkóddal (valamint a **Válasz törzse**, ha naplózza). A **másolás** gombbal kimásolhatja a payloadot.
- Kapcsolja be a **Csak a sikertelen kézbesítések megjelenítése** opciót, hogy csak a problémákat lássa. Felül a „Sikertelen kézbesítések az elmúlt 60 napban” felirat látható.
- Kattintson az **Újrapróbálás** gombra egy kézbesítés ismételt elküldéséhez: „A webhook újraküldése folyamatban.”
- „A webhook-kézbesítési naplókat 60 napig őrizzük meg.”

## Hibaelhárítás

- „A(z) ... mezőnek HTTPS-t kell használnia.”: a **Payload URL** http-vel kezdődik. Használjon https-t.
- Minden kézbesítés válasz nélkül meghiúsul: az URL nem érhető el az internetről, például helyi vagy belső címről van szó. Használjon nyilvános URL-t.
- A rendszere nem kap adatot: a metódus **GET**, így az adatok az URL-ben vannak. Váltson **POST**-ra.
- Hiányzik egy mező, amelyet a rendszere vár: üres volt, vagy a hozzájárulást nem fogadták el. Állítsa be a rendszerét úgy, hogy a hiányzó mezőket üresként kezelje.

API, webhookok és MCP

- [Első lépések a REST API-val](https://scratcher.io/hu/help/developers/rest-api)
- [Adatok küldése saját rendszereibe webhookokkal](https://scratcher.io/hu/help/developers/webhooks)
- [Scratcher MCP a saját AI-eszközeihez](https://scratcher.io/hu/help/developers/mcp)

Tanuljon tovább

## Kapcsolódó cikkek

- [Első lépések a REST API-val](https://scratcher.io/hu/help/developers/rest-api): Hozzon létre személyes hozzáférési tokent a megfelelő jogosultsági körökkel, vagy regisztráljon OAuth-alkalmazást, és olvassa ki a kampányokat, leadeket és listákat saját rendszereiből.
- [Kézbesítési állapot ellenőrzése és leadek újraküldése](https://scratcher.io/hu/help/integrations/delivery-status): Nézze meg, mely leadek kerültek át az eszközeibe, értelmezze a hibaüzeneteket, javítsa a hibát, és küldje el őket újra.
- [Kapcsoljon össze több mint 8000 alkalmazást a Zapierrel](https://scratcher.io/hu/help/integrations/zapier): A Zapier segítségével az új Scratcher-regisztrációkat elküldheti a Google Sheetsbe, a Slackbe, a CRM-rendszerébe vagy több ezer más alkalmazásba.

Segítségre van szüksége?

## Még mindig segítségre van szüksége?

Valódi emberek segítenek. Ha már használja a Scratchert, a leggyorsabb út a platformon belüli csevegés.

- **[Csevegjen velünk](https://platform.scratcher.io/hu/login)**

    Jelentkezzen be, és kattintson a jobb alsó sarokban lévő csevegés gombra. Rex azonnal válaszol, csapatunk pedig egy kattintásnyira van.
- **[Megbeszélés foglalása](https://scratcher.io/hu/book-a-meeting)**

    Ingyenes, 30 perces videóhívás csapatunkkal: bemutató, kampányötletek vagy segítség a beállításban.
- **[Írjon nekünk e-mailt](mailto:contact@scratcher.io)**

    Írjon a contact@scratcher.io címre, és hamarosan válaszolunk.
