# Amazon End User Messaging összekötése

> Az Amazon End User Messaging (korábban Amazon SNS SMS) összekötése: IAM-felhasználó, hozzáférési kulcsok, feladószám és a FluentCRM beállításai.

Az Amazon End User Messaging (korábbi nevén Amazon SNS az SMS-hez) az Amazon Web Services (AWS) üzenetküldő szolgáltatása, amellyel nagy mennyiségben, megbízhatóan küldhetsz SMS-t. A FluentCRM-mel összekötve SMS-kampányokhoz és automatikus üzenetekhez használhatod.

Az összekötés négy részből áll:

1. dedikált IAM-felhasználó létrehozása az AWS-ben;
2. hozzáférési kulcsok létrehozása ehhez a felhasználóhoz;
3. telefonszám (feladó) beszerzése az AWS End User Messaging szolgáltatásban;
4. az adatok megadása a FluentCRM-ben.

## 1. lépés: dedikált IAM-felhasználó létrehozása

Ne a root AWS-fiókod adatait használd, hanem külön, korlátozott jogosultságú IAM-felhasználót. Ha a kulcsok mégis kiszivárognának, a kár így szűkebb marad.

1. Jelentkezz be az AWS Management Console-ba, a felső keresőmezőbe írd be: **IAM**, és válaszd az IAM szolgáltatást. Az **IAM Dashboard** a fiókod biztonsági áttekintését mutatja.
2. A bal oldali sávban az **Access Management** alatt kattints az **IAM users** pontra.
3. A jobb felső sarokban kattints a **Create user** gombra.
4. A **Specify user details** oldalon adj a felhasználónak beszédes nevet, például `aws_send_sms`. A **Provide user access to the AWS Management Console** jelölőnégyzetet hagyd üresen: a felhasználónak csak programozott hozzáférés kell. Kattints a **Next** gombra.
5. A **Set permissions** lépésben csatold az **AmazonSNSFullAccess** szabályzatot, vagy egy saját, minimális jogú szabályzatot, amely az `sms-voice:*` jogosultságra szól.
6. Fejezd be a további lépéseket, és kattints a **Create user** gombra. Zöld sáv jelzi, hogy a felhasználó létrejött, és az **IAM users** lista tetején megjelenik.

## 2. lépés: hozzáférési kulcsok létrehozása

A hozzáférési kulcsokkal azonosítja magát a FluentCRM az AWS felé. Az új IAM-felhasználó adatlapján hozod létre őket.

1. A felhasználó adatlapján nyisd meg a **Security credentials** lapot, és kattints a **Create access key** gombra.
2. Az AWS megkérdezi a használati esetet. Válaszd a **Third-party service** lehetőséget, pipáld be a megerősítést („I understand the above recommendation and want to proceed to create an access key”), és kattints a **Next** gombra. Ez a helyes választás, ha külső alkalmazásnak (itt a FluentCRM-nek) adsz hozzáférést.
3. Az opcionális leírás-címke lépés után az AWS megmutatja a **Retrieve access keys** képernyőt. A titkos hozzáférési kulcs **csak itt látszik teljes egészében**.
4. Másold ki az **Access key** oszlopban látható Access Key ID-t.
5. A **Secret access key** mellett kattints a **Show** gombra, majd másold ki a kulcsot, vagy a **Download .csv file** gombbal mentsd el mindkét kulcsot.
6. Kattints a **Done** gombra.

> **Fontos:** tárold biztonságos helyen a titkos hozzáférési kulcsot. Ha elveszted, nem kérheted vissza, új hozzáférési kulcsot kell létrehoznod.

## 3. lépés: telefonszám beszerzése az AWS End User Messagingben

A FluentCRM csak akkor tud SMS-t küldeni, ha az AWS End User Messagingben legalább egy feladó (telefonszám vagy Sender ID) be van jegyezve.

### Meglévő szám ellenőrzése

1. Az AWS konzolon keresd meg az **End User Messaging** szolgáltatást, vagy nyisd meg az **AWS End User Messaging → SMS → Phone numbers** oldalt.
2. Ellenőrizd, hogy a konzol jobb felső sarkában az a régió van-e kiválasztva, ahonnan küldeni akarsz (például Asia Pacific (Singapore)).
3. Ha már van szám a listában, kattints rá. A **Number status** legyen **Active**, a **Capabilities** között pedig szerepeljen az **SMS**.
4. A **Keywords** lapon láthatod a szám alapértelmezett leiratkozási (STOP) és súgó (HELP) kulcsszavait, amelyeket az AWS automatikusan beállít.

### Új feladó kérése

Ha nincs szám a listában, kattints a **Request originator** gombra. A varázsló négy lépésből áll:

1. **Select country:** válaszd ki azt az országot, ahová az üzeneteidet küldeni fogod (például United States (US)), majd **Next**.
2. **Define use case:** add meg a felhasználási esetet.
   - **Estimated monthly message volume:** a várt havi üzenetmennyiség (például More than 5000).
   - **Company headquarters:** **Local**, ha a cégednek az üzenetek célországában van a székhelye, különben **International**.
   - **Two-way SMS messaging:** **Yes**, ha válaszokat is fogadni akarsz, különben **No**.
   - **International sending:** **Yes**, ha több országba is küldesz, különben **No**.
3. **Select originator type:** nagy mennyiségű küldéshez az AWS a **Short code** típust ajánlja (SMS-t és MMS-t is támogat, regisztráció kell hozzá). Válaszd a **Short code - Recommended** lehetőséget, és nézd át a jobb oldali **Number details** panelt.
4. **Review and request:** nézd át az országot, a felhasználási esetet és a feladótípust, majd kattints a **Request** gombra.

> **Megjegyzés:** a short code regisztrációját az AWS és a mobilszolgáltatók jóváhagyása előzi meg. Teszteléshez használhatod a **Simulator** telefonszám-típust, amely azonnal elérhető.

### Sender ID (nem kötelező)

Egyes országokban használhatsz alfanumerikus feladóazonosítót (Sender ID), például `MyBrand`. Ez a címzett postaládájában a telefonszám helyett jelenik meg. A kezeléséhez nyisd meg az **AWS End User Messaging → SMS → Sender IDs** oldalt. Ha még nincs regisztrált azonosító, az oldal a „No Sender Id found” üzenetet mutatja. A **Request originator** gombbal kérhetsz egyet a támogatott országokra.

A Sender ID támogatása és a regisztrációs feltételek országonként eltérnek, ezért kérés előtt nézd meg az AWS leírását a célországodról.

## 4. lépés: a FluentCRM beállítása

1. Nyisd meg a **FluentCRM Pro → Beállítások → Üzenetküldés** oldalt.
2. Az **SMS** lapon kapcsold be az **SMS-modul bekapcsolása** kapcsolót.
3. Az **SMS-szolgáltató** szakaszban a **Válaszd ki az SMS-szolgáltatót** listából válaszd az **Amazon End User Messaging** értéket.
4. Töltsd ki a megjelenő mezőket.

![Az Amazon End User Messaging mezői az SMS lapon](./kepek/sms-amazon-mezok.webp)

*Az Amazon End User Messaging mezői az SMS lapon* (https://minta-bolt.hu/wp-admin/admin.php?page=fluentcrm-admin)

A képen a négy mező látszik: két kulcs, a régió választólistája és a **Küldési azonosító**.

| Mező | Mit írj bele |
|---|---|
| **AWS hozzáférési kulcs ID** | A 2. lépésben kimásolt Access Key ID |
| **AWS titkos hozzáférési kulcs** | A 2. lépésben kimásolt Secret Access Key |
| **AWS-régió** | Az a régió, ahol az End User Messaging telefonszámod be van állítva, például Asia Pacific (Singapore). A listából választasz, az alapérték az **USA keleti régiója (Észak-Virginia)**. |
| **Küldési azonosító** | A küldéshez használt telefonszám, feladóazonosító vagy készlet (pool) ID-ja vagy ARN-je az AWS End User Messagingből. Az AWS ezt kötelezővé teszi. |

> **Figyelem:** az **AWS-régió** pontosan egyezzen azzal a régióval, ahol a telefonszámod aktív az AWS End User Messagingben. Ha eltér, az üzenetek kézbesítése sikertelen lesz.

5. Kattints a jobb felső sarokban a **Mentés** gombra.

### Bejövő SMS-webhook

Mentés után a FluentCRM egyedi **Bejövő SMS-webhook** címet hoz létre az oldal alján. Ezt add meg az AWS End User Messaging beállításaiban, ha kézbesítési visszaigazolásokat vagy bejövő üzeneteket is fogadni szeretnél.

Ezzel az összekötés kész. Nagy mennyiségű SMS-kampányokhoz és automatizálásokhoz használhatod az AWS-t: lásd [SMS-kampányok](https://hub.hellowp.io/hu/plugins/fluentcampaign-pro/sms-kampanyok/), [SMS küldése automatizálásból](https://hub.hellowp.io/hu/plugins/fluentcampaign-pro/sms-automatizalas/) és [SMS-kampány jelentése](https://hub.hellowp.io/hu/plugins/fluentcampaign-pro/sms-kampany-jelentes/).