Hämta Groweo-kontakter till Pipedrive via API

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

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

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 Pipedrive.

I den här guiden använder vi en extern integration som kopplar Groweos GET API till Pipedrives REST API.

Vänligen notera: Groweo planerar eller implementerar inte integrationer. Vi tillhandahåller API:et och API-nyckeln som behövs för att planera och implementera hämtning av kontakter.

Innan du börjar

Du behöver:

en Groweo API-token
en Pipedrive API-token eller OAuth-anslutning
behörighet att skapa egna Person-fält
en fältmappning mellan Groweo och Pipedrive
en miljö där integrationen kan köras enligt ett schema.

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 och kontrollera JSON-svaret innan du bygger Pipedrive-mappningen.

2. Välj autentisering för Pipedrive

Pipedrive stöder autentisering med API-token och OAuth 2.0.

För ett företags egen integration kan en Pipedrive API-token användas. Token skickas i headern:

x-api-token: <PIPEDRIVE_API_TOKEN>

Förvara båda tokenvärdena säkert:

GROWEO_API_TOKEN
PIPEDRIVE_API_TOKEN

Lägg dem inte direkt i källkoden.

Om du bygger en applikation för flera Pipedrive-kunder ska du använda OAuth 2.0.

3. Skapa ett Groweo ID-fält

Kontakter lagras som Person-poster i Pipedrive.

Skapa ett eget Person-fält, exempelvis:

Groweo ID

Textfältets API-typ är:

varchar

Om Groweos API innehåller en stabil unik kontaktidentifierare sparar du den i detta fält.

4. Hämta custom field-koden

Pipedrives custom fields har egna API-koder.

Hämta Person-fälten med:

GET /api/v2/personFields

och använd det field_code som returneras för Groweo ID-fältet.

5. Hämta kontakter från Groweo

Låt integrationen hämta den första sidan och kontrollera det faktiska JSON-svaret innan Pipedrive-mappningen byggs.

6. Definiera fältmappningen

En möjlig mappning är:

Data i Groweo	Pipedrive Person
unik kontaktidentifierare	Groweo ID
namn	Name
e-postadress	Email
telefonnummer	Phone
företagsnamn	Organization
övriga Groweo-data	egna Person-fält

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

7. Kontrollera om personen redan finns

Pipedrive har inget direkt Person upsert-endpoint för detta flöde.

Sök först efter Groweo ID via:

GET /api/v2/persons/search

Exempel:

term=<GROWEO_ID>
fields=custom_fields
exact_match=true

Logiken blir:

Groweo-kontakt
        ↓
sök med Groweo ID
        ↓
      hittad?
     ↙       ↘
    ja        nej
    ↓          ↓
 PATCH        POST
 Person       Person

Kontrollera att den returnerade posten faktiskt innehåller rätt Groweo ID innan den uppdateras.

8. Skapa en ny Person

Om ingen matchning finns använder du:

POST /api/v2/persons

Använd den field_code som tillhör Groweo ID-fältet när identifieraren sparas i custom_fields.

9. Uppdatera en befintlig Person

Om en matchande Person hittas använder du dess Pipedrive-ID:

PATCH /api/v2/persons/{id}

Skicka endast de fält som integrationen ska uppdatera.

10. Hantera Organizations separat

Företag lagras som separata Organization-poster i Pipedrive.

Om även företagsdata ska synkroniseras behöver du definiera separat matchningslogik för Organizations.

Använd inte automatiskt företagsnamnet som permanent identifierare, eftersom flera företag kan ha samma namn.

11. Hantera paginering

Groweos API använder:

?page=1&limit=50

Hämta följande sidor tills alla relevanta kontakter har behandlats.

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

12. Schemalägg synkroniseringen

Eftersom Groweo inte automatiskt skickar ändringar till Pipedrive behöver integrationen köras enligt ett schema.

Schema
   ↓
Groweo GET API
   ↓
kontaktbearbetning
   ↓
Pipedrive Persons API
   ↓
create / update

13. Ta hänsyn till Pipedrives API-gränser

Pipedrive använder tokenbaserade API-gränser. Anrop förbrukar företagets dagliga tokenbudget och omfattas även av kortsiktiga rate limits.

Använd API v2 där de funktioner du behöver finns tillgängliga och hantera 429 Too Many Requests enligt den rate limit-information som Pipedrive returnerar.

Undvik onödiga uppdateringar av oförändrade poster.

14. Lägg till felhantering

En produktionsintegration bör åtminstone hantera:

fel från Groweo API
fel från Pipedrive API
rate limit-svar
saknade eller felaktiga data
enskilda kontakter som inte kan synkroniseras.

Ett fel på en kontakt ska inte stoppa hela synkroniseringen.

15. API-token eller OAuth?

För ett enskilt företags egen integration kan Pipedrive API-token användas.

För en applikation som flera kunder kopplar till sina egna Pipedrive-konton ska OAuth 2.0 användas.

Kortfattat:

Ett företags egen integration
→ API-token är möjlig

Applikation för flera kunder
→ OAuth 2.0

Så fungerar integrationen

GROWEO®
   │
   │ GET
   ▼
Contacts API
   │
x-client-api-token
   │
   ▼
Integration
   │
fältmappning
   │
sökning med Groweo ID
   ▼
Pipedrive Persons API
   ↙             ↘
 POST           PATCH
   │              │
   └──────┬───────┘
          ▼
      PIPEDRIVE

Metadata

SEO title: Hämta Groweo-kontakter till Pipedrive via API

Meta description: Så hämtar du kontakter från Groweo Contacts till Pipedrive via API och bygger en automatiserad kontaktsynkronisering.

Schema description: Guiden visar hur kontakter från Groweo Contacts hämtas till Pipedrive via Groweos GET API. Den går igenom API-token och OAuth, Groweo ID-fältet, fältmappning, sökning, skapande och uppdatering av Pipedrive Persons, paginering, schemaläggning och API-begränsningar.

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