n8n-integratie

n8n is een tool voor workflowautomatisering die je op n8n Cloud kunt draaien of zelf kunt hosten. Door het aan Personyze te koppelen, bouw je workflows op je account — contacten, segmenten, aankopen en verzamelde leads synchroniseren — met de mogelijkheid om alles binnen je eigen infrastructuur te houden.

Personyze heeft geen eigen n8n-app — je koppelt via de algemene HTTP-requestmodule van n8n en een Personyze-API-sleutel. Dat klinkt als meer werk dan het is: elk Personyze-endpoint is een gewone HTTPS-aanroep met Basic-authenticatie, dus één ingestelde koppeling geeft je de hele API.

In het panel: Instellingen › Integraties › n8n.

Een sleutel krijgen

1. Open Instellingen › Integraties en klik op Configureren op de kaart van n8n.
2. Klik op Nieuwe sleutel genereren en kopieer de waarde.
3. Bewaar hem veilig — iedereen die een sleutel heeft, kan als je account handelen. Een sleutel hier intrekken stopt meteen alles wat hem nog gebruikt.

Dit zijn dezelfde sleutels als voor de Full-featured API en Zapier. Een sleutel die op een van die kaarten is gegenereerd, verschijnt op alle kaarten en authenticeert elk endpoint. Het blijft de moeite waard om per automatisering een aparte sleutel te genereren, zodat je er een kunt intrekken zonder de andere te breken.

Koppelen in n8n

Voeg een node HTTP Request toe en maak een credential Basic Auth aan:

• Authenticatie: Basic auth
• Gebruikersnaam: api
• Wachtwoord: de sleutel die je hebt gegenereerd
• Basis-URL: https://app.personyze.com/rest/

Sommige tools gebruiken liever inloggegevens in de URL, en dat werkt ook:

https://api:YOUR_API_KEY@app.personyze.com/rest/users/where/email=john@example.com

Sla het op als herbruikbare credential in n8n, zodat elke HTTP Request-node in de workflow die kan kiezen, in plaats van de sleutel in elke node te plakken.

Opmerking over zelf hosten. Personyze hoeft je n8n-instantie voor deze aanroepen niet te bereiken — je workflow roept Personyze aan, dus een zelf gehoste n8n achter een firewall werkt zonder inkomende toegang. Dat verandert alleen als je later een Personyze-webhook toevoegt die naar n8n wijst; die heeft wel een bereikbare URL nodig.

Wat je kunt aanroepen

Alles in de REST API. De gebruikelijke vormen van automatisering:

• Een contact naar Personyze sturen — POST /rest/users met een email. Hetzelfde e-mailadres opnieuw sturen voegt samen in plaats van te dupliceren, dus een workflow die herhaaldelijk draait, blijft veilig.
• Iemand aan een segment toevoegen — POST /rest/user_list_users met user_list_id en user_email.
• Een aankoop melden — POST /rest/products_interactions.
• Verzamelde leads ophalen — GET /rest/forms, pagineren op time.
• Campagneresultaten ophalen — GET /rest/summary_actions.

Volledige naslag: overzicht van de REST API, padparameters, en fouten, limieten en opnieuw proberen. De integratiehandleiding behandelt het gedrag dat de moeite waard is om te kennen voordat je een synchronisatielus bouwt.

Twee dingen die je anders opbreken

• Identificeer je gebruikers op email. Dat is de identificator die bij een bestaand profiel past. Een workflow die op je eigen internal_id is gebaseerd, maakt bij elke run een nieuwe gebruiker aan.
• Foutantwoorden zijn platte tekst, geen JSON. Een module die elk antwoord als JSON verwerkt, loopt vast op de fout en verbergt de eigenlijke melding. Controleer de statuscode: 400 betekent dat het verzoek niet klopt en opnieuw proberen niet helpt, 503 is het waard om opnieuw te proberen met backoff.

Gerelateerd

• Make-integratie
• Zapier-integratie
• Full-featured API