# Meta Cloud API összekötése

> Meta-alkalmazás létrehozása, a hitelesítő adatok összegyűjtése, állandó token készítése és a webhook beállítása a WhatsApp-küldéshez.

A Meta Cloud API a WhatsApp hivatalos küldőplatformja, a Meta üzemelteti. Az összekötéssel a FluentCRM WhatsApp-üzenetet tud küldeni a kapcsolattartóknak, és a válaszaik is visszajutnak a CRM-be.

A menet: létrehozol egy alkalmazást a Meta fejlesztői felületén, kimásolsz belőle négy adatot, beírod őket a FluentCRM-be, majd a Meta webhookját a saját oldaladra irányítod. Az első alkalommal számolj nagyjából 15 perccel.

Mielőtt nekilátsz, kell egy Facebook-fiók és egy Meta Business Portfolio. Ha még nincs portfóliód, az 1. lépésben létrehozhatsz egyet.

> A Meta felületei angolul vannak, és időnként változnak. Az alábbi menüneveket így hagytuk meg, ahogy a Metánál látod.

## 1. lépés: Meta-alkalmazás létrehozása

1. Nyisd meg a Meta fejlesztői fiókodat (Meta for Developers), és az alkalmazások oldalán kattints a **Create App** gombra.
2. Megjelenik egy felugró ablak a Meta új alkalmazásrendszeréről. Kattints a **Create app** gombra a folytatáshoz.
3. Add meg az **App name** mezőben az alkalmazás nevét, majd kattints a **Next** gombra.
4. A **Use cases** lépésben válaszd a **Connect with customers through WhatsApp** lehetőséget, majd **Next**.
5. Válaszd ki az üzleti portfóliódat. Ha nincs, kattints a **Create a business portfolio** gombra.
6. Mást nem kell megadnod: az **Overview** lépésben kattints a **Create app** gombra.

## 2. lépés: a Customize panel megnyitása

Az alkalmazás létrehozása után a **Use cases** oldalra érkezel. A WhatsApp használati esetnél kattints a **Customize** gombra. A hitelesítő adatok nagy része ebben a panelben van.

## 3. lépés: a hitelesítő adatok összegyűjtése

Menj a **Basic setup → Step 1. Try it out** részhez. Ezen az egy képernyőn megvan a négyből három érték.

A **Claim a WhatsApp test number** alatt látod a próbaszámot, mellette:

- **Phone Number ID**: számjegyes azonosító, nem maga a telefonszám. Ez kerül a FluentCRM **Telefonszám ID** mezőjébe.
- **WhatsApp Business Account ID**: az üzenetsablonokat birtokló fiók azonosítója. Ez a **WhatsApp Business-fiók ID** mezőbe kerül.

Lejjebb, az **Access token** szakaszban kattints a **Generate new token** gombra, és másold ki a tokent. Mindhármat tedd a vágólapra vagy egy jegyzetbe, mert mindjárt be kell illesztened őket a FluentCRM-be.

Ha a próbaszám helyett már a saját üzleti számodat regisztráltad, az azonosítókat itt találod: a **Phone Number ID** az **Other tools → Tools → Manage phone numbers** alatt, a **WhatsApp Business Account ID** a Meta Business Settings **Accounts → WhatsApp accounts** oldalán.

## 4. lépés: az alkalmazás titkos kulcsa

Menj az **App settings → Basic** oldalra. Az **App secret** mellett kattints a **Show** gombra, és másold ki az értéket. Ez kerül a FluentCRM **Alkalmazás titkos kulcsa** mezőjébe: ezzel ellenőrzi a FluentCRM, hogy a webhookot valóban a Meta küldte.

## 5. lépés: állandó hozzáférési token

A **Generate new token** gombbal kapott token ideiglenes: lejár, és vele együtt megszakad a kapcsolat. Tesztelésre jó, de éles oldalhoz a Meta rendszerfelhasználójának állandó tokenje kell. Ezt kéri az **Állandó hozzáférési token** mező.

Így készítsd el:

