# Értesítési helyőrzők

> Hogyan szúrhatsz be foglalási, vásárlói és munkavállalói adatokat az e-mail, SMS és WhatsApp sablonokba, és mely helyőrzők érhetők el.

A helyőrzők a sablonokba írt kódok, amelyeket az Amelia a küldéskor a foglalás tényleges adataival helyettesít. Így nem kell kézzel szerkesztened minden üzenetet. Egy „Kedves %customer_full_name%” kezdetű sablonból például „Kedves Kovács Anna” lesz, amikor a vásárló befejezi a foglalást.

Ugyanazok a helyőrzők használhatók az e-mail, az SMS és a WhatsApp értesítésekben is. Egyes helyőrzők csak bizonyos licenccel érhetők el, főleg a csomagokhoz, a kosárhoz és a haladó eseményekhez tartozók, ezért éles levélben használat előtt ellenőrizd az elérhetőségüket.

## Hol találod a helyőrzőket?

A helyőrzők az **Amelia → Értesítések** oldal sablonszerkesztőjében vannak, közvetlenül a tárgy és az üzenet tartalma mező alatt. Kattints egy csoportra (például **Vásárló**), válaszd ki a kívánt elemet a listából, és az Amelia oda szúrja be, ahol a kurzor áll.

![A Vásárló csoport helyőrzői a tárgy alatt](./kepek/ertesitesek-helytartok.webp)

