Wat het doet
- contacts:write: contacten en leads aanmaken.
- messages:write: berichten en notities aan gesprekken toevoegen.
- conversations:read: gesprekken opvragen.
- webhooks:write: triggers aanmelden (REST hooks voor Zapier en Make).
Wat je nodig hebt
- Een werkruimte waarin je eigenaar of admin bent.
- Een ontwikkelaar of een tool als Zapier of Make die HTTP-verzoeken kan doen.
Een sleutel aanmaken
Stap 1: Open API-sleutels
Ga naar "Integraties" en klik op de kaart "API-sleutels (acties)" op "Instellen".
Stap 2: Geef een naam en kies de rechten
Vul bij "Naam" in waarvoor de sleutel is (bijvoorbeeld "Zapier") en vink onder "Rechten" alleen aan wat nodig is. Klik op "Sleutel aanmaken".
Stap 3: Bewaar de sleutel
De sleutel (begint met twk_) wordt één keer getoond. Kopieer hem naar je wachtwoordkluis of tool en klik op "Ik heb de sleutel bewaard".
Regels en instellingen
- Geef elke tool een eigen sleutel, zodat je er één kunt intrekken zonder de rest te raken.
- Met "Intrekken" werkt een sleutel direct niet meer.
- Onder "Beschikbare acties (REST API)" in de wizard staan de endpoints (contacten, gesprekken, berichten en notities); de volledige beschrijving staat op twilper.com/integrations/api.
- Maximaal 20 actieve sleutels en 120 verzoeken per minuut per werkruimte.
Testen
- Onder "Snel testen" in de wizard staat een kant-en-klaar curl-commando: GET https://api.twilper.com/api/v1/me met de header Authorization: Bearer twk_…
- Een 200-antwoord betekent dat de sleutel werkt.
Veelvoorkomende problemen
- 401: de sleutel klopt niet of is ingetrokken.
- 403: de sleutel mist het recht voor deze actie. Maak een nieuwe sleutel met het juiste recht.
- Sleutel kwijt: hij is niet opnieuw op te vragen. Trek hem in en maak een nieuwe.
Goed om te weten
- Bewaar sleutels nooit in de broncode van je website: iedereen kan die lezen.