# JetFormBuilder HubSpot Action

> JetFormBuilder Pro kiegészítő, amely HubSpot Post Submit Actiont ad az űrlapokhoz, és a beküldött adatokat automatikusan a HubSpot CRM-be szinkronizálja.

## Mi ez és milyen problémát old meg?

A JetFormBuilder HubSpot Action egy Pro kiegészítő, amellyel a JetFormBuilder űrlapjaid beküldését követően automatikusan létrehozhatsz vagy frissíthetsz HubSpot kontaktokat. Megszünteti a manuális adatmásolást az űrlapok és a CRM között, csökkenti a hibázást, és azonnal a megfelelő értékesítési/marketing folyamatokba tereli a leadjeidet. A bővítmény a beküldött mezőket a HubSpot kontakt tulajdonságaihoz rendeli, társíthat cégeket, beállíthat kontakt‑tulajdonost és életciklus‑stádiumot, sőt feltételekhez is kötheted a szinkront.

## Hogyan működik? – Működési elv

A bővítmény egy új **Post Submit Action** típust ad: HubSpot. Amikor egy űrlap beküldése sikeres, a JetFormBuilder futtatja a hozzárendelt akciókat a megadott sorrendben és feltételek mellett. A HubSpot Action:

1. A globális HubSpot hitelesítésedet (ajánlott: **OAuth 2.0**) használja.
2. A **Fields Map** szerint párosítja az űrlapmezőket a HubSpot tulajdonságokhoz.
3. E‑mail alapján megpróbál meglévő kontaktot frissíteni, különben újat hoz létre.
4. Opcionálisan **céget társít** a kapcsolathoz.
5. Beállíthat **kontakt‑tulajdonost** és **életciklus‑stádiumot**.
6. Feltétel esetén csak akkor fut, ha a megadott logika igaz.

Az akciók láncolhatók és kombinálhatók, így a HubSpot‑szinkront más JetFormBuilder folyamatokkal is összehangolhatod.

## Fő funkciók, részletesen

- **HubSpot integráció mint Post Submit Action**  
  Az űrlap elküldése után fut. Egy űrlapon több akciód is lehet (pl. e‑mail értesítés + HubSpot szinkron), sorrenddel és feltételekkel.

- **Fields Map (mezőtérkép)**  
  Pontosan megadod, mely űrlapmező mely HubSpot mezőbe kerüljön. Az **e‑mail kötelező**, de felvehetsz további adatokat (keresztnév, vezetéknév, telefon, weboldal, egyedi tulajdonságok). Ez biztosítja az adatkonzisztenciát és a könnyű karbantartást.

- **Associated company (cég társítása)**  
  A kontaktot egy vagy több céghez kapcsolhatod. Használhatsz űrlapmezőt (pl. cégnév) vagy előre beállított azonosítót, a csapatod adatmodelljéhez igazítva.

- **Contact owner (kontakt‑tulajdonos)**  
  Kiválaszthatsz egy HubSpot felhasználót, akihez a kontakt hozzárendelődik. Így a lead azonnal felelőshöz kerül, rövidül a reakcióidő.

- **Lifecycle stage (életciklus‑stádium)**  
  Beállíthatod, hogy a kontakt mely tölcsérszakaszba kerüljön (pl. Subscriber, Lead, MQL, SQL, Opportunity, Customer). A HubSpot szabályai érvényesek (például bizonyos visszaléptetések korlátozottak lehetnek).

- **Use Global Settings (globális beállítások)**  
  A hitelesítést és alapparamétereket központilag megadhatod. Az űrlapok akciói ezt öröklik, így kevesebb a duplikált konfiguráció.

- **Feltételes futtatás**  
  Az akció csak akkor indul, ha a feltételek teljesülnek. Példa: csak akkor küldj adatot a HubSpotba, ha a „Hírlevél” jelölőnégyzet be van pipálva.

- **OAuth 2.0 engedélyezés**  
  Biztonságos, naprakész hitelesítés. A HubSpot régi API‑kulcsai kivezetésre kerültek, ezért új integrációkhoz OAuth vagy Private App token szükséges; a bővítmény az OAuth‑ot támogatja és javasolja.

- **Kompatibilitás**  
  JetFormBuilder (Gutenberg) szükséges. Általános rendszerkövetelmények: modern PHP és MySQL verziók; a HubSpot Action a JetFormBuilder Pro addonjai közé tartozik.