*A Vásárló csoport helyőrzői a tárgy alatt* (https://minta-bolt.hu/wp-admin/admin.php?page=wpamelia-notifications)

A csoportok: **Időpont**, **Vásárló**, **Alkalmazott**, **Szolgáltatás**, **Hely**, **Cég**, **Fizetés** és **Egyéni mezők**. Az időpontok és az események helyőrzői nagyrészt eltérnek, ezért mindig ellenőrizd, melyik sablonban dolgozol, mielőtt beszúrsz egy elemet. Ne használj eseményhelyőrzőt időpontsablonban, és fordítva.

## Hivatkozás-helyőrzők

A hivatkozást adó helyőrzőket, például a `%customer_panel_url%`, `%employee_panel_url%`, `%appointment_cancel_url%`, `%event_cancel_url%` helyőrzőt és a Zoom vagy más videóhívás hivatkozásait mindig helyőrzőként írd be, ne kész címként. Az Amelia biztonságos, tokent és paramétereket tartalmazó címet állít elő, amelyet kézzel nem lehet előállítani.

Ha szöveges hivatkozást szeretnél („Kattints ide az ügyfélfelület eléréséhez”), a hivatkozás címébe magát a helyőrzőt írd:

```html
<a href="%customer_panel_url%">Kattints ide</a>
```

Így az Amelia hozzáfűzi a belépéshez vagy a jelszó létrehozásához szükséges tokent, és a link mindig a megfelelő felületre visz. Ha egy videóhívás-helyőrző helyére kész címet másolsz, nem a megfelelő link jön létre.

## Vásárlónak szóló helyőrzők (időpontok)

Az egyértelmű adatokat (nevek, alapadatok) itt nem soroljuk fel.

| Helyőrző | Tartalma |
| --- | --- |
| `%appointment_cancel_url%` | Automatikusan előállított lemondási hivatkozás. |
| `%appointment_deposit_payment%` | Az időpontért befizetett előleg összege. |
| `%appointment_duration%` | A teljes időtartam: szolgáltatás, extrák és pufferidők együtt. |
| `%appointment_notes%` | Munkavállaló, vezető vagy adminisztrátor által az időponthoz írt megjegyzések. |
| `%appointment_price%` | Az időpont teljes ára a szolgáltatással, extrákkal és további személyekkel. |
| `%appointment_status%` | Az időpont állapota a vásárlónak. |
| `%category_name%` | A lefoglalt szolgáltatás kategóriája. |
| `%coupon_1%` … `%coupon_n%` | Kuponok adatai; a szerkesztőben az elem fölé víve látszik a kuponkód és a levonás. |
| `%custom_field_1%` … `%custom_field_n%` | A vásárlói egyéni mezők értékei. |
| `%customer_note%` | A vásárló profiljában mentett megjegyzés. |
| `%customer_panel_url%` | A vásárlói felület hivatkozása. |
| `%employee_note%` | A munkavállaló profiljában mentett megjegyzés. |
| `%google_meet_url%` | Google Meet hivatkozás. |
| `%lesson_space_url%` | Lessonspace hivatkozás. |
| `%recurring_appointments_details%` | Beállított blokk, amely felsorolja az összes lefoglalt ismétlődő időpontot. |
| `%service_duration%` | Csak a fő szolgáltatás időtartama. |
| `%service_extra_1_name%` … `%service_extra_n_name%` | A hozzáadott extrák nevei. |
| `%service_extra_1_price%` | Egy extra ára. |
| `%service_extra_1_quantity%` | Egy extra mennyisége. |
| `%service_extras%` | A kiválasztott extrák összesített listája. |
| `%time_zone%` | Az időpont megjelenítéséhez használt időzóna. |
| `%zoom_join_url%` | A vásárló Zoom-csatlakozási hivatkozása. |
| `%payment_link_stripe%`, `%payment_link_paypal%`, `%payment_link_mollie%`, `%payment_link_razorpay%`, `%payment_link_woocommerce%` | Fizetési hivatkozás az adott szolgáltatóhoz. |

## Vásárlónak szóló helyőrzők (események)

| Helyőrző | Tartalma |
| --- | --- |
| `%attendee_code%` | A vásárlóhoz rendelt résztvevői kód. |
| `%event_cancel_url%` | Az eseményjelentkezés lemondási hivatkozása. |
| `%event_period_date%` | Az esemény dátumtartománya, ha több napon át tart. |
| `%event_period_date_time%` | A többnapos esemény teljes dátum- és időtartománya. |
| `%event_tickets%` | A lefoglalt jegyek száma. |
| `%lesson_space_url_date%` | Lessonspace hivatkozás, csak a dátummal. |
| `%lesson_space_url_date_time%` | Lessonspace hivatkozás dátummal és idővel. |
| `%zoom_join_url_date%` | Zoom-csatlakozási hivatkozás, csak a dátummal. |
| `%zoom_join_url_date_time%` | Zoom-csatlakozási hivatkozás dátummal és idővel. |
| `%google_meet_url%` | A résztvevőnek létrehozott Google Meet hivatkozás. |
| `%payment_link_stripe%`, `%payment_link_paypal%`, `%payment_link_mollie%`, `%payment_link_razorpay%`, `%payment_link_woocommerce%` | Fizetési hivatkozás az adott szolgáltatóhoz. |

## Munkavállalónak szóló helyőrzők (időpontok)

| Helyőrző | Tartalma |
| --- | --- |
| `%booked_customer%` | Csak a legutóbb foglaló vásárló neve, e-mail-címe és telefonszáma; csoportos időpontoknál hasznos. |
| `%coupon_used%` | A vásárló neve, a felhasznált kuponkód és a kapott kedvezmény. |
| `%employee_panel_url%` | Biztonságos hivatkozás a munkatársi felületre. |
| `%group_appointment_details%` | Beállított blokk, amely felsorolja a csoportos időpont összes résztvevőjét. |
| `%zoom_host_url%` | A házigazda munkavállaló Zoom-hivatkozása. |

## Munkavállalónak szóló helyőrzők (események)

| Helyőrző | Tartalma |
| --- | --- |
| `%zoom_host_url_date%` | Zoom-házigazda hivatkozás, csak az esemény dátumával. |
| `%zoom_host_url_date_time%` | Zoom-házigazda hivatkozás dátummal és idővel. |

## Tanácsok

- Beszúrás előtt győződj meg róla, hogy a helyőrző a megfelelő csoportba tartozik.
- A bonyolultabb helyőrzőket (ismétlődő időpontok részletei, csoportos időpont részletei) előbb állítsd be, és csak utána tedd a sablonba.
- Próbafoglalással ellenőrizd, hogy a helyőrzők helyesen cserélődnek le.
- Ne írj be kézzel vásárlói vagy munkavállalói adatokat: használj helyőrzőt.
- Ne töröld ki azokat a helyőrzőket, amelyektől a felületre belépés vagy a lemondás működése függ.