HubSpot

HubSpotin yhdistäminen Siesta AI:hin

1. Valitse Yhteydet ja valitse Lisää yhteys ja valitse HubSpot.

2. Syötä Private App token (API-avain) ja määritä Shared tai Private.

3. Avaa HubSpotissa Asetukset -> Integraatiot -> Private Apps ja luo uusi sovellus.

4. Täydennä sovelluksen perus tiedot.

5. Määritä tarvittavat scopes CRM-objekteille.

6. Kopioi Access token Auth-välilehdeltä ja käytä sitä Siesta AI:ssa.

Yhteenveto

Tämä Yhteys tarjoaa standardoidun rajapinnan HubSpot CRM:n kanssa työskentelyyn. Se mahdollistaa perus CRM-entiteettien, kuten Companies, Contacts, Deals ja Pipelines, luomisen ja lukemisen.

Integraatio on suunniteltu tilattomaksi, deterministiseksi ja fail-fast -periaatteella, ja se soveltuu:

• CRM-automaatiolle
• Liidien synkronoinnille
• Myynti- ja tuloputkien orkestroinnille
• Auditointikelpoisille yritysprosesseille

Varmennus ja turvallisuus

• Yhteys kommunikoi yksinomaan virallisen HubSpot API:n kautta.
• Varmennus hoidetaan HubSpot-tilin tasolla (OAuth / Private App token).
• Herkkiä tietoja ei tallenneta tai välimuistissa.
• Kaikki toiminnot suoritetaan HubSpotissa myönnetyillä käyttöoikeuksilla.

Käyttöoikeudet (scopes) vaikuttavat suoraan toimintojen saatavuuteen. Virheellinen scope tarkoittaa epäonnistumista.

Tuetut entiteetit

• Company
• Contact
• Deal
• Pipeline

Jokainen toiminto työskentelee HubSpotin sisäisten ID:iden kanssa, ei nimien kanssa.

1. Company Operations

1.1 CreateCompany

Kuvaus
Luo uusi yritys HubSpot CRM:ssä.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
name	String	Kyllä	Yrityksen nimi.
domain	String	Kyllä	Yrityksen verkkotunnus (täytyy olla ainutlaatuinen).

Käyttäytyminen

• Jos verkkotunnus on jo olemassa, toiminto epäonnistuu.
• Ei suorita fuzzy matchingia tai verkkotunnuksen normalisointia.

Tyypillinen käyttö

• Uusien asiakkaiden perehdyttäminen
• Yritysten synkronointi ulkoisista järjestelmistä

2. Contact Operations

2.1 CreateContact

Kuvaus
Luo uusi yhteystieto HubSpot CRM:ssä.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
email	String	Kyllä	Yhteystiedon sähköposti (täytyy olla ainutlaatuinen).
firstName	String	Kyllä	Etunimi.
lastName	String	Kyllä	Sukunimi.

Käyttäytyminen

• Sähköposti toimii ainutlaatuisena tunnisteena.
• Kaksoissähköposti = vakava virhe.

2.2 GetContactByEmail

Kuvaus
Palauttaa yhteystiedon sähköpostiosoitteen perusteella.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
email	String	Kyllä

2.3 GetContactById

Kuvaus
Palauttaa yhteystiedon sen ainutlaatuisen HubSpot ID:n perusteella.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
contactId	Int64	Kyllä

2.4 GetAllContacts

Kuvaus
Palauttaa luettelon yhteystiedoista HubSpot CRM:ssä.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
limit	Int	Ei	Suurin palautettavien tietueiden määrä.

3. Deal Operations

3.1 CreateDeal

Kuvaus
Luo uusi kauppa ja liittää sen tiettyyn yhteystietoon.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
dealName	String	Kyllä	Kaupan nimi.
contactId	String	Kyllä	Olemassa oleva Contact ID.
pipelineId	Int64	Kyllä	Pipeline ID (ei nimi).
stageId	Int64	Kyllä	Stage ID (ei nimi).
amount	Int	Ei	Kaupan arvo.

Käyttäytyminen

• Pipeline ja stage on oltava olemassa.
• Ei suorita automaattista nimien kartoitusta ID:ihin.
• Virheellinen suhde = epäonnistuminen.

3.2 GetDealById

Kuvaus
Palauttaa kaupan yksityiskohdat ID:n perusteella.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
dealId	Int64	Kyllä

3.3 GetAllDeals

Kuvaus
Palauttaa luettelon kaupoista.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen
limit	Int	Ei

4. Pipeline Operations

4.1 ListAllPipelines

Kuvaus
Palauttaa kaikki putket niiden vaiheineen ja vastaavine ID:ineen.

Syöttöparametrit
Ei mitään.

Huomautus Tämä vaihe on pakollinen, jos et halua luoda kauppoja sokkona.

5. Search Operations

5.1 SearchCompanies

Kuvaus
Hakee yrityksiä nimen perusteella.

Syöttöparametrit

Parametri	Tyyppi	Pakollinen	Kuvaus
name	String	Ei	Yrityksen nimi (ilman verkkotunnusta).

Rajoitukset

• Älä käytä verkkotunnuksia, URL-osoitteita tai sähköposteja.
• Haku on tekstipohjaista, ilman fuzzy matchingia.