HubSpot

Anslutning av HubSpot till Siesta AI

1. I Anslutningar välj Lägg till anslutning och välj HubSpot.

2. Klistra in Private App-token (API-nyckel) och ställ in Delad eller Privat.

3. I HubSpot, öppna Inställningar -> Integrationer -> Privata appar och skapa en ny app.

4. Fyll i grundläggande information om appen.

5. Ställ in nödvändiga scopes för CRM-objekt.

6. I fliken Auth kopiera Access token och använd det i Siesta AI.

Översikt

Denna anslutning tillhandahåller ett standardiserat gränssnitt för arbete med HubSpot CRM. Den möjliggör skapande och läsning av grundläggande CRM-enheter: Företag, Kontakter, Affärer och Pipelines.

Integrationen är utformad som stateless, deterministisk och fail-fast, lämplig för:

• CRM-automatisering
• Synkronisering av leads
• Försäljnings- och intäktspipeline-orchestration
• Revisionsbara företagsarbetsflöden

Autentisering och säkerhet

• Anslutningen kommunicerar uteslutande via det officiella HubSpot API:et.
• Autentisering hanteras på nivå med HubSpot-konto (OAuth / Private App-token).
• Inga känsliga data loggas eller cachas.
• Alla operationer körs med de behörigheter som tilldelats i HubSpot.

Åtkomsträttigheter (scopes) påverkar direkt tillgängligheten av operationer. Felaktiga scopes innebär fail.

Stödda enheter

• Företag
• Kontakt
• Affär
• Pipeline

Varje operation arbetar med interna ID:n från HubSpot, inte namn.

1. Företagsoperationer

1.1 SkapaFöretag

Beskrivning
Skapar ett nytt företag i HubSpot CRM.

Ingångsparametrar

Parameter	Typ	Obligatorisk	Beskrivning
name	String	Ja	Företagsnamn.
domain	String	Ja	Företagets domän (måste vara unik).

Beteende

• Om domänen redan finns, misslyckas operationen.
• Utför ingen fuzzy matching eller normalisering av domänen.

Typisk användning

• Onboarding av nya kunder
• Synkronisering av företag från externa system

2. Kontaktoperationer

2.1 SkapaKontakt

Beskrivning
Skapar en ny kontakt i HubSpot CRM.

Ingångsparametrar

Parameter	Typ	Obligatorisk	Beskrivning
email	String	Ja	Kontaktens e-post (måste vara unik).
firstName	String	Ja	Förnamn.
lastName	String	Ja	Efternamn.

Beteende

• E-post fungerar som unik identifierare.
• Duplicerad e-post = hårt fel.

2.2 HämtaKontaktGenomE-post

Beskrivning
Returnerar kontakt baserat på e-postadress.

Ingångsparametrar

Parameter	Typ	Obligatorisk
email	String	Ja

2.3 HämtaKontaktGenomId

Beskrivning
Returnerar kontakt baserat på dess unika HubSpot-ID.

Ingångsparametrar

Parameter	Typ	Obligatorisk
contactId	Int64	Ja

2.4 HämtaAllaKontakter

Beskrivning
Returnerar en lista över kontakter i HubSpot CRM.

Ingångsparametrar

Parameter	Typ	Obligatorisk	Beskrivning
limit	Int	Nej	Maximalt antal returnerade poster.

3. Affärsoperationer

3.1 SkapaAffär

Beskrivning
Skapar en ny affär och kopplar den till en specifik kontakt.

Ingångsparametrar

Parameter	Typ	Obligatorisk	Beskrivning
dealName	String	Ja	Affärens namn.
contactId	String	Ja	Existerande kontakt-ID.
pipelineId	Int64	Ja	Pipeline-ID (inte namn).
stageId	Int64	Ja	Stage-ID (inte namn).
amount	Int	Nej	Affärens värde.

Beteende

• Pipeline och stage måste existera.
• Utför ingen automatisk mappning av namn till ID.
• Felaktig relation = misslyckande.

3.2 HämtaAffärGenomId

Beskrivning
Returnerar detaljer om affären baserat på ID.

Ingångsparametrar

Parameter	Typ	Obligatorisk
dealId	Int64	Ja

3.3 HämtaAllaAffärer

Beskrivning
Returnerar en lista över affärer.

Ingångsparametrar

Parameter	Typ	Obligatorisk
limit	Int	Nej

4. Pipelineoperationer

4.1 ListaAllaPipelines

Beskrivning
Returnerar alla pipelines inklusive deras stages och motsvarande ID:n.

Ingångsparametrar
Inga.

Notering Detta steg är obligatoriskt om du inte vill skapa affärer i blindo.

5. Sökoperationer

5.1 SökFöretag

Beskrivning
Söker företag baserat på namn.

Ingångsparametrar

Parameter	Typ	Obligatorisk	Beskrivning
name	String	Nej	Företagsnamn (utan domän).

Begränsningar

• Använd inte domäner, URL:er eller e-postadresser.
• Sökningen är textbaserad, utan fuzzy matching.