## Gyakorlati példák

- **Ajánlatkérő űrlap B2B oldalon**  
  Beküldéskor létrehozod/frissíted a kontaktot, a cégmező alapján társítod a vállalathoz, tulajdonosnak az értékesítő csapat vezetőjét állítod, életciklusnak MQL‑t adsz. Ha a „Sürgős” jelölőnégyzet igaz, külön listába sorolod egy későbbi automatizmushoz.

- **Eseményregisztráció**  
  Az e‑mail és név bekerül a HubSpotba, életciklus „Subscriber”, és egy előkészített marketing automatizmus indul. Ha a résztvevő megadja a céget, a kontakt a céghez is társul.

- **Pénztári/lead űrlap e‑kereskedelemben**  
  A sikeres lead beküldésekor a kontakt „Lead” vagy „Customer” státuszt kap. A hírlevél jelölőnégyzet határozza meg, hogy bekerül‑e a marketing listába.

## Telepítés és konfigurálás – gyors áttekintés

1. Telepítsd és aktiváld a JetFormBuildert és a Pro HubSpot addont.  
2. A JetFormBuilder beállításoknál engedélyezd a HubSpot kapcsolatot **OAuth 2.0‑val** (fejlesztői app, kötelező scope‑ok: contacts/companies ír‑olvas, owners olvas).  
3. Add meg a redirect URL‑t a HubSpot appban, majd azonosítsd a webhelyedet (Authorize/Connect).  
4. Nyisd meg az űrlapodat, add hozzá a **HubSpot** Post Submit Actiont, kapcsold be a **Use Global Settings** opciót.  
5. Állítsd be a **Fields Map**‑et, a cég társítását, a kontakt‑tulajdonost és az életciklus‑stádiumot.  
6. Opcionálisan adj meg **feltételt** az akció futásához.

Példa konfiguráció (szemléltetés):

```
Fields Map:
  email: { field: email }
  firstname: { field: first_name }
  lastname: { field: last_name }
Associated company: { field: company }
Contact owner: { static: "owner_id" }
Lifecycle stage: { static: "MQL" }
Use Global Settings: true
Condition: { when: newsletter == true }
```

## Előnyök és értékajánlat

- **Idő- és költségmegtakarítás**: megszűnik a manuális másolás, csökken a hibaarány.  
- **Gyors reakció**: tulajdonos és stádium azonnal beáll, automatizmusok indulnak.  
- **Skálázhatóság**: szabályozott, egységes adatáramlás a Fields Map révén.  
- **Rugalmasság**: feltételes futás, több akció kombinálása, globális beállítások.

## Kinek ajánlott?

- **Marketing és értékesítési csapatoknak**, akik űrlap‑leadeket dolgoznak fel HubSpotban.  
- **B2B szolgáltatóknak és ügynökségeknek**, ahol létfontosságú a cég‑kapcsolatok kezelése.  
- **E‑kereskedőknek**, akik checkout/lead űrlapjaikat CRM‑mel hangolják össze.  
- **No‑code/low‑code megoldásokat keresőknek**, akik gyorsan, fejlesztés nélkül akarnak CRM‑szinkront.

## Hibakeresés és tippek

- **OAuth hibák**: ellenőrizd a redirect URL‑t és a szükséges scope‑okat; ha hiányosak, a kapcsolat elutasítható.  
- **Hiányzó e‑mail**: az e‑mail kötelező a kontakt azonosításához; engedélyezd a mező validációját.  
- **Életciklus‑stádium**: a HubSpot korlátozhatja a visszaléptetést; ha nem alkalmazható, hagyd üresen vagy csak előreléptess.  
- **Tulajdonos hozzárendelés**: győződj meg róla, hogy a megadott owner létezik és elérhető azonosítóval.  
- **Mezőtérkép**: ha egy tulajdonság nem frissül, ellenőrizd a pontos belső mezőnevet és az adat típust (szöveg, szám, többértékű).  

## Gyors tények

- Követelmény: JetFormBuilder + Pro HubSpot addon.  
- Kulcselemek: HubSpot Post Submit Action, Fields Map, Associated company, Contact owner, Lifecycle stage, Use Global Settings, feltételes futtatás.  
- Ajánlott hitelesítés: OAuth 2.0.