URL-parameters voor nieuwe relaties in de Climatools CRM

URL-parameters zijn kleine stukjes informatie die aan het einde van een webadres (URL) worden toegevoegd om gegevens van de ene pagina of het ene systeem naar het andere door te geven. Ze komen na een vraagteken (?) en worden geschreven als sleutel-waardeparen, bijvoorbeeld: ?name=Jan&age=30. Elke sleutel staat voor een veld (zoals “name”), en elke waarde voor de bijbehorende gegevens (“Jan”). Meerdere parameters worden gescheiden door een ampersand (&). Ze worden vaak gebruikt om zoekresultaten te filteren, formulieren vooraf in te vullen of gegevens automatisch tussen systemen door te geven zonder handmatige invoer.

Bij Climatools gebruiken we URL-parameters om velden automatisch vooraf in te vullen bij het aanmaken van nieuwe items, zoals een CRM-relatie, CRM-bedrijf, gas installatie, koelinstallatie of overige installatie. Dit maakt integraties eenvoudiger en vermindert handmatig invoerwerk.

Met URL-parameters kun je het Nieuwe relatie-formulier vooraf invullen. Dit versnelt importflows vanuit andere systemen of spreadsheets.

Info/zelf-documenterend scherm
Ga naar:

https://JOUW_OMGEVING.climatools.nl/relations/add?form=info

Daar zie je alle ondersteunde parameters, types en voorbeelden.

Snelstart (met adres)

Voorbeeld van een simpel CRM relatie (inclusief adres) (URL decoded)

https://JOUW_OMGEVING.climatools.nl/relations/add?first_name=Jan&last_name=Janssen&email=jan.janssen@example.com&gender=male&can_login=true&phone_country=NL&phone=+31201234567&notes=Aangemaakt via integratie&addresses=[{"type_id":1,"street":"Damrak","street_number":"1","zipcode":"1012LG","city":"Amsterdam","country":"NL"}]

Voorbeeld van een simpel CRM relatie (inclusief adres) (URL encoded)

https://JOUW_OMGEVING.climatools.nl/relations/add?first_name=Jan&last_name=Janssen&email=jan.janssen%40example.com&gender=male&can_login=true&phone_country=NL&phone=%2B31201234567&notes=Aangemaakt%20via%20integratie&addresses=%5B%7B%22type_id%22%3A1%2C%22street%22%3A%22Damrak%22%2C%22street_number%22%3A%221%22%2C%22zipcode%22%3A%221012LG%22%2C%22city%22%3A%22Amsterdam%22%2C%22country%22%3A%22NL%22%7D%5D

• addresses is een URL-gecodeerde JSON-array met minimaal één adresobject.

• type_id voor adres: 1=Bezoekadres, 2=Postadres, 3=Factuuradres.

• country, phone_country gebruiken ISO alpha-2 (bijv. NL, BE, DE).

• can_login moet als string worden doorgegeven: true/false. Dit is de trigger voor klantentoegang

Kernparameters

Voor alle beschikbare parameters ga dan via de volgende URL: 

https://JOUW_OMGEVING.climatools.nl/relations/add?form=info

Minimaal adresobject (niet-gecodeerd)

[
  {
    "type_id": 1,
    "street": "Damrak",
    "street_number": "1",
    "zipcode": "1012LG",
    "city": "Amsterdam",
    "country": "NL"
  }
]

Tips & fouten voorkomen

• JSON altijd URL-encoden.

• E-mail en plus-tekens in telefoonnummers encoden (@ → %40, + → %2B).

• Onbekende parameters worden genegeerd; geldige velden worden netjes ingevuld.

• Meerdere adressen? Voeg meerdere objecten toe aan dezelfde JSON-array.