HubSpot Connector
Propojení HubSpot s Siesta AI
-
V Konektory zvol Add Connection a vyber HubSpot.
-
Vlož Private App token (API key) a nastav Shared nebo Private.
-
V HubSpotu otevři Settings -> Integrations -> Private Apps a vytvoř novou aplikaci.
-
Doplň základní informace aplikace.
-
Nastav potřebné scopes pro CRM objekty.
-
V záložce Auth zkopíruj Access token a použij ho v Siesta AI.
Přehled
Tento konektor poskytuje standardizované rozhraní pro práci s HubSpot CRM. Umožňuje vytváření a čtení základních CRM entit: Companies, Contacts, Deals a Pipelines.
Integrace je navržena jako bezstavová, deterministická a fail-fast, vhodná pro:
- CRM automatizaci
- Synchronizaci leadů
- Sales a revenue pipeline orchestration
- Auditovatelná enterprise workflow
Autentizace a bezpečnost
- Konektor komunikuje výhradně přes oficiální HubSpot API.
- Autentizace je řešena na úrovni HubSpot účtu (OAuth / Private App token).
- Žádná citlivá data nejsou logována ani cachována.
- Všechny operace běží s oprávněními přidělenými v HubSpotu.
Přístupová práva (scopes) přímo ovlivňují dostupnost operací. Chybné scope znamenají fail.
Podporované entity
- Company
- Contact
- Deal
- Pipeline
Každá operace pracuje s interními ID HubSpotu, nikoliv názvy.
1. Company Operations
1.1 CreateCompany
Popis
Vytvoří novou společnost v HubSpot CRM.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| name | String | Ano | Název společnosti. |
| domain | String | Ano | Doména společnosti (musí být unikátní). |
Chování
- Pokud doména již existuje, operace selže.
- Neprovádí fuzzy matching ani normalizaci domény.
Typické použití
- Onboarding nových zákazníků
- Synchronizace firem z externích systémů
2. Contact Operations
2.1 CreateContact
Popis
Vytvoří nový kontakt v HubSpot CRM.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| String | Ano | Email kontaktu (musí být unikátní). | |
| firstName | String | Ano | Křestní jméno. |
| lastName | String | Ano | Příjmení. |
Chování
- Email slouží jako unikátní identifikátor.
- Duplicitní email = hard error.
2.2 GetContactByEmail
Popis
Vrátí kontakt na základě emailové adresy.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| String | Ano |
2.3 GetContactById
Popis
Vrátí kontakt podle jeho unikátního HubSpot ID.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| contactId | Int64 | Ano |
2.4 GetAllContacts
Popis
Vrátí seznam kontaktů v HubSpot CRM.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| limit | Int | Ne | Maximální počet vrácených záznamů. |
3. Deal Operations
3.1 CreateDeal
Popis
Vytvoří nový deal a přiřadí jej ke konkrétnímu kontaktu.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| dealName | String | Ano | Název dealu. |
| contactId | String | Ano | Existující Contact ID. |
| pipelineId | Int64 | Ano | ID pipeline (ne název). |
| stageId | Int64 | Ano | ID stage (ne název). |
| amount | Int | Ne | Hodnota dealu. |
Chování
- Pipeline i stage musí existovat.
- Neprovádí automatické mapování názvů na ID.
- Chybný vztah = fail.
3.2 GetDealById
Popis
Vrátí detail dealu podle ID.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| dealId | Int64 | Ano |
3.3 GetAllDeals
Popis
Vrátí seznam dealů.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| limit | Int | Ne |
4. Pipeline Operations
4.1 ListAllPipelines
Popis
Vrátí všechny pipeline včetně jejich stage a odpovídajících ID.
Vstupní parametry
Žádné.
Poznámka Tento krok je povinný, pokud nechceš vytvářet dealy naslepo.
5. Search Operations
5.1 SearchCompanies
Popis
Vyhledá společnosti podle názvu.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| name | String | Ne | Název společnosti (bez domény). |
Omezení
- Nepoužívat domény, URL ani emaily.
- Vyhledávání je textové, bez fuzzy matching.