HubSpot integráció

Mi a HubSpot?

A HubSpot egy CRM és értékesítési platform. A kontaktokat (személyeket) és a dealeket (üzleti lehetőségeket) egy helyen követi, és a hozzájuk tartozó jegyzeteket is tárolja.

Mire használhatod a Suarában?

Ha összekötöd a HubSpotot, az appodból érkező érdeklődők automatikusan a CRM-be kerülnek. Néhány példa:

• Kapcsolatfelvételi űrlap: az űrlap e-mail alapján létrehozza vagy frissíti a kontaktot.

• Ajánlatkérés: az űrlap deal-t is nyit, az üzenetet pedig jegyzetként csatolja.

• Ügyfélportál: az ügyfél látja a hozzá tartozó deal állapotát.

• Belső kimutatás: egy oldal a kontaktokat és dealeket jeleníti meg.

Az AI az alábbi műveleteket használja:

• Kontakt létrehozása vagy frissítése: e-mail alapján, duplikátum nélkül.

• Deal létrehozása vagy frissítése: új üzleti lehetőséget nyit, vagy módosít egy meglévőt.

• Jegyzet csatolása: az érdeklődő üzenetét jegyzetként rögzíti.

• Kontaktok és dealek olvasása: lekéri őket.

Hozzájárulás

Az űrlapon alapból be nem pipált hozzájárulás-jelölőnégyzet szerepel, amely jelzi, hogy az adatok a cég CRM-jébe kerülnek. Marketing e-mailekhez külön hozzájárulás kell.

Biztonság

A Private App access token titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül. Az app a Suara gatewayen keresztül hívja a HubSpotot, a gateway pedig a háttérben hozzáadja a hitelesítő adatokat. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

Beállítás lépésről lépésre

1. Hozz létre egy Private Appot a HubSpotban

1. Jelentkezz be a HubSpotba egy super admin fiókkal.

2. Nyisd meg a Development → Legacy apps oldalt, kattints a Create legacy app gombra, és válaszd a Private típust (régebbi felületen: Settings → Integrations → Private Apps; leírás: https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview).

3. Adj az appnak nevet (például „Suara”).

4. A Scopes fülön add hozzá: crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.deals.read és crm.objects.deals.write.

5. Kattints a Create app gombra, majd az Auth fülön a Show token után másold ki az access tokent. A token pat-tal kezdődik.

2. Kösd be a Suarában

1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

2. A Katalógusban keresd meg a HubSpotot. A CRM kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

3. Kattints a Csatlakoztatás gombra. Megnyílik a „HubSpot csatlakoztatása” ablak.

4. Töltsd ki a mezőt:

   • Private App access token: a másolt token.

   A beillesztett titkos érték a Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás a szolgáltatás megfelelő oldalára visz.

5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben.

6. Kattints a Mentés és ellenőrzés gombra. A Suara lekérdezi a fiókod adatait, és ha a token érvényes, a kapcsolat HubSpot · {portál azonosító} néven megjelenik a Kapcsolataid között.

3. Használd a projektedben

Három módon használhatod a kapcsolatot:

• A chatben kérve: írd le az AI-nak, mit szeretnél, például „Az ajánlatkérő űrlap beküldésekor hozz létre vagy frissíts egy kontaktot a HubSpotban, nyiss hozzá dealt, és csatold az üzenetet jegyzetként.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

• Az Integrációk oldalról: a Kapcsolataid között a HubSpot mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

• A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A bekötés után az AI a HubSpot-hívásokat az app szerveroldali (edge function) részében generálja. A hitelesítő adatok így nem kerülnek a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt a HubSpot kapcsolatra kattintva elérhető:

• Alapadatok: az elnevezés és a láthatóság módosítása.

• Kulcsok frissítése: új token mentése, ha lecserélted vagy újrageneráltad a régit.

• Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

• Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

• Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem érik el a HubSpotot.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás

• „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy a token helyesen lett kimásolva (szóköz nélkül), és hogy pat-tal kezdődik.

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcs törölve lett, lejárt, vagy visszavonták. Generálj új tokent a Private Appban, és mentsd el a Kulcsok frissítése résznél.

• Az app nem éri el a HubSpotot: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

• A deal létrehozása egyedi pipeline-nál hibával áll meg: Az alapértelmezett pipeline és szakasz csak az alap pipeline-ban létezik. Kérd meg az AI-t, hogy a HubSpot valódi pipeline- és szakaszazonosítóit használja.

• Az írás vagy a deal létrehozása hibával áll meg: Ellenőrizd, hogy a Private App megkapta a kontaktok és dealek read és write jogosultságát.