Med Groweos GET API kan du hämta kontakter från Groweo® Contacts till HubSpot utan manuell dataöverföring.

Integrationen hämtar kontakterna från Groweo med en API-token och skapar eller uppdaterar motsvarande kontakter i HubSpot.

Groweos API är skrivskyddat. Det kan inte användas för att skapa, redigera eller radera kontakter i Groweo. Groweo skickar inte heller automatiskt kontaktdata till HubSpot.

Det finns två huvudsakliga sätt att bygga integrationen:

HubSpot Workflows + Custom code
en extern integration via HubSpot API

En HubSpot-baserad lösning passar när abonnemanget innehåller Custom code och datamängden är hanterbar. Vid större kontaktmängder eller mer avancerade behov ger en extern integration större flexibilitet.

Innan du börjar

Du behöver:

en Groweo API-token
åtkomst till HubSpots integrations- och property-inställningar
en fältmappning mellan Groweo och HubSpot
autentisering för HubSpot API
ett HubSpot-abonnemang som stöder Custom code om du väljer workflow-alternativet.

1. Hämta din Groweo API-token

Endpointen är:

GET https://engine.groweo.com/engine/api/client-api/contacts

Exempel:

?page=1&limit=50&populateModuleData=true

API-token skickas i:

x-client-api-token: <API_TOKEN>

Testa anropet innan du bygger integrationen och kontrollera JSON-datan från din egen Groweo-miljö.

2. Skapa en Groweo ID-property i HubSpot

Om Groweo-svaret innehåller en stabil unik kontaktidentifierare kan den användas för att matcha kontakterna mellan systemen.

Skapa exempelvis:

Groweo ID

med internal name:

groweo_id

Konfigurera värdena som unika.

Obs: Kontrollera först att Groweos faktiska API-svar innehåller en identifierare som lämpar sig för detta.

Alternativ 1: HubSpot Workflows + Custom code

HubSpots Custom code-action kan köra JavaScript eller Python och göra HTTP-anrop till externa tjänster som Groweos API.

3. Spara Groweo API-token som en secret

Lägg inte API-token direkt i koden.

Spara den i Custom code-actionens Secrets, exempelvis som:

GROWEO_API_TOKEN

4. Hämta kontakterna från Groweo

Låt först koden hämta data och kontrollera det faktiska JSON-svaret innan du bygger fältmappningen.

5. Definiera fältmappningen

En möjlig mappning är:

Data i Groweo	HubSpot
unik kontaktidentifierare	Groweo ID
förnamn	First name
efternamn	Last name
e-postadress	Email
telefonnummer	Phone number
företagsnamn	Company name

Detta är ett exempel, inte en definition av Groweos API-schema.

6. Skapa eller uppdatera kontakter

HubSpots CRM API stöder batch upsert.

Om groweo_id är en unik property kan logiken vara:

Groweo ID finns i HubSpot
        ↓
uppdatera kontakten

Groweo ID finns inte
        ↓
skapa kontakten

Anpassa alltid requesten efter den faktiska data som Groweo returnerar.

7. Hantera paginering

Groweos API använder:

?page=1&limit=50

Hämta följande sidor när det behövs och bestäm slutvillkoret utifrån det faktiska API-svaret.

8. Schemalägg synkroniseringen

HubSpot-workflows kan startas enligt ett schema. Återkommande dagliga, veckovisa eller månatliga workflows kräver för närvarande HubSpot Data Hub Professional eller Enterprise.

Tänk på att schemalagda workflows arbetar med CRM-poster. Bygg därför lösningen så att synkroniseringen bara körs en gång per avsett synkroniseringstillfälle.

Alternativ 2: Extern integration

För större datamängder kan synkroniseringen köras i en extern tjänst.

Schemalagd integration
        ↓
Groweo GET API
        ↓
bearbetning
        ↓
HubSpot CRM API
        ↓
batch upsert

9. Autentisera mot HubSpot

För en ny system-till-system-integration ska du använda HubSpots aktuella autentiseringsalternativ för den här typen av API-åtkomst, exempelvis Service Key där funktionen finns tillgänglig i ditt HubSpot-konto.

Förvara credentialen som en secret i integrationsmiljön, inte i källkoden.

Om du redan har en integration som använder HubSpot Private App bör du kontrollera aktuellt stöd och eventuella migreringskrav i din HubSpot-miljö.

10. Hantera alla Groweo-kontakter

Integrationen ska hämta varje relevant Groweo-sida, mappa datan till HubSpot-properties och skicka kontakterna vidare till HubSpot.

En stabil Groweo-identifierare som unik HubSpot-property hjälper till att förhindra dubbletter.

Så fungerar integrationen

GROWEO®
   │
   │ GET
   ▼
Contacts API
   │
x-client-api-token
   │
   ▼
Integration
   │
fältmappning
   ▼
HubSpot CRM API
   │
batch upsert
   ▼
HUBSPOT CRM

Så hämtar du Groweo®-kontakter till HubSpot via API