HubSpot
Prepojenie HubSpot s Siesta AI
-
V Pripojeniach zvoľ Add Connection a vyber HubSpot.
-
Vlož Private App token (API kľúč) a nastav Shared alebo Private.
-
V HubSpote otvor Settings -> Integrations -> Private Apps a vytvor novú aplikáciu.
-
Doplň základné informácie aplikácie.
-
Nastav potrebné scopes pre CRM objekty.
-
V záložke Auth skopíruj Access token a použij ho v Siesta AI.
Prehľad
Toto Pripojenie poskytuje štandardizované rozhranie pre prácu s HubSpot CRM. Umožňuje vytváranie a čítanie základných CRM entít: Companies, Contacts, Deals a Pipelines.
Integrácia je navrhnutá ako bezstavová, deterministická a fail-fast, vhodná pre:
- CRM automatizáciu
- Synchronizáciu leadov
- Sales a revenue pipeline orchestration
- Auditovateľné enterprise workflows
Autentizácia a bezpečnosť
- Pripojenie komunikuje výhradne cez oficiálne HubSpot API.
- Autentizácia je riešená na úrovni HubSpot účtu (OAuth / Private App token).
- Žiadne citlivé dáta nie sú logované ani cachované.
- Všetky operácie bežia s oprávneniami pridelenými v HubSpote.
Prístupové práva (scopes) priamo ovplyvňujú dostupnosť operácií. Chybné scope znamenajú fail.
Podporované entity
- Company
- Contact
- Deal
- Pipeline
Každá operácia pracuje s internými ID HubSpotu, nie názvami.
1. Company Operations
1.1 CreateCompany
Popis
Vytvorí novú spoločnosť v HubSpot CRM.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| name | String | Áno | Názov spoločnosti. |
| domain | String | Áno | Doména spoločnosti (musí byť unikátna). |
Správanie
- Ak doména už existuje, operácia zlyhá.
- Nevykonáva fuzzy matching ani normalizáciu domény.
Typické použitie
- Onboarding nových zákazníkov
- Synchronizácia firiem z externých systémov
2. Contact Operations
2.1 CreateContact
Popis
Vytvorí nový kontakt v HubSpot CRM.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| String | Áno | Email kontaktu (musí byť unikátny). | |
| firstName | String | Áno | Krstné meno. |
| lastName | String | Áno | Priezvisko. |
Správanie
- Email slúži ako unikátny identifikátor.
- Duplicitný email = hard error.
2.2 GetContactByEmail
Popis
Vrátí kontakt na základe emailovej adresy.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| String | Áno |
2.3 GetContactById
Popis
Vrátí kontakt podľa jeho unikátneho HubSpot ID.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| contactId | Int64 | Áno |
2.4 GetAllContacts
Popis
Vrátí zoznam kontaktov v HubSpot CRM.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| limit | Int | Nie | Maximálny počet vrátených záznamov. |
3. Deal Operations
3.1 CreateDeal
Popis
Vytvorí nový deal a priradí ho k konkrétnemu kontaktu.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| dealName | String | Áno | Názov dealu. |
| contactId | String | Áno | Existujúce Contact ID. |
| pipelineId | Int64 | Áno | ID pipeline (nie názov). |
| stageId | Int64 | Áno | ID stage (nie názov). |
| amount | Int | Nie | Hodnota dealu. |
Správanie
- Pipeline aj stage musia existovať.
- Nevykonáva automatické mapovanie názvov na ID.
- Chybný vzťah = fail.
3.2 GetDealById
Popis
Vrátí detail dealu podľa ID.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| dealId | Int64 | Áno |
3.3 GetAllDeals
Popis
Vrátí zoznam dealov.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| limit | Int | Nie |
4. Pipeline Operations
4.1 ListAllPipelines
Popis
Vrátí všetky pipeline vrátane ich stage a zodpovedajúcich ID.
Vstupné parametre
Žiadne.
Poznámka Tento krok je povinný, ak nechceš vytvárať dealy naslepo.
5. Search Operations
5.1 SearchCompanies
Popis
Vyhľadá spoločnosti podľa názvu.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| name | String | Nie | Názov spoločnosti (bez domény). |
Obmedzenia
- Nepoužívať domény, URL ani emaily.
- Vyhľadávanie je textové, bez fuzzy matching.