1. A Meta Business Settingsben nyisd meg a **Users → System users** oldalt, és kattints az **Add** gombra.
2. Add meg a rendszerfelhasználó nevét (**System user name**), állítsd be a szerepét (**System user role**), majd kattints a **Create system user** gombra.
3. Adj hozzáférést a rendszerfelhasználónak az alkalmazáshoz: a **Business assets** oldalon válaszd ki az alkalmazást, és kattints az **Assign people** gombra.
4. Menj vissza a rendszerfelhasználóhoz, és ellenőrizd, hogy az alkalmazás **Full access** jogosultsággal szerepel az **Assigned assets** alatt. Ezután kattints a **Generate token** gombra.
5. Válaszd ki az alkalmazást, állítsd be a lejáratot, az **Assign permissions** alatt jelöld be a `whatsapp_business_management` és a `whatsapp_business_messaging` jogosultságot is, majd kattints a **Generate token** gombra.
6. Másold ki a tokent, és illeszd be a FluentCRM **Állandó hozzáférési token** mezőjébe, az ideiglenes helyett.

> **Figyelem:** a Meta a tokent csak egyszer mutatja meg. Azonnal másold be a FluentCRM-be: ha a párbeszédablakot a másolás előtt bezárod, újat kell készítened.

## 6. lépés: az adatok megadása a FluentCRM-ben

1. A WordPressben nyisd meg a **FluentCRM Pro → Beállítások → Üzenetküldés** oldalt.
2. Kapcsold be az **Üzenetküldő modul bekapcsolása** kapcsolót.
3. A **WhatsApp** lapon kapcsold be a **WhatsApp-modul bekapcsolása** kapcsolót.
4. A **Válaszd ki a WhatsApp-szolgáltatót** listában válaszd a **Meta Cloud API (WhatsApp Business)** elemet.
5. Illeszd be az értékeket a megfelelő mezőbe: **WhatsApp Business-fiók ID**, **Telefonszám ID**, **Állandó hozzáférési token**, **Alkalmazás titkos kulcsa**.
6. A **Webhook-ellenőrző token** mezőbe írj be egy általad választott titkos szöveget, például `crmwapp`. Jegyezd fel, mert a következő lépésben a Metánál pontosan ugyanezt kell megadnod.
7. Kattints a **Mentés** gombra.

![A Meta Cloud API beállításai mentés után, a webhook-címmel](./kepek/whatsapp-meta-beallitas.webp)

*A Meta Cloud API beállításai mentés után, a webhook-címmel* (https://minta-bolt.hu/wp-admin/admin.php?page=fluentcrm-admin)

Mentés után az oldal alján megjelenik a **Webhook URL**. Másold ki, mert a következő lépéshez kell.

## 7. lépés: a webhook létrehozása

Menj vissza a Meta-alkalmazásodhoz, és nyisd meg az **Other tools → Tools** oldalt. Keresd meg a **Webhooks** eszközt a **Configuration** alatt, és kattints a **Configure webhooks** gombra. Az oldalon:

1. A FluentCRM-ből kimásolt **Webhook URL**-t illeszd be a **Callback URL** mezőbe.
2. A **Verify token** mezőbe írd be a 6. lépésben megadott **Webhook-ellenőrző token** szöveget, pontosan ugyanúgy.
3. Kattints a **Verify and save** gombra.
4. A **Webhook fields** alatt iratkozz fel a kívánt mezőkre. Legalább a `messages` mezőre iratkozz fel, hogy a válaszok és a kézbesítési állapotok eljussanak a FluentCRM-be.

Ezzel kész az összekötés.

> **Figyelem:** amíg a Meta-alkalmazásod nincs közzétéve, a Meta csak az alkalmazás irányítópultjáról küldött tesztwebhookokat kézbesíti. Éles adatok előtt tedd közzé az alkalmazást.

## Éles használatra állás

A próbaszám korlátozott, és csak azoknak a címzetteknek tud üzenni, akiket kézzel adtál hozzá. Ha a valódi közönségedet is el akarod érni, a Meta felületén végezd el a hátralévő lépéseket:

- **Step 2. Production setup**: a saját üzleti telefonszámod regisztrálása feladóként.
- **Step 3. Business verification**: az üzleti portfóliód ellenőrzése a Metánál.
- Fizetési mód megadása (**Add a payment method**): amíg nincs, csak az ügyfeleid által indított beszélgetések ingyenesek, és te nem indíthatsz üzenetet.

## Következő lépések

- [A WhatsApp-modul beállítása](https://hub.hellowp.io/hu/plugins/fluentcampaign-pro/whatsapp-modul-beallitasa/)
- [WhatsApp-sablonok](https://hub.hellowp.io/hu/plugins/fluentcampaign-pro/whatsapp-sablonok/)