JetFormBuilder HubSpot Action

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.