# Salesforce és Zoho CRM

> A Salesforce és a Zoho CRM összekötése a Fluent Formsszal: OAuth-alkalmazás létrehozása, kulcsok beállítása, majd űrlapfeed a szolgáltatások mezőleképezésével.

Ez a fejezet két, OAuth-alapú CRM-integrációt ír le. Mindkettő a Fluent Forms Pro része, és mindkettőnél előbb a szolgáltatás oldalán kell alkalmazást regisztrálnod, majd a kapott kulcsokat beírni a Fluent Forms globális beállításaiba.

## Salesforce

A Salesforce népszerű ügyfélkapcsolat-kezelő (CRM) platform. A Fluent Formsszal az űrlapbeküldések kapcsolatként vagy más Salesforce-objektumként kerülhetnek be.

A Salesforce API-hozzáférést csak négy kiadásban biztosít: Enterprise, Unlimited, Developer és Performance.

### Bekapcsolás

1. Nyisd meg a **Fluent Forms Pro → Integrációk** oldalt.
2. A **Salesforce** modul kártyáján kapcsold be a kapcsolót, majd kattints a fogaskerékre.

A beállítóoldal tetején egy tájékoztató doboz látszik a **callback URL-lel**: ezt másold ki, mert a Salesforce-ban kell majd. Alatta ezek a mezők vannak: **Sandbox-fiók** (jelölőnégyzet, sandbox használatakor jelöld be), **Salesforce-domén URL**, **Salesforce fogyasztói kulcs**, **Salesforce fogyasztói titok**.

![A Salesforce-beállítások a globális beállításokban](./kepek/integraciok-1-globalis-salesforce.webp)

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

A képen a tájékoztató doboz a callback URL-t is megmutatja, alatta a három kitöltendő mező és a **Beállítások mentése** gomb látszik.

### Az adatok megszerzése a Salesforce-ban

1. Jelentkezz be a Salesforce-ba. A kezdőlapon kattints a fogaskerék ikonra, és válaszd az **Open Advanced Setup** pontot.
2. A bal oldali menüben az **Apps** alatt válaszd az **App Manager** pontot, majd kattints a **New Connected App** gombra.
3. A felugró ablakban válaszd a **Create a Connected App** lehetőséget, és kattints a **Continue** gombra.
4. Add meg a **Connected App Name**, az **API Name** és a **Contact Email** értékét.
5. Jelöld be az **Enable OAuth Settings** négyzetet, és a **Callback URL** mezőbe illeszd be a Fluent Forms beállításaiban látott callback URL-t.
6. Az OAuth-hatókörök (scope) közül válaszd ki ezt a kettőt: „Manage user data via APIs (api)” és „Perform requests at any time (refresh_token, offline_access)”.
7. Mentsd az alkalmazást, és várj néhány percet, amíg aktiválódik.
8. Kattints a **Manage Consumer Details** gombra, és az **API (Enable OAuth Settings)** alatt másold ki a **Consumer Key** és **Consumer Secret** értéket.
9. A domén URL-jét a jobb felső profilikonra kattintva találod. Másold ki, és tedd elé a `https://` előtagot.

A Fluent Forms beállítóoldalán a tájékoztató doboz további javaslatokat is ad: kapcsold be a „Require Proof Key for Code Exchange (PKCE)” beállítást, és ha az alkalmazás a frissítési tokeneket IP-címhez köti, add hozzá a webhelyed szerverének kimenő IP-címét az alkalmazás Refresh Token IP-engedélylistájához, különben az első munkamenet lejárta után a kapcsolat megszűnik. A domén URL szokásos alakja: `https://{SajátDoménNév}.my.salesforce.com`.

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

1. Nyisd meg a **Globális beállítások → Integrációk beállítása → Salesforce** oldalt.
2. Írd be a **Salesforce-domén URL**, a **Salesforce fogyasztói kulcs** és a **Salesforce fogyasztói titok** mezőbe a kimásolt adatokat.
3. Kattints a **Beállítások mentése** gombra.

Ha a kapcsolat működik, az oldal ezt jelzi, és megjelenik a **Disconnect Salesforce** gomb a lecsatlakozáshoz.

