HubSpot

Forbindelse af HubSpot med Siesta AI

1. I Forbindelser vælg Tilføj forbindelse og vælg HubSpot.

2. Indsæt Private App token (API-nøgle) og indstil Shared eller Private.

3. I HubSpot, åbn Indstillinger -> Integrationer -> Private Apps og opret en ny app.

4. Udfyld grundlæggende oplysninger om appen.

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

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

Oversigt

Denne forbindelse giver et standardiseret interface til arbejde med HubSpot CRM. Den muliggør oprettelse og læsning af grundlæggende CRM-enheder: Virksomheder, Kontakter, Aftaler og Pipelines.

Integration er designet som stateless, deterministisk og fail-fast, velegnet til:

• CRM-automatisering
• Synkronisering af leads
• Salg og indtægts pipeline orkestrering
• Revisionsbare enterprise workflows

Autentifikation og sikkerhed

• Forbindelsen kommunikerer udelukkende via den officielle HubSpot API.
• Autentifikation håndteres på niveauet af HubSpot-kontoen (OAuth / Private App token).
• Ingen følsomme data logges eller caches.
• Alle operationer kører med de rettigheder, der er tildelt i HubSpot.

Adgangsrettigheder (scopes) påvirker direkte tilgængeligheden af operationer. Forkert scope betyder fejl.

Understøttede enheder

• Virksomhed
• Kontakt
• Aftale
• Pipeline

Hver operation arbejder med interne ID'er fra HubSpot, ikke navne.

1. Virksomhed Operationer

1.1 OpretVirksomhed

Beskrivelse
Opretter en ny virksomhed i HubSpot CRM.

Indgangsparametre

Parameter	Type	Påkrævet	Beskrivelse
name	String	Ja	Navn på virksomheden.
domain	String	Ja	Virksomhedens domæne (skal være unikt).

Adfærd

• Hvis domænet allerede eksisterer, fejler operationen.
• Udfører ikke fuzzy matching eller normalisering af domænet.

Typisk brug

• Onboarding af nye kunder
• Synkronisering af virksomheder fra eksterne systemer

2. Kontakt Operationer

2.1 OpretKontakt

Beskrivelse
Opretter en ny kontakt i HubSpot CRM.

Indgangsparametre

Parameter	Type	Påkrævet	Beskrivelse
email	String	Ja	Kontaktens email (skal være unikt).
firstName	String	Ja	Fornavn.
lastName	String	Ja	Efternavn.

Adfærd

• Email fungerer som unik identifikator.
• Duplikeret email = hård fejl.

2.2 HentKontaktEfterEmail

Beskrivelse
Returnerer kontakt baseret på emailadresse.

Indgangsparametre

Parameter	Type	Påkrævet
email	String	Ja

2.3 HentKontaktEfterId

Beskrivelse
Returnerer kontakt baseret på dens unikke HubSpot ID.

Indgangsparametre

Parameter	Type	Påkrævet
contactId	Int64	Ja

2.4 HentAlleKontakter

Beskrivelse
Returnerer en liste over kontakter i HubSpot CRM.

Indgangsparametre

Parameter	Type	Påkrævet	Beskrivelse
limit	Int	Nej	Maksimalt antal returnerede poster.

3. Aftale Operationer

3.1 OpretAftale

Beskrivelse
Opretter en ny aftale og tildeler den til en bestemt kontakt.

Indgangsparametre

Parameter	Type	Påkrævet	Beskrivelse
dealName	String	Ja	Navn på aftalen.
contactId	String	Ja	Eksisterende Kontakt ID.
pipelineId	Int64	Ja	ID for pipeline (ikke navn).
stageId	Int64	Ja	ID for stage (ikke navn).
amount	Int	Nej	Værdi af aftalen.

Adfærd

• Pipeline og stage skal eksistere.
• Udfører ikke automatisk mapping af navne til ID'er.
• Forkert relation = fejl.

3.2 HentAftaleEfterId

Beskrivelse
Returnerer detaljerne for en aftale baseret på ID.

Indgangsparametre

Parameter	Type	Påkrævet
dealId	Int64	Ja

3.3 HentAlleAftaler

Beskrivelse
Returnerer en liste over aftaler.

Indgangsparametre

Parameter	Type	Påkrævet
limit	Int	Nej

4. Pipeline Operationer

4.1 ListeAllePipelines

Beskrivelse
Returnerer alle pipelines inklusive deres stages og tilsvarende ID'er.

Indgangsparametre
Ingen.

Bemærkning Dette trin er obligatorisk, hvis du ikke ønsker at oprette aftaler blindt.

5. Søgning Operationer

5.1 SøgVirksomheder

Beskrivelse
Søger virksomheder baseret på navn.

Indgangsparametre

Parameter	Type	Påkrævet	Beskrivelse
name	String	Nej	Navn på virksomheden (uden domæne).

Begrænsninger

• Brug ikke domæner, URL'er eller emails.
• Søgningen er tekstbaseret, uden fuzzy matching.