HubSpot

Koble HubSpot med Siesta AI

1. I Tilkoblinger velg Legg til tilkobling og velg HubSpot.

2. Lim inn Private App token (API-nøkkel) og sett til Delt eller Privat.

3. I HubSpot åpne Innstillinger -> Integrasjoner -> Private Apps og opprett en ny app.

4. Fyll ut grunnleggende informasjon om appen.

5. Sett nødvendige scopes for CRM-objekter.

6. I fanen Auth kopier Access token og bruk det i Siesta AI.

Oversikt

Denne tilkoblingen gir et standardisert grensesnitt for arbeid med HubSpot CRM. Den muliggjør oppretting og lesing av grunnleggende CRM-enheter: Selskaper, Kontakter, Avtaler og Pipelines.

Integrasjonen er designet som stateless, deterministisk og fail-fast, egnet for:

• CRM-automatisering
• Synkronisering av leads
• Salg og inntekts pipeline orkestrering
• Reviderbare bedriftsarbeidsflyter

Autentisering og sikkerhet

• Tilkoblingen kommuniserer utelukkende via det offisielle HubSpot API.
• Autentisering håndteres på nivået av HubSpot-konto (OAuth / Private App token).
• Ingen sensitive data logges eller caches.
• Alle operasjoner kjører med rettigheter tildelt i HubSpot.

Tilgangsrettigheter (scopes) påvirker direkte tilgjengeligheten av operasjoner. Feil scope betyr feil.

Støttede enheter

• Selskap
• Kontakt
• Avtale
• Pipeline

Hver operasjon arbeider med interne ID-er fra HubSpot, ikke navn.

1. Selskap Operasjoner

1.1 CreateCompany

Beskrivelse
Oppretter et nytt selskap i HubSpot CRM.

Inndata parametere

Parameter	Type	Obligatorisk	Beskrivelse
name	String	Ja	Navn på selskapet.
domain	String	Ja	Domenenavn på selskapet (må være unikt).

Atferd

• Hvis domenet allerede eksisterer, vil operasjonen feile.
• Utfører ikke fuzzy matching eller normalisering av domenet.

Typisk bruk

• Onboarding av nye kunder
• Synkronisering av selskaper fra eksterne systemer

2. Kontakt Operasjoner

2.1 CreateContact

Beskrivelse
Oppretter en ny kontakt i HubSpot CRM.

Inndata parametere

Parameter	Type	Obligatorisk	Beskrivelse
email	String	Ja	E-postadresse til kontakten (må være unik).
firstName	String	Ja	Fornavn.
lastName	String	Ja	Etternavn.

Atferd

• E-post fungerer som en unik identifikator.
• Duplisert e-post = hard feil.

2.2 GetContactByEmail

Beskrivelse
Returnerer kontakt basert på e-postadresse.

Inndata parametere

Parameter	Type	Obligatorisk
email	String	Ja

2.3 GetContactById

Beskrivelse
Returnerer kontakt basert på dens unike HubSpot ID.

Inndata parametere

Parameter	Type	Obligatorisk
contactId	Int64	Ja

2.4 GetAllContacts

Beskrivelse
Returnerer en liste over kontakter i HubSpot CRM.

Inndata parametere

Parameter	Type	Obligatorisk	Beskrivelse
limit	Int	Nei	Maksimalt antall returnerte poster.

3. Avtale Operasjoner

3.1 CreateDeal

Beskrivelse
Oppretter en ny avtale og knytter den til en spesifikk kontakt.

Inndata parametere

Parameter	Type	Obligatorisk	Beskrivelse
dealName	String	Ja	Navn på avtalen.
contactId	String	Ja	Eksisterende Kontakt ID.
pipelineId	Int64	Ja	ID for pipeline (ikke navn).
stageId	Int64	Ja	ID for stage (ikke navn).
amount	Int	Nei	Verdi av avtalen.

Atferd

• Pipeline og stage må eksistere.
• Utfører ikke automatisk kartlegging av navn til ID.
• Feil forhold = feil.

3.2 GetDealById

Beskrivelse
Returnerer detaljer om avtalen basert på ID.

Inndata parametere

Parameter	Type	Obligatorisk
dealId	Int64	Ja

3.3 GetAllDeals

Beskrivelse
Returnerer en liste over avtaler.

Inndata parametere

Parameter	Type	Obligatorisk
limit	Int	Nei

4. Pipeline Operasjoner

4.1 ListAllPipelines

Beskrivelse
Returnerer alle pipelines inkludert deres stages og tilsvarende ID-er.

Inndata parametere
Ingen.

Merk Dette trinnet er obligatorisk hvis du ikke ønsker å opprette avtaler blindt.

5. Søk Operasjoner

5.1 SearchCompanies

Beskrivelse
Søker etter selskaper basert på navn.

Inndata parametere

Parameter	Type	Obligatorisk	Beskrivelse
name	String	Nei	Navn på selskapet (uten domene).

Begrensninger

• Bruk ikke domener, URL-er eller e-poster.
• Søk er tekstbasert, uten fuzzy matching.