### Feed létrehozása az űrlapon

1. Nyisd meg az űrlapot, és kattints a **Beállítások és integrációk** fülre.
2. Az **Integrációk beállítása** oldalon kattints az **Új integráció hozzáadása** gombra, és válaszd a **Salesforce Integration** pontot.
3. Add meg a feed nevét (kötelező), és válaszd ki a Salesforce-szolgáltatást (például **Contact**), ahová az adatot küldeni akarod. A szolgáltatás kiválasztása után megjelennek a leképezhető mezők.
4. Feleltesd meg a Salesforce-mezőket az űrlap mezőivel.
5. Ha feltételhez akarod kötni, kapcsold be a **Feltételes logika engedélyezése** jelölőnégyzetet.
6. Tartsd bekapcsolva a feed állapotát, majd kattints a **Feed mentése** gombra.

A mentett feedet a fogaskerékkel szerkesztheted, a kukával törölheted, a kapcsolóval ki- és bekapcsolhatod. Az eredmény a Salesforce **Contacts** oldalán látszik, a beküldések pedig az űrlap **Bejegyzések** részében.

## Zoho CRM

A Zoho CRM online értékesítési CRM, amely az értékesítést, a marketinget és az ügyfélszolgálatot egy felületen kezeli. A Fluent Formsszal az űrlapok használói bekerülhetnek a Zoho CRM-be.

### Bekapcsolás

1. Nyisd meg a **Fluent Forms Pro → Integrációk** oldalt.
2. A **Zoho CRM** modul kártyáján kapcsold be a kapcsolót, majd kattints a fogaskerékre.

A beállítóoldal három mezőt kér: **Fiók URL-címe** (legördülő), **Zoho CRM Client ID** és **Zoho CRM-ügyféltitok**. A tetején lévő tájékoztató dobozból másold ki a **Homepage URL** és az **Authorized Redirect URIs** értékét, mert a Zoho-ban kell majd.

![A Zoho CRM beállításai a globális beállításokban](./kepek/integraciok-1-globalis-zohocrm.webp)

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

A képen a tájékoztató doboz a két kimásolandó URL-t is mutatja, alatta a fiókcím, a Client ID és az ügyféltitok mezője látszik.

### Az adatok megszerzése a Zoho-ban

1. Ha még nincs regisztrált alkalmazásod, nyisd meg a Zoho Developer Console-t (API Console).
2. Válaszd az ügyféltípust: **Server-based Applications**.
3. A felugró ablakban add meg a **Client Name** nevet, illeszd be a **Homepage URL** és az **Authorized Redirect URIs** értéket, majd kattints a **Create** gombra.
4. Másold ki a **Client ID** és **Client Secret** értéket.
5. A Settings részben kapcsold be a számodra szükséges adatközpontokat (Data Centers).

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

1. Nyisd meg a **Globális beállítások → Integrációk beállítása → Zoho CRM** oldalt.
2. Válaszd ki a fiók URL-jét, és írd be a Client ID-t és az ügyféltitkot.
3. Kattints a **Beállítások mentése** gombra.
4. A Zoho CRM átirányít a megerősítő oldalra. Kattints az **Accept** gombra.

Ha a kapcsolat működik, az oldal ezt jelzi, és megjelenik a **Disconnect Zoho CRM** gomb.

### Feed létrehozása az űrlapon

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 **Zoho CRM Integration** pontot.
2. Add meg a feed nevét.
3. A **Services** legördülőből válaszd ki a Zoho CRM-szolgáltatást, és állítsd be a mezőket.
4. Az **Other Fields** alatt feleltesd meg a Zoho CRM mezőit az űrlap mezőivel a mezőválasztó nyíllal.
5. Ha kell, kapcsold be a **Feltételes logika engedélyezése** jelölőnégyzetet.
6. Tartsd bekapcsolva a feed állapotát, majd kattints a **Feed mentése** gombra.

A feedet utána a szokásos módon kezelheted a listában (szerkesztés, törlés, ki- és bekapcsolás). A felvett kapcsolatok a Zoho CRM-ben látszanak, a beküldések pedig az űrlap **Bejegyzések** részében.