# Webhookok

> Foglalási adatok valós idejű küldése külső rendszereknek: a funkció bekapcsolása, webhook létrehozása, típusok, műveletek és korlátozások.

A webhookokkal az Amelia valós időben küldi a foglalási adatokat külső rendszerekbe, amikor egy foglalással kapcsolatos esemény történik. Így kézi munka nélkül automatizálhatsz folyamatokat. Ha például egy vásárló lefoglal egy szolgáltatást, az Amelia azonnal elküldheti az adatokat a CRM-edbe, egy táblázatba vagy egy automatizálási platformra, hogy a csapatod rögtön reagálhasson. A funkció a Standard, a Pro és az Elite licencben érhető el.

## Bekapcsolás és megnyitás

1. Nyisd meg az **Amelia → Funkciók és integrációk → Funkciók** oldalt.
2. A **Webhookok** kártyán kattints a **Bekapcsolás** gombra. Utána megjelenik a **Beállítás** és a **Kikapcsolás** gomb.
3. A **Beállítás** gombbal nyisd meg a webhookok oldalát.

![A Webhookok beállítóoldala a + Webhook gombbal](./kepek/integraciok-webhookok-lista.webp)

*A Webhookok beállítóoldala a + Webhook gombbal* (https://minta-bolt.hu/wp-admin/admin.php?page=wpamelia-features-integrations)

## Új webhook létrehozása

A **+ Webhook** gombbal nyílik meg a **Webhook hozzáadása** ablak. Mind a négy mezőt ki kell tölteni, mielőtt mentenél.

![A Webhook hozzáadása ablak](./kepek/integraciok-webhookok-uj.webp)

*A Webhook hozzáadása ablak* (https://minta-bolt.hu/wp-admin/admin.php?page=wpamelia-features-integrations)

| Mező | Mit csinál |
|---|---|
| **Név** | Csak az Amelián belüli azonosításra szolgál. |
| **URL** | A nyilvánosan elérhető cím, amely megkapja az adatokat. |
| **Típus** | Azt adja meg, hogy időpont-, csomag- vagy eseményadatokat küld-e. |
| **Művelet** | Azt adja meg, pontosan milyen változás indítja a webhookot. |

### Típusok

Egy webhookhoz csak egy típus tartozhat, ez dönti el, milyen foglalási adatokat küld az Amelia:

- **Időpont**: a szolgáltatásalapú foglalások adatai;
- **Csomag**: a csomagvásárlások és a csomagok használatának adatai;
- **Esemény**: az eseményfoglalások és a részvétel adatai.

### Műveletek

A művelet azt a pillanatot adja meg, amikor az Amelia elküldi az adatokat a külső rendszernek:

- **Foglalás hozzáadva**: új foglalás létrejöttekor;
- **Foglalás átütemezve**: ha a dátum vagy az időpont megváltozik;
- **Foglalás lemondva**: ha a foglalást lemondják;
- **Foglalás állapota megváltozott**: ha a foglalás állapota módosul.

## Milyen adatot küld a webhook

Az adatcsomag tartalmazza a foglalás azonosítóit, a vásárló adatait, az időpontot és a dátumot, valamint a szolgáltatás, a csomag vagy az esemény adatait, a kiválasztott típustól és művelettől függően.

## Korlátozások

A webhookok csak egy irányba működnek: adatot küldenek, de nem fogadnak külső adatot, nem szabályozzák az elérhetőséget, nem szinkronizálnak naptárat és nem dolgoznak fel fizetést. Az időpontkezelés és a fizetés teljes logikáját továbbra is az Amelia kezeli.

Egy webhook csak egy típust és egy műveletet támogat. Ha több eseményre is szeretnél értesítést, minden típus és művelet párosnak külön webhookot kell létrehoznod.

## Mire figyelj

- Mindig nyilvánosan elérhető URL-t használj, amely fogad külső kéréseket.
- Minden típus és művelet kombinációhoz külön webhookot hozz létre.
- Ne támaszkodj a webhookokra fizetés ellenőrzéséhez vagy az elérhetőség szabályozásához.
- A fogadó rendszernek fel kell tudnia dolgozni a beérkező foglalási adatokat.