# WhatsApp értesítések

> A WhatsApp-integráció bekapcsolása, a Meta-sablonok összekötése az Amelia helyőrzőivel és az automatikus válaszüzenet beállítása.

Ha azt szeretnéd, hogy a vásárlók SMS vagy e-mail helyett WhatsApp-visszaigazolást vagy emlékeztetőt kapjanak, az Amelia automatikus WhatsApp-üzeneteket küldhet a csatlakoztatott WhatsApp Business fiókon át. A WhatsApp-integráció a Pro és az Elite licencben érhető el.

## Mit tud, és mit nem?

Az Amelia a Meta WhatsApp Cloud API-ján át küld időpont- és eseményüzeneteket: visszaigazolást, átütemezést, emlékeztetőt, lemondást és utánkövetést. Az üzenetek az e-mailhez és az SMS-hez hasonlóan működnek, de minden üzenet egy, a Meta Business Managerben létrehozott és jóváhagyott sablonra épül. A Metában létrehozott sablonok változóit az Amelia megfelelő helyőrzőihez kell kapcsolnod.

A WhatsApp csak értesítésre használható:

- Az üzenet teljes tartalma a jóváhagyott sablonból jön. Az Amelia nem küldhet szabad szöveget vagy egyedi választ.
- Nincs kétirányú kommunikáció: ha a vásárló válaszol, a válasz nem jelenik meg az Ameliában.
- Csak egy automatikus válaszüzenet állítható be. Ezt az Amelia minden WhatsApp-üzenetre érkező válasz után elküldi.
- A sablon nyelvének egyeznie kell az Amelia értesítéseinél beállított nyelvvel. Ha a nyelvek nem egyeznek, az üzenet nem megy ki.

## A WhatsApp-integráció bekapcsolása

1. Nyisd meg az **Amelia → Funkciók és integrációk** oldalt, és válaszd az **Integrációk** fület.
2. A **WhatsApp** kártyán kattints a **Bekapcsolás** gombra.
3. Bekapcsolás után megjelenik a **Beállítás** gomb, amely a WhatsApp beállítóoldalra visz. Ugyanez az oldal elérhető az **Amelia → Beállítások → Értesítések → WhatsApp** menüponton át is.

![A WhatsApp-integráció beállítóoldala](./kepek/ertesitesek-whatsapp-integracio.webp)

*A WhatsApp-integráció beállítóoldala* (https://minta-bolt.hu/wp-admin/admin.php?page=wpamelia-features-integrations)

A beállítóoldalon a következő mezőket kell kitöltened. Az értékeket a Meta-oldali beállítás során kapod meg.

| Beállítás | Mit kell ide írni |
| --- | --- |
| **Telefonszám ID-ja** | A WhatsApp Business telefonszám azonosítója. |
| **Állandó hozzáférési token** | A Metában létrehozott állandó hozzáférési token. |
| **WhatsApp üzleti fiók ID** | A WhatsApp Business fiók azonosítója. |
| **Alapértelmezett nyelv** | A sablonok alapértelmezett nyelve. |

Amíg ezek a mezők üresek, az Amelia nem tud WhatsApp-értesítést küldeni, és az **Amelia → Értesítések** oldal **WhatsApp** füle azt mutatja, hogy **A WhatsApp nincs csatlakoztatva**.

![A WhatsApp fül az Értesítések oldalon, csatlakoztatás előtt](./kepek/ertesitesek-whatsapp-ful.webp)

*A WhatsApp fül az Értesítések oldalon, csatlakoztatás előtt* (https://minta-bolt.hu/wp-admin/admin.php?page=wpamelia-notifications)

A három azonosító (**Telefonszám ID-ja**, **Állandó hozzáférési token**, **WhatsApp üzleti fiók ID**) ugyanahhoz a WhatsApp Business fiókhoz tartozzon a Meta fejlesztői felületén. Mentéskor az Amelia ellenőrzi a megadott adatokat: ha érvénytelenek, a beállítások nem menthetők, így biztos lehetsz benne, hogy az értesítések kézbesítve lesznek.

A **WhatsApp** fül az **Amelia → Beállítások → Értesítések** alatt csak akkor jelenik meg, ha az integrációt bekapcsoltad a **Funkciók és integrációk → Integrációk** oldalon. Ha az integráció ki van kapcsolva, az Amelia nem küld WhatsApp-értesítést, akkor sem, ha a sablonok már be voltak állítva.

Az **Alapértelmezett nyelv** határozza meg, mely sablonok választhatók az értesítések beállításakor: a háttérfelületen csak az alapértelmezett nyelven létrehozott sablonok jelennek meg. Ha a vásárló olyan nyelven kap értesítést, amelyhez nincs sablon, az Amelia az alapértelmezett nyelvű változatot küldi.

## Beállítás a Metában

A WhatsApp Cloud API beállításához Meta fejlesztői fiók és WhatsApp Business fiók kell. A végén három értéket kapsz: a telefonszám azonosítóját, a WhatsApp üzleti fiók azonosítóját és az állandó hozzáférési tokent.

### Meta-alkalmazás létrehozása

1. Nyisd meg a Meta for Developers felületét, és jelentkezz be a Facebook- vagy céges fiókoddal.
2. Kattints jobb felül a **My Apps** (Alkalmazásaim) pontra. Ha először használod, a rendszer fejlesztői fiók létrehozására kér, azt végezd el.
3. Kattints a **Create App** gombra, és add meg az alkalmazás nevét.
4. A felhasználási esetnél válaszd az **Other** lehetőséget, a következő lépésben az alkalmazás típusának a **Business** típust.
5. Erősítsd meg az alkalmazás nevét és az e-mail-címet, majd kattints a **Create app** gombra.
6. A Facebook-jelszavad megadása után a Meta az alkalmazás vezérlőpultjára visz.

### A WhatsApp termék hozzáadása

1. A vezérlőpulton keresd meg a **WhatsApp** kártyát, és kattints a **Set up** gombra. A Meta ilyenkor összekapcsol egy WhatsApp Business fiókot, vagy létrehoz egyet.
2. Ha az üzleti fiók ki van választva, kattints a **Start using the API** gombra. A **WhatsApp → API Setup** oldalon látod az Ameliához szükséges adatokat: a telefonszám azonosítóját, a WhatsApp üzleti fiók azonosítóját és egy ideiglenes hozzáférési tokent.
3. Az üzleti fiók azonosítóját másold ki. A telefonszám azonosítója itt a Meta által generált tesztszámé: **ezt ne másold ki**, és az ideiglenes tokent sem használja az Amelia éles működéshez.

### Üzleti telefonszám hozzáadása és ellenőrzése

1. A Quickstart oldalon görgess lejjebb, és kattints az **Add phone number** gombra.
2. Add meg az üzleted nevét, e-mail-címét, weboldalát, országát, időzónáját, kategóriáját és leírását.
3. Add meg a WhatsApp-üzenetküldéshez használt telefonszámot. Ha vezetékes szám, az ellenőrző kódot telefonhívással kérd (**Phone call**).
4. Add meg a Meta által küldött ellenőrző kódot. Utána a szám aktív a WhatsApp Business fiókodban.
5. Az API Setup oldalon a **From** részben most a frissen regisztrált számnak kell szerepelnie (ha nem, nyisd le a listát). Innen másold ki a **Phone number ID** értékét, és illeszd be az Ameliába.

**Fontos:** olyan telefonszámot nem használhatsz, amely már személyes vagy üzleti WhatsApp-fiókhoz tartozik, hacsak nem vagy kész eltávolítani az összes eszközről. Ha a szám már aktív a WhatsAppon, az összekötés leválasztja a mobilkészülékről, és Cloud API-számmá alakítja. Ezért új telefonszámot vagy a WhatsApp-értesítésekre fenntartott üzleti vezetékes számot érdemes használni.

### Tesztüzenet (nem kötelező)

A Meta tesztkörnyezete ideiglenes számot és tokent ad. Felveheted a saját számodat a tesztlistára, és küldhetsz tesztüzenetet. Ez nem szükséges az Ameliához, mert a tesztszámok éles használatra nem alkalmasak. Az Ameliához a telefonszám azonosítója, az üzleti fiók azonosítója és az állandó hozzáférési token kell.

### Állandó hozzáférési token létrehozása

1. Nyisd meg a Meta Business Settings felületét, és menj a **Users → System users** oldalra. Hozz létre egy új rendszerfelhasználót admin szereppel.
2. Az **Add Assets** résszel rendeld hozzá a korábban létrehozott Meta-alkalmazást a rendszerfelhasználóhoz.
3. Az **Accounts → WhatsApp accounts** alatt rendeld hozzá ugyanezt a rendszerfelhasználót **Full control** (teljes hozzáférés) jogosultsággal.
4. Térj vissza a **System users** oldalra, és kattints a **Generate new token** gombra.
5. Válaszd ki az alkalmazást a legördülő listából, és kapcsold be a két jogosultságot: `whatsapp_business_messaging` és `whatsapp_business_management`.
6. Kattints a **Generate token** gombra. Másold ki a tokent, és tárold biztonságosan, mert a Meta az ablak bezárása után már nem mutatja meg újra.

### Az értékek beillesztése az Ameliába

1. Nyisd meg az **Amelia → Funkciók és integrációk → Integrációk → WhatsApp → Beállítás** oldalt.
2. Illeszd be a **Telefonszám ID-ja**, az **Állandó hozzáférési token** és a **WhatsApp üzleti fiók ID** mezőbe a megfelelő értékeket.
3. Válaszd ki az **Alapértelmezett nyelv** értéket úgy, hogy egyezzen a WhatsApp-sablonjaidban megadott nyelvvel.
4. Mentsd a beállításokat.

Ezzel az Amelia össze van kötve a WhatsApp Business API-val. A következő lépés a sablonok beállítása.

## WhatsApp-sablonok

A WhatsApp sablonalapú rendszer, ezért minden Ameliából küldött értesítéshez előre jóváhagyott Meta-sablon kell. A sablonokban változók ({{1}}, {{2}} …) vannak, és mindegyiket egy Amelia-helyőrzőhöz kell kötnöd, hogy a megfelelő időpont- vagy eseményadat kerüljön az üzenetbe. A sablonok hozzárendelése az **Amelia → Értesítések → WhatsApp** fülön történik.

### Sablon létrehozása a Metában

1. Nyisd meg a Meta Business Manager WhatsApp Managerét.
2. Válaszd a **Message Templates** pontot, és kattints a **Create template** gombra.
3. A kategória legyen **Utility**, a típus **Default**, majd kattints a **Next** gombra.
4. A sablonszerkesztőben add meg a sablon nevét, a nyelvét és a tartalmát.
5. A sablon állhat fejlécből, törzsből és láblécből, a változók formája {{1}}, {{2}}, {{3}}. Minden részben (fejléc, törzs, lábléc) külön számozod a változókat, tehát ha a fejlécben már használtad az {{1}}-et, a törzsben újra kell használnod.
6. Görgess lejjebb, és adj meg a sablonhoz kontextust. A jobb oldalon látod az üzenet előnézetét.
7. Kattints a **Submit for review** gombra. A WhatsApp ellenőrzése általában körülbelül egy órát vesz igénybe.

A jóváhagyott sablon zöld, **Active - Quality pending** állapotot mutat, az ellenőrzés alatt álló szürke, **In review** állapotú. A sablon neve csupa kisbetű legyen szóköz nélkül. Ha nagybetűt vagy szóközt írsz, a Meta automatikusan kisbetűre, illetve aláhúzásra cseréli.

### Mi kerüljön a sablonba?

A legfontosabb a törzs, ahová a változók kerülnek. A fejléc nem kötelező. Egy példa törzs: „Hello {{1}}, Your appointment is scheduled for {{2}}”. Az {{1}} változót kötheted a `%customer_full_name%` helyőrzőhöz, a {{2}}-t a `%appointment_start_date_time%` helyőrzőhöz. A sablon nyelve egyezzen az Amelia WhatsApp-beállításaiban megadott **Alapértelmezett nyelv** értékkel.

### Sablon hozzárendelése egy Amelia-értesítéshez

1. Nyisd meg az **Amelia → Értesítések** oldalt, és váltsd a **WhatsApp** fülre.
2. Válaszd ki azt az értesítést, amelyet WhatsApppon szeretnél küldeni.
3. A legördülő listából válaszd ki a jóváhagyott WhatsApp-sablont.
4. A sablon minden változójához válaszd ki a jobb oldali legördülő listából a megfelelő Amelia-helyőrzőt (például `%customer_full_name%`, `%service_name%`, `%appointment_start_date_time%`).
5. Mentsd a változtatásokat.

Az Amelia küldéskor automatikusan behelyettesíti a helyőrzőket a foglalás adataival.

### Nyelvek

A Metában minden sablon egy adott nyelven készül. Az Amelia WhatsApp-beállításainál (**Funkciók és integrációk → Integrációk → WhatsApp → Beállítás**) megadott **Alapértelmezett nyelv** egyezzen egy olyan nyelvvel, amelyre van Meta-sablonod. Ha a nyelvek nem egyeznek, a WhatsApp API elutasítja az üzenetet, és az értesítés nem megy ki. Többnyelvű webhelyen minden használt nyelvhez hozz létre sablonváltozatot.

### Ellenőrzés

Ha minden be van állítva, nyisd meg bármelyik WhatsApp-os értesítést az Ameliában, és kattints a sablon alatt, a bal alsó sarokban lévő tesztküldés ikonra. Az Amelia a kiválasztott sablonnal és helyőrzőkkel próbaüzenetet küld. Ha sikerül, jó a beállítás. Ha nem, ellenőrizd a sablon nyelvét, a változók hozzárendelését és a WhatsApp-beállításoknál megadott értékeket.

## Automatikus válaszüzenet

A WhatsApp-üzenetekre nem lehet válaszolni az Ameliában, ezért a vásárlók válaszai nem jutnak vissza hozzá. Hogy ne maradjanak megválaszolatlanul, bekapcsolhatod az automatikus válaszüzenetet: ez egy előre megadott üzenetet küld mindenkinek, aki válaszol. Az üzenethez az Amelia egy webhookot ad, és a Meta egy ellenőrző tokent kér az aktiválásához. A WhatsAppban érkező válaszok nem láthatók az Ameliában.

### Bekapcsolás

1. Nyisd meg a **Funkciók és integrációk → Integrációk → WhatsApp → Beállítás** oldalt, és görgess lejjebb.
2. Kapcsold be az **Automatikus válaszüzenet bekapcsolása** kapcsolót.
3. A **WhatsApp automatikus válaszüzenet** mezőbe írd be a válasz szövegét. Használhatsz helyőrzőket, például `%customer_full_name%` vagy `%company_phone%`, hogy személyes legyen az üzenet.

![Az automatikus válaszüzenet és a webhook adatai](./kepek/ertesitesek-whatsapp-automatikus-valasz.webp)

*Az automatikus válaszüzenet és a webhook adatai* (https://minta-bolt.hu/wp-admin/admin.php?page=wpamelia-features-integrations)

A képen a **WhatsApp webhook ellenőrző token** mező, a kapcsoló, az üzenetmező és alul a **WhatsApp webhook visszahívási URL** látszik. Az üzenet minden vásárlói válasz után egyszer megy ki, függetlenül attól, melyik értesítésre válaszoltak. Ha egy vásárló többször válaszol, minden alkalommal megkapja az automatikus választ.

### Webhook ellenőrző token

A **WhatsApp webhook ellenőrző token** egy azonosító, amelyet az Amelia hoz létre. A Meta az ellenőrzés során ezzel győződik meg arról, hogy a visszahívási URL a tiéd. Másold ki ugyanerről a beállítóoldalról, és illeszd be a Meta-alkalmazásba a webhook aktiválásakor.

### Visszahívási URL

A **WhatsApp webhook visszahívási URL** a beállítóoldal alján látszik. A Meta ide továbbítja a vásárlók válaszait, hogy az Amelia elküldhesse az automatikus választ. Másold ki pontosan úgy, ahogy látod. Az Ameliában a bekapcsolt automatikus válaszon túl nem kell semmit módosítanod a webhook működéséhez.

### Webhook aktiválása a Metában

1. Nyisd meg a Meta Developer Console alkalmazásait, és válaszd ki a WhatsApp-alkalmazásodat.
2. Menj a **WhatsApp → Configuration** oldalra, keresd meg a webhook részt, és állítsd be a webhookot, vagy kattints az **Edit** gombra, ha már van.
3. Illeszd be az Amelia visszahívási URL-jét a **Callback URL** mezőbe.
4. Illeszd be az ellenőrző tokent a **Verify token** mezőbe.
5. Mentsd a változásokat, majd kattints a **Verify and save** gombra.

Az ellenőrzés után a webhook aktív, és az automatikus válaszüzenet működni kezd.

### Hogyan működik?

Ha egy vásárló válaszol egy Ameliából küldött WhatsApp-értesítésre, a Meta továbbítja a választ a visszahívási URL-re. Az Amelia megkapja az üzenetet, és azonnal elküldi az előre megadott automatikus választ. A válasz csak egyszer megy ki egy üzenetre, és nem folytat beszélgetést.

### Mit érdemes és mit nem?

- Írj egyértelmű útmutatást, például kérd meg a vásárlót, hogy hívjon vagy írjon e-mailt, ha segítség kell.
- Használj helyőrzőket a személyes hangvételhez.
- Tartsd rövidre a szöveget.
- Ne várj kétirányú beszélgetést az Ameliában.
- Ne használj jóvá nem hagyott tartalmat vagy nem támogatott karaktereket.
- Ne állíts be a WhatsApp-sablonétól eltérő nyelvet.

Az automatikus válasz mezőjében a kapcsoló bekapcsolásakor előre kitöltött, angol nyelvű szöveg áll. Írd át a saját, magyar szövegedre.

## Tanácsok

- Figyeld a WhatsApp-kapcsolat állapotát: az üzenetek leállnak, ha a Meta-összeköttetés megszakad.
- A WhatsApp-üzenetek legyenek rövidebbek, mint az e-mailek.
- Csatornaváltás vagy domainváltás után próbáld ki újra a tesztküldéssel.