Integratie van Teamleader naar Pro+

Stappenplan: Teamleader-integratie voor API V2

Beschrijving 

Dit is de eerste keer dat u de integratie doet tussen Teamleader naar Pro+;

Het doel van dit document is om de stappen te beschrijven om de integratie (app-registratie) in Teamleader voor API V2 te creëren en om autorisatiecode te genereren. 

De integratie is al gebeurd met Teamleader V1 naar Pro+, maar werkt niet meer;

API V1 die in gebruik was, is verouderd en werd in 2024 beëindigd (1 augustus 2024). Voor meer details verwijzen wij u naar de link

https://developer.teamleader.eu/#/introduction/api-evolution 

 Er zijn twee belangrijke dingen: 

1. Creëer integratie in Teamleader
2. Autorisatiecode genereren. 

UITLOGGEN UIT PRO+ WEB  

Voor je aan deze procedure start moet je uitloggen uit de Pro+ web applicatie. Indien je dit niet doet zal je later de Autorisatiecode niet kunnen aanmaken! 

Integratie maken in Teamleader 

Raadpleeg de onderstaande stappen om de integratie in Teamleader te creëren: 

• Log in op Teamleader met een beheerdersgebruikersaccount. Selecteer Instellingen > Integraties > Wijzig je voorkeuren (volgens de onderstaande schermafbeelding.) 

Je wordt doorgestuurd naar de pagina waar alle huidige integraties worden vermeld. Om de nieuwe integratie te creëren, klikt u op de optie BOUW in het hoofdmenu. 

Klik in het volgende scherm op de knop 'BOUW JE INTEGRATIES'. 

Op het volgende scherm worden uw bestaande integraties weergegeven. Scroll naar beneden en klik op de knop 'MAAK INTEGRATIE AAN. 

Vul in het volgende scherm de naam van de integratie in. Bijvoorbeeld 'Testo Pro+ Sync'. Houd er rekening mee dat limiet aantal tekens voor de naam van de integratie 25 is. Klik op de knop 'INTEGRATIE MAKEN'.  

Op de volgende pagina moet u eerst de waarden van Client ID en Client Secret ophalen/kopiëren onder het gedeelte 'OAuth2-inloggegevens' voor toekomstig gebruik en om op te slaan in de Pro+ applicatie. U kunt Toegestane redirect URI's' leeg laten. Zowel Client ID als Client Secret moeten 32 tekens lang zijn. 

U moet OAuth-scopes selecteren volgens de onderstaande schermafbeelding: 

Selecteer de opties 'Bedrijven', 'Contacten' en 'Departementen' in OAuth-bereiken

Voer een korte beschrijving en een lange beschrijving van de integratie in de Engelse taal in. Een korte beschrijving kan zijn: “Testo Pro+ Sync”. Een lange beschrijving kan zijn: “Bedrijven en contacten synchroniseren van Teamleader naar Testo Pro+”. 

Overige informatie kunt u leeg laten. Klik op de knop ‘AANPASSINGEN OPSLAAN’. Het bericht “Succesvol opgeslagen” verschijnt rechtsonder. 

Nu is uw nieuwe integratie gemaakt. Vervolgens moet u autorisatiecode genereren. 

Autorisatiecode genereren 

Vervang de waarde van <client_id> (die uit de bovenstaande stap is genoteerd) in de onderstaande URL. https://focus.teamleader.eu/oauth2/authorize?client_id=<client_id>&response_type=code& redirect_uri=https://app.testocloud.be/ o 

VOORBEELD maar niet hergebruiken: https://focus.teamleader.eu/oauth2/authorize?client_id=74db53122ef0913c240ffee da65c9e2a&response_type=code&redirect_uri=https://app.testocloud.be/ 

Nadat u de waarde van <client_id> heeft vervangen, opent u de URL in de browser. Je moet inloggen in Teamleader met een beheerdersaccount. 

U moet de toegang tot de integratie autoriseren. Dit is een eenmalige activiteit. Klik op de knop 'GEEF TOEGANG' om toegang te verlenen tot de toegangen die in de integratie zijn gedefinieerd. 

U wordt doorgestuurd naar de Testo Pro+ applicatie. Kopieer en noteer de autorisatiecode uit de queryreeks in de omgeleide URL. Neem de volledige waarde die beschikbaar is na 'code=' in de omgeleide URL. 

• Indien je dit login scherm niet ziet en zonder inloggen in de Pro+ applicatie bent beland dan moet je eerst uitloggen uit Pro+ en erna terug op knop “Geef toegang” drukken. Anders zal je nooit de URL hieronder te zien krijgen waarmee je de code kan kopiëren. 

Nu moet je inloggen in Pro+ Web applicatie en als laatste stap moet u de klant-ID, het klantgeheim en de autorisatiecode opslaan in de Pro+ applicatie. 

→Log in op de Pro+ applicatie met behulp van een klantgebruikersaccount. 

→Selecteer de optie 'Veiligingssleutel' onder het menu 'Administratief'. 

Selecteer vervolgens onder het gedeelte 'TL Group' de optie 'V2' voor de API-versie. Voeg Client-ID, Client Secret en autorisatiecode toe in de betreffende velden. Klik op de knop 'Opslaan' om de gegevens op te slaan. 

acht tot 5 minuten. Vernieuw de pagina. De status van de Teamleader-authenticatie (Success = geslaagd of Failed = mislukt) wordt weergegeven in het veld "Auth Status". 

 

Belangrijke opmerking: de Teamleader autorisatiecode is slechts 10 minuten geldig. De autorisatiecode moet zo snel mogelijk (binnen 5-10 minuten) na het genereren worden gekopieerd en opgeslagen in Pro+. Je moet ook steeds eerst uitloggen uit Pro+ voor je de code kan aanmaken