Hämta Groweo-kontakter till Dynamics 365 via API

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

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

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 Dynamics 365.

I den här guiden använder vi Microsoft Power Automate.

Innan du börjar

Du behöver:

en Groweo API-token
en Microsoft Dynamics 365 / Dataverse-miljö
behörighet att skapa Dataverse-kolumner och alternate keys
åtkomst till de Power Automate Premium-funktioner som implementationen kräver
en fältmappning mellan Groweo och Dynamics.

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 det faktiska JSON-svaret.

2. Skapa en Groweo ID-kolumn i Dataverse

Dynamics 365-kontakter lagras i Contact-tabellen i Microsoft Dataverse.

Om Groweos API-svar innehåller en stabil unik kontaktidentifierare skapar du en egen kolumn för den, exempelvis:

Groweo ID

med schema name:

new_groweoid

På så sätt kan samma Groweo-kontakt kopplas till samma Dynamics-post vid kommande synkroniseringar.

3. Skapa en alternate key

Öppna din Dynamics-miljö i Power Apps och gå till:

Tables
→ Contact
→ Keys
→ New key

Skapa en key som använder Groweo ID.

Då kan integrationen använda följande logik:

Groweo ID finns
        ↓
uppdatera kontakten

Groweo ID finns inte
        ↓
skapa kontakten

4. Skapa ett Power Automate-flow

Skapa ett:

Scheduled cloud flow

Grundstrukturen kan vara:

Recurrence
    ↓
HTTP-anrop till Groweo
    ↓
JSON-hantering
    ↓
kontaktbearbetning
    ↓
Dataverse

5. Lägg till HTTP-anropet

Använd:

Method:
GET

och:

https://engine.groweo.com/engine/api/client-api/contacts?page=1&limit=50&populateModuleData=true

med headern:

x-client-api-token

Kontrollera vilka Power Automate-licenser som krävs i just er Microsoft-miljö innan implementationen tas i produktion.

6. Förvara API-token säkert

Skriv inte Groweo API-token direkt i flowet.

Power Platform kan använda secrets i Azure Key Vault via environment variables av typen secret.

Secure Inputs och Secure Outputs kan dessutom användas för att förhindra att känsliga värden visas i run history.

Följ organisationens egna säkerhetsrutiner.

7. Kontrollera Groweos JSON-svar

Kör först endast HTTP-anropet och kontrollera svaret i Power Automate run history.

Lägg sedan till:

Parse JSON

baserat på det faktiska svaret.

8. Definiera fältmappningen

En möjlig mappning är:

Data i Groweo	Dynamics 365 / Dataverse
unik kontaktidentifierare	Groweo ID
förnamn	First Name
efternamn	Last Name
e-postadress	Email
telefonnummer	Business Phone eller Mobile Phone
befattning	Job Title
företagsnamn	fält eller Account-relation enligt datamodellen

Tabellen är ett exempel och beskriver inte Groweos API-schema.

9. Skapa eller uppdatera kontakterna

Alternativ A: Sök och skapa eller uppdatera

Med Microsoft Dataverse-connectorn:

kontakt hittad
→ Update a row

kontakt saknas
→ Add a new row

Alternativ B: Använd Dataverse Web API upsert

Med en alternate key kan ett PATCH-anrop användas:

PATCH
https://<organization>.crm.dynamics.com/api/data/v9.2/contacts(new_groweoid='GROWEO_ID')

Om posten finns uppdateras den. Annars skapas en ny.

10. Hantera paginering

Groweos API använder:

?page=1&limit=50

I Power Automate kan efterföljande sidor exempelvis hanteras med en Do until-loop.

Bestäm slutvillkoret utifrån det faktiska Groweo-svaret.

11. Undvik onödiga uppdateringar

Om Groweos API returnerar ett tillförlitligt värde för senaste ändring kan det användas för att identifiera ändrade kontakter.

Bygg inte logiken kring ett visst Groweo-fält innan du har verifierat att det faktiskt finns i API-svaret.

12. Lägg till felhantering

Hantera åtminstone:

fel från Groweo API
Dataverse-fel
enskilda kontakter som misslyckas
loggning och notifieringar.

13. Ta hänsyn till API- och tjänstegränser

Microsoft Dataverse och Power Automate har connector-, tjänste- och licensspecifika begränsningar.

Vid större kontaktmängder kan Dataverse Web API, upsert och batch-hantering vara effektivare än flera separata connector-anrop per kontakt.

Alternativ: extern integration

Vid större integrationsbehov kan en extern tjänst användas, exempelvis Azure Functions, Azure Logic Apps eller en egen Node.js- eller Python-tjänst.

Schemalagd integration
        ↓
Groweo GET API
        ↓
bearbetning
        ↓
Dataverse Web API
        ↓
Dynamics 365

Så fungerar integrationen

GROWEO®
   │
   │ GET
   ▼
Contacts API
   │
x-client-api-token
   │
   ▼
Power Automate
   │
JSON-hantering
   │
fältmappning
   ▼
Microsoft Dataverse
   │
Groweo ID key
   │
upsert
   ▼
DYNAMICS 365

Så hämtar du Groweo®-kontakter till Microsoft Dynamics 365 via API