# CleverReach és Constant Contact

> A CleverReach és a Constant Contact (V3) összekötése a Fluent Formsszal: OAuth-alkalmazás, kulcsok, engedélyezés és feedek.

Mindkét szolgáltatás OAuth-alapú kapcsolatot használ, ezért a kulcsok megadása után egy engedélyezési lépés is következik. Az integrációk a Fluent Forms Pro részei, alapból ki vannak kapcsolva (lásd az [Integrációk áttekintése](https://hub.hellowp.io/hu/plugins/fluentform-signature/integraciok-attekintes/) fejezetet).

## CleverReach

A CleverReach-integrációval az űrlap beküldői a CleverReach feliratkozói listájára kerülnek.

### A kliens ID és a titkos kulcs megszerzése

1. Jelentkezz be a CleverReachbe, a jobb felső sarokban kattints a profilodra, majd a **My Account** gombra.
2. Nyisd le az **Interfaces** listát, és válaszd a **Rest API** pontot.
3. Kattints a **Create OAuth2 app** gombra.
4. Adj nevet az alkalmazásnak, válaszd a **REST API Version 3** verziót, hagyd meg az átirányítási URL-t (`*`), jelöld be a **Recipients** és **Forms** hatókört, majd kattints a **Create Now** gombra.
5. A létrejött alkalmazás sorában kattints a három pontra, és nyisd meg a szerkesztőt.
6. Az **Oauth2 App Data** fülön másold ki a **Client ID** és a **Client Secret** értékét a másolás ikonnal.

### Összekötés a Fluent Formsszal

1. Kapcsold be a **CleverReach** modult az **Integrációk** oldalon.
2. Nyisd meg a **Globális beállítások → Integrációk beállítása → CleverReach** oldalt.
3. Illeszd be az értékeket a **CleverReach-kliens ID** és a **CleverReach-kliens titkos kulcs** mezőbe.
4. Kattints a **Beállítások mentése** gombra.
5. A mentés után a CleverReach bejelentkezési oldalára kerülsz. Add meg az ügyfélazonosítódat (Customer ID, a profilmenüben az **Account** mellett találod), a felhasználónevedet és a jelszavadat, majd kattints a bejelentkezés és csatlakoztatás gombjára.

![A CleverReach globális beállításai](./kepek/integraciok-2-globalis-cleverreach.webp)

*A CleverReach globális beállításai* (https://minta-bolt.hu/wp-admin/admin.php?page=fluent_forms_settings)

A képen a két kulcsmező látszik. Az oldal tetején a sárga sáv az OAuth-alkalmazás létrehozásának lépéseit foglalja össze (ez a sáv angol maradt). Sikeres kapcsolat után a **Verify Connection Again** és a **Disconnect CleverReach** gombbal ellenőrizheted vagy megszakíthatod a kapcsolatot.

### Feed létrehozása

1. Az űrlap **Beállítások és integrációk** fülén kattints az **Új integráció hozzáadása** gombra, és válaszd a **CleverReach Integration** feedet.
2. Add meg a feed nevét, és válaszd ki a CleverReach-listát.
3. Töltsd ki a beállításokat, majd kattints a **Feed mentése** gombra.

| Beállítás | Mit csinál |
| --- | --- |
| Név | A feed neve, bármikor átírhatod. |
| CleverReach-lista | A lista, ahová az adat kerül. Bármikor módosítható. |
| Mezők leképezése | A CleverReach-mezők megfeleltetése az űrlap mezőivel a rövidkódnyíllal. |
| Feltételes logika | A feed csak a megadott feltételek teljesülésekor fut. |
| Újrafeliratkozás | Újra aktiválja a listán már szereplő, de leiratkozott vagy inaktivált kapcsolattartót. Nélküle a feed hibával áll meg ilyen kapcsolattartónál. Csak akkor kapcsold be, ha jogod van újra megkeresni az illetőt. |
| A feed engedélyezése | A feed bekapcsolása. |

## Constant Contact (V3)

A Constant Contact régi, V2-es API-ja megszűnt, ezért a **Constant Contact V3** modult kell használni. A modulok között a régi **Constant Contact** modul is látszik, a globális beállításainál viszont a figyelmeztetés a V3-ra irányít.

### A kliens ID és a titkos kulcs megszerzése

1. Jelentkezz be a Constant Contact fejlesztői fiókjába, és kattints a **New Application** gombra.
2. Adj nevet az alkalmazásnak. Az **Application OAuth2 Settings** alatt válaszd az **Authorization Code Flow and Implicit Flow** és a **Rotating Refresh Tokens** lehetőséget, majd kattints a **Create** gombra.
3. A létrejött alkalmazásnál kattints a jobb oldali **Edit** gombra.
4. A **Details** fülön másold ki a **Client ID** értékét az **API Key (Client ID)** mezőből.
5. Kattints a **Generate Client Secret** gombra, és másold ki a titkos kulcsot. A **Client Secret** csak egyszer látszik, ezért mentsd el biztonságos helyre, mielőtt elhagyod az oldalt.
6. Az átirányítási URL (Redirect URL) mezőjét a ceruza ikonnal nyisd meg. A Fluent Forms beállítóoldalának tetején, a Constant Contact V3 útmutatójában megtalálod a használandó URL-t: másold ki onnan, illeszd be a mezőbe, és kattints a **Confirm** gombra.
7. Mentsd az alkalmazást a **Save** gombbal.

### Összekötés a Fluent Formsszal

1. Kapcsold be a **Constant Contact V3** modult az **Integrációk** oldalon.
2. Nyisd meg a **Globális beállítások → Integrációk beállítása → Constant Contact V3** oldalt.
3. Illeszd be az értékeket a **Constant Contact Client ID** és a **Constant Contact Client Secret** mezőbe.
4. Kattints a **Constant Contact ellenőrzése** gombra. A Constant Contact oldalán engedélyezd a hozzáférést az **Allow Access** gombbal.

![A Constant Contact V3 globális beállításai](./kepek/integraciok-2-globalis-constant-contact-v3.webp)

*A Constant Contact V3 globális beállításai* (https://minta-bolt.hu/wp-admin/admin.php?page=fluent_forms_settings)

A képen az oldal tetején az útmutató látszik, benne a webhelyedre jellemző átirányítási URL-lel, alatta a két kulcsmező és az ellenőrző gomb. Sikeres kapcsolat után a **Verify Connection Again** és a **Disconnect Constant Contact** gomb érhető el.

### Feed létrehozása

1. Az űrlap **Beállítások és integrációk** fülén kattints az **Új integráció hozzáadása** gombra, és válaszd a **Constant Contact V3 Integration** feedet.
2. Töltsd ki a beállításokat, majd kattints a **Feed mentése** gombra.

| Beállítás | Mit csinál |
| --- | --- |
| Név | A feed neve, bármikor átírhatod. |
| Constant Contact-lista | A kapcsolattartó-lista, ahová az adat kerül. A lista kiválasztása után jelenik meg a mezőleképezés. |
| Constant Contact-címke | Egy vagy több címke, amelyet a beküldők megkapnak. |
| Mezők leképezése | A Constant Contact-mezők megfeleltetése az űrlap mezőivel a rövidkódnyíllal. |
| Egyéni mezők | A Constant Contact egyéni mezőihez rendelhetsz űrlapmezőt. A plusz és mínusz ikonnal adhatsz hozzá vagy törölhetsz sort. |
| Feltételes logika | A feed csak a megadott feltételek teljesülésekor fut. |
| Kapcsolattartó frissítése | Ha a beküldött e-mail-cím már szerepel a listán, a meglévő kapcsolattartó adatait frissíti, és nem hoz létre másolatot. |
| A feed engedélyezése | A feed bekapcsolása. |

Az egyéni dátummezők csak az `HH/NN/ÉÉÉÉ` alakot (hónap/nap/év) fogadják el.

### Ellenőrzés

A Constant Contactban a **Contacts → Lists** oldalon nyisd meg a kiválasztott listát, és nézd meg a címkéhez tartozó kapcsolattartókat is: a beküldők mindkét helyen automatikusan megjelennek.