Klantenservice
API, webhooks of BYOD: welke integratie heb je nodig?
Drie manieren om initdesk aan je stack te koppelen — en slechts één daarvan is de nieuwe API, vandaag live op developers.initdesk.com.
Als je initdesk-marketing hebt gelezen, heb je waarschijnlijk "connect any API" gezien. Dat betekent meestal Bring Your Own Data (BYOD): initdesk roept jouw endpoint aan zodat agents plan tier, ordergeschiedenis of gebruik naast een ticket zien.
Vandaag lanceren we iets anders: de initdesk API en developer docs op developers.initdesk.com. Je systemen kunnen initdesk nu aanroepen op
https://api.initdesk.com om tickets, requesters, conversaties en Help Center-content te lezen en schrijven — het ondersteunde oppervlak voor CRM's, interne tools, automatisering en custom portals.Drie integratiepaden. Drie richtingen van data. Kies op basis van wie het HTTP-verzoek initieert, niet op buzzword.
Drie richtingen (snelle kaart)
| Integratie | Wie roept wie aan | Het beste voor |
|---|---|---|
| API (nieuw vandaag) | Jij → initdesk (api.initdesk.com) | Tickets aanmaken of lijsten, Help Center synchroniseren, CRM en interne tools |
| Webhooks | initdesk → jouw HTTPS-URL | Real-time reacties wanneer berichten, toewijzingen of status veranderen |
| BYOD | initdesk → jouw klant-endpoint | Live klantcontext in de ticket-sidebar en AI-concepten |
Geen van deze vervangt de anderen. Veel teams gebruiken BYOD plus de API: context naast de thread, tickets aangemaakt vanuit het product. Webhooks plus de API is gebruikelijk wanneer je een event nodig hebt om een job te triggeren die daarna volledige ticketdetails ophaalt.
Wanneer je de API gebruikt
De API is de juiste default wanneer jouw code initdesk-data on demand moet lezen of wijzigen.
Typische taken:
- Tickets aanmaken vanuit een in-app "Contact support"-flow, een CRM of een intern ops-tool (jij kiest de inbox; de requester is een customer in API-termen).
- Tickets lijsten of zoeken voor dashboards, SLA-rapporten of escalatie-overzichten die je zelf beheert.
- Berichten lezen of posten wanneer je een custom portal bouwt of threads elders spiegelt.
- Help Center artikelen en collecties publiceren of bijwerken vanuit een repo, CMS of release pipeline.
Alles valt onder één organisatie:
/organizations/{organization_id}/...
Gebruik het numerieke organisatie-ID uit Settings → General (niet de string
public_id uit product-URL's). Authenticeer met een org-scoped token bij elk verzoek:X-Initdesk-Token: <your_token>
Issue tokens onder Settings → API access (Account Owner of Admin). De ruwe waarde wordt één keer getoond — bewaar het als een wachtwoord en trek het in als het lekt. Volledige auth, rate limits en entiteitsrelaties staan in de developer docs en entities guide.
Het OpenAPI-schema staat op api.initdesk.com/schema.yaml. Voor een minimale eerste call, zie Verbind met de initdesk API in 15 minuten — vandaag gepubliceerd naast dit bericht.
Wat de API niet is: een vervanging voor native productintegraties. Linear issue create/link draait nog steeds in de initdesk UI en plugin-laag; er is vandaag geen Linear-resource in de API. De workflow in Linear issues from support tickets blijft gelden — gebruik de API voor ticket- en berichtdata, niet voor issues indienen in Linear.
Wanneer webhooks genoeg zijn
Kies webhooks wanneer initdesk je een event moet pushen en jouw taak is reageren — Slack notificeren, n8n starten, cache invalideren of een rij toevoegen aan een analytics-tabel.
Configureer ze in Settings → API & Webhooks. Kies de events die je belangrijk vindt (bijvoorbeeld message created, assigned, resolved, status changed). Je endpoint moet binnen ongeveer vijf seconden een 2xx-response teruggeven of delivery kan als mislukt worden gemarkeerd.
Webhooks dragen notificaties, geen volledige export van je account. Als je gestructureerde ticketbodies, assignees of Help Center-velden on demand nodig hebt, gebruik de API (of combineer: webhook wekt je worker, API levert de payload).
Productreferentie: Webhooks in initdesk Help Center.
Wanneer BYOD de juiste keuze is
BYOD is voor klantcontext op antwoordmoment: facturatiestatus, abonnementsplan, laatste order, feature flags — wat dan ook in je admin-API leeft.
initdesk POST naar je HTTPS-endpoint (met optionele auth headers die je configureert) en rendert het antwoord in de ticket-sidebar met Liquid-templates. Dezelfde data kan AI-conceptantwoorden informeren, zodat agents niet hoeven te gokken op basis van alleen onderwerpregels.
BYOD maakt geen tickets aan, lijst je inbox niet en publiceert geen help-artikelen. Het vervangt de API niet — en de API haalt geen willekeurige data uit je systemen naar de sidebar. Voor die splitsing, zie Bring Your Own Data on initdesk Updates en de BYOD plugin guide.
Veelvoorkomende combinaties (en één anti-pattern)
BYOD + API create ticket — Een klant opent support vanuit je app; je
POST een ticket met hun e-mail en onderwerp. Wanneer een agent de thread opent, heeft BYOD accountcontext ernaast al geladen.Webhook + API retrieve — Een "message created"-webhook triggert je worker; de worker roept retrieve ticket en list messages aan voor de volledige thread voordat er naar een intern kanaal wordt gepost.
Help Center API + redactionele gewoonten — Je synchroniseert artikelen vanuit git; agents volgen nog steeds de contentpatronen in Self-service die echt gebruikt wordt zodat zoeken en AI-chat betrouwbaar blijven.
Anti-pattern: initdesk herbouwen in je database — De API pollen naar een schaduw-inbox dupliceert assignee-status, interne notities en spam-afhandeling die je al in het product hebt betaald. Geef de voorkeur aan webhooks of gerichte reads voor de views die je echt nodig hebt.
Waar nu naartoe
- Developer docs (vandaag live): developers.initdesk.com
- Eerste API-call: Aan de slag met de initdesk API
- Toegang of beta-vragen: support@initdesk.com
initdesk is een AI help desk voor kleine teams: gedeelde inbox, Help Center, BYOD, webhooks en — vanaf vandaag — een API voor tickets, requesters, berichten en Help Center-content. Zie Product Updates voor launch notes en X @initdeskhq voor aankondigingen.