# MailPoet, Mautic, FluentCRM, HubSpot és ClickSend

> Hírlevél- és CRM-bővítmények, a HubSpot és az SMS-küldő ClickSend összekötése, a FluentCRM automatizálási indítóival.

A fejezet a WordPress-bővítményként működő hírlevél- és CRM-rendszereket (MailPoet, Mautic, FluentCRM), a HubSpotot és az SMS-értesítést küldő ClickSendet írja le. A közös menet ugyanaz: modul bekapcsolása az **Integrációk** oldalon, szükség esetén hozzáférés megadása a **Globális beállítások** alatt, majd feed létrehozása az űrlap **Integrációk beállítása** oldalán az **Új integráció hozzáadása** gombbal. A feedek kezelését az [áttekintés](https://hub.hellowp.io/hu/plugins/fluentformpro/integraciok-attekintes/) írja le.

## MailPoet

A MailPoet hírlevélbővítmény, a beküldők a MailPoet listájára kerülnek.

### Előkészítés

1. Telepítsd és aktiváld a MailPoet bővítményt.
2. Telepítsd és aktiváld a **Fluent Forms Connector for MailPoet** bővítményt a **Bővítmények → Új bővítmény hozzáadása** oldalon (keresd meg, kattints a **Telepítés** majd az **Aktiválás** gombra).
3. Az **Integrációk** oldalon keresd meg a **MailPoet** modult, és kapcsold be.

### Feed

Az űrlap **Integrációk beállítása** oldalán válaszd a **MailPoet Integration** feedet.

| Beállítás | Mit csinál |
| --- | --- |
| Feed Name | A feed neve, hogy később könnyen megtaláld. |
| MailPoet List | A MailPoet listája, ahová a kapcsolatok kerülnek. |
| Primary Fields | A MailPoet mezőinek összekötése az űrlapmezőkkel a legördülőből. Saját érték is megadható. |
| Custom Fields | További mezők hozzáadása vagy törlése a plusz és mínusz ikonnal. Ehhez MailPoet Pro kell. |
| Send Confirmation Email | Bekapcsolva megerősítő e-mailt kap az új kapcsolat. Ehhez MailPoet Pro és ellenőrzött MailPoet-fiók kell. |
| Conditional Logic | A feed csak a beküldött értékek alapján megadott feltételek mellett fut. |
| Enable This Feed | Ha kiveszed a pipát, a feed vázlatként mentődik, és nem működik. |

Ne felejts el a **Feed mentése** gombra kattintani.

## Mautic

A Mautic marketingautomatizáló rendszer. Telepítve kell lennie a Fluent Forms alapbővítménynek és a Pro bővítménynek is: a Mautic-összekötés az ingyenes bővítménnyel is működik, de a csak Pro-ban elérhető funkciók (például a telefonmező és a feltételes logika) a Pro bővítményt igénylik.

### Előkészítés

1. Telepítsd és aktiváld a **Mautic Integration For Fluent Forms** bővítményt a **Bővítmények → Új bővítmény hozzáadása** oldalon.
2. Az **Integrációk** oldalon kapcsold be a **Mautic** modult, és kattints a beállítás ikonra. A beállítóoldalon három adat kell: a **Mautic Account URL**, a **Client ID** és a **Client Secret**. Az oldalon megjelenő átirányítási URL-t (Redirect URL) másold ki, később kell.

### Hozzáférési adatok a Mauticban

Szükséged van egy működő Mautic-példányra (ha nincs, előbb a saját szerveredre kell telepíteni).

1. A Mautic felületén kattints a jobb felső fogaskerékre, majd a bal oldali sávban a **Configuration** pontra.
2. Az **API Settings** résznél engedélyezd az API-t (**Yes**), és mentsd.
3. Kattints ismét a fogaskerékre, nyisd le az **Integration** csoportot, és válaszd az **API Credentials** pontot.
4. Kattints a **New** gombra. Az **Authorization Protocol** értéke legyen **OAuth 2**, adj nevet, és az átirányítási URL mezőbe illeszd be a Fluent Formsból kimásolt címet.
5. Kattints a **Save** gombra. Megkapod a **Client ID** és **Client Secret** értékeket, másold ki őket.

### Kapcsolat a Fluent Formsszal

1. A **Globális beállítások → Integrációk beállítása** alatt nyisd meg a **Mautic** fület.
2. Az API-URL mezőbe írd be a Mautic-fiókod címét, a **Mautic Client ID** és a **Mautic Client Secret** mezőbe illeszd be a másolt értékeket.
3. Kattints a **Beállítások mentése** gombra, majd a megjelenő **Accept** gombbal engedélyezd, hogy a Fluent Forms kapcsolódjon a Mautic-fiókhoz.

### Feed

Válaszd a **Mautic Integration** feedet.

| Beállítás | Mit csinál |
| --- | --- |
| Feed Name | A feed neve. |
| Map Fields | A Mautic mezőinek összekötése az űrlapmezőkkel a legördülőből, vagy saját értékkel. |
| Other Fields | További mezők hozzáadása vagy törlése a plusz és mínusz ikonnal. |
| Lead Tags | Címkék a kapcsolatokhoz, SmartCode-okkal a legördülőből vagy saját értékkel. A beküldők a Mautic **Contacts** és **Tags** részében jelennek meg. |
| Last Active | Bekapcsolva a Fluent Forms átadja a Mautic-kapcsolatnak a létrehozás idejét. |
| Push IP Address | Bekapcsolva a Fluent Forms átadja az IP-címet a Mauticnak. |
| Conditional Logics | A feed csak a megadott feltételek mellett fut. |
| Status | Ha kiveszed az **Enable This Feed** pipát, a feed vázlatként mentődik. |

## FluentCRM

A FluentCRM önállóan telepített (self-hosted) CRM-bővítmény. A Fluent Forms és a FluentCRM mellett nincs szükség külön globális beállításra: ha mindkettő aktív, a modul kapcsolható. A bejelentkezett kapcsolatok adataival az űrlapmezőket előre is kitöltheted.

### Feed

1. Az **Integrációk** oldalon keresd meg a **FluentCRM** modult, és kapcsold be.
2. Az űrlap **Integrációk beállítása** oldalán válaszd a **FluentCRM Integration** feedet.

| Beállítás | Mit csinál |
| --- | --- |
| Feed Name | A feed neve. |
| FluentCRM List | A FluentCRM kapcsolati listája, bármikor cserélhető. |
| Primary Fields | A FluentCRM mezőinek összekötése az űrlapmezőkkel a rövidkód-nyíllal. |
| Other fields | További űrlapmezők hozzárendelése FluentCRM-mezőkhöz, a plusz ikonnal több sor adható hozzá. |
| Contact Tag | Egy vagy több FluentCRM-címke a kapcsolathoz. |
| Enable Dynamic Tag Selection | Feltételek alapján dinamikus címkéket rendel a kapcsolathoz. |
| Skip contact already exists in FluentCRM | Megakadályozza a duplikált kapcsolatokat: ha a kapcsolat már létezik, nem kerül be újra. |
| Skip name update if existing contact has old data | A meglévő kapcsolat neve nem íródik felül az újonnan beküldött adattal. |
| Enable Double Opt-In for a new Contact | Az új kapcsolatnak kettős opt-in e-mailt küld ([lásd a kettős opt-in fejezetet](https://hub.hellowp.io/hu/plugins/fluentformpro/ertesitesek-kettos-optin/)). |
| Enable Force subscribe if contact is not in subscribed status | A meglévő, de nem feliratkozott állapotú kapcsolatot feliratkoztatja. |
| Conditional logic | A feed csak a megadott feltételek mellett fut. |
| Remove Contact Tags | A kiválasztott címkéket eltávolítja a kapcsolatról. |
| Status | Az **Enable This Feed** bekapcsolja a feedet. |

Az új kapcsolatok az űrlap **Beküldések** oldalán a beküldéshez tartozó bejegyzésben követhetők.

### Automatizálási indítók a FluentCRM-ben

A FluentCRM automatizálási folyamatait (funnel) a Fluent Forms eseményei indíthatják. A FluentCRM **Automation** oldalán kattints a **+ New Automation** gombra. Az indítók a bal oldali sávban, a Fluent Forms kategória alatt vannak:

- **Subscription Cancelled (Fluent Form)**: egy előfizetés lemondásakor indul.
- **Subscription Payment Received**: előfizetési befizetés beérkezésekor indul.
- **New Form Submission**: új űrlapbeküldéskor indul.

Az indító kiválasztása után kattints a **Continue** gombra, és az **Internal Label** mezőben adj nevet a folyamatnak.

**Subscription Cancelled** beállításai:

| Beállítás | Mit csinál |
| --- | --- |
| Automation Name | A folyamat neve. |
| Internal Description | Leírás, amely az automatizálási szerkesztő blokkdiagramján alcímként látszik. |
| Subscription Status | A kapcsolat állapota a FluentCRM szerint, amelyre az űrlapot beküldő kapcsolatot állítja. |
| Run the automation actions even if contact status is not in subscribed status | A folyamat akkor is fut, ha a kapcsolat nincs feliratkozott állapotban. |
| Target Forms | Melyik űrlap indítja a folyamatot. Üresen hagyva minden űrlap indítja. |
| Restart | Ugyanazt a kapcsolatot többször is újraindíthatja a folyamatot. |

**Subscription Payment Received** és **New Form Submission** beállításai (a két indító ugyanúgy működik):

| Beállítás | Mit csinál |
| --- | --- |
| Automation Name | A folyamat neve. |
| Internal Description | Leírás a blokkdiagramhoz. |
| Select your form | Az űrlap, amelynek beküldése indítja a folyamatot. |
| Map Primary Data | A FluentCRM adatainak (keresztnév, vezetéknév, e-mail) összekötése az űrlapmezőkkel. |
| Map Other Data | További kapcsolati tulajdonságok és űrlapmezők összekötése. |
| Subscription Status | A kapcsolat állapota a FluentCRM-ben. |
| Conditions | Ha bekapcsolod a **Run this automation only once per contact** opciót, a folyamat kapcsolatonként csak egyszer fut. Ha kikapcsolod, a meglévő folyamatot felülírja. |

Mindegyik indítónál kattints a **Save Settings** gombra a mentéshez.

## HubSpot

A HubSpot-integráció a beküldésekből létrehozza vagy frissíti a HubSpot-kapcsolatokat, és felveszi őket a listáidra.

### Hozzáférési token

1. Kapcsold be a **HubSpot** modult az **Integrációk** oldalon, és nyisd meg a beállításait. Egy adat kell: a **HubSpot Access Token**.
2. A HubSpot-fiókban kattints a jobb felső fogaskerékre, majd az **Integrations** alatt nyisd meg a **Legacy Apps** pontot.
3. Kattints a **Create legacy app** gombra, a felugró ablakban válaszd a **Private** lehetőséget, majd kattints a **Continue with legacy private app** gombra.
4. A **Basic Info** résznél adj nevet a privát alkalmazásnak (például „Fluent Forms”).
5. A **Scopes** fülön kattints az **Add new scope** gombra, és add hozzá a kapcsolatok jogosultságait: `crm.objects.contacts.read`, `crm.objects.contacts.write`, `crm.schemas.contacts.read`.
6. Listák szinkronizálásához add hozzá még a `crm.lists.read` és `crm.lists.write` jogosultságot is.
7. Kattints a jobb felső **Create app** gombra, majd a megerősítő ablakban a **Continue creating** gombra.
8. Nyisd meg az **Auth** fület, és másold ki az **Access Token** értékét.
9. A Fluent Forms **HubSpot** beállításai között illeszd be a tokent, és kattints a **Beállítások mentése** gombra. A sikeres ellenőrzést értesítés jelzi. A kapcsolatot a **Disconnect HubSpot** gombbal bonthatod.

### Feed

Az űrlap **Integrációk beállítása** oldalán kattints az **Új integráció hozzáadása** gombra, és válaszd a **HubSpot Integration** feedet.

> **Megjegyzés**
>
> A beküldések szinkronizálásához statikus HubSpot-lista kell. A listatagság módosítása csak az olyan listatípusoknál működik, amelyeknél a tagság kézzel módosítható (MANUAL és SNAPSHOT listák). A dinamikus vagy aktív listákkal a Fluent Forms nem működik.

| Beállítás | Mit csinál |
| --- | --- |
| Name | A feed egyedi neve. |
| HubSpot list | A HubSpot-lista, amelyre a beküldött adatok kerülnek. |
| Map Fields | A HubSpot mezőinek összekötése az űrlapmezőkkel a rövidkód-választóval. |
| Other Fields | További egyéni HubSpot-mezők, a plusz ikonnal adhatsz hozzá sort. |
| Conditional Logic | A feed csak a megadott feltételek mellett fut. |
| Update | A **Contact Update** bekapcsolásával a meglévő HubSpot-kapcsolatok is frissülnek az új adatokkal. |
| Status | A feed bekapcsolása. |

Ha a HubSpot frissítése (CRM v3 és Lists v3) előtt már volt HubSpot-feeded, a Fluent Forms megpróbálja magától átvinni a régi lista azonosítóját. Ha ez nem sikerül, nyisd meg a feedet, válaszd ki újra a HubSpot-listát, és mentsd el.

A beküldések az űrlap **Beküldések** oldalán láthatók, a HubSpotban pedig a **CRM → Contacts** oldalon az integrált listához tartozó kapcsolatok között.

## ClickSend SMS

A ClickSend segítségével valós időben SMS-t küldhetsz minden űrlapbeküldéskor.

### Hozzáférés

1. Kapcsold be a **ClickSend** modult az **Integrációk** oldalon. Három adat kell: **Sender Number**, **Username** és **API Key**.
2. A ClickSend-fiókban kattints a profil ikonra, majd az **Account** (fiókbeállítások) pontra. Itt éred el az API-kulcsot.
3. SMS-értesítések küldéséhez ClickSend-szám is kell, ezt a ClickSend felületén vásárolhatod meg.
4. Másold ki a feladó számát, a felhasználónevet és az API-kulcsot.
5. A Fluent Forms **ClickSend** beállításai között illeszd be a három értéket a megfelelő mezőbe, és kattints a **Beállítások mentése** gombra.

### Feed

Az űrlap **Integrációk beállítása** oldalán válaszd a **ClickSend SMS Notification** feedet.

1. Adj nevet a feednek, és a legördülőből válaszd ki a használni kívánt ClickSend SMS-szolgáltatást.
2. Állítsd be az üzenet szövegét (**Message Body**), a címzett számát (**To**), valamint az opcionális **Message**, **SMS Template** és **SMS Schedule** mezőket.
3. Ha kell, kapcsold be a **Conditional Logics** beállítást.
4. Kattints a **Create ClickSend SMS Feed** gombra.
