FixControl is een brug. Het zit tussen de plek waar klantissues binnenkomen (je inbox of chat) en de plek waar code daadwerkelijk uitgerold wordt (je repository), met optionele spiegeling naar de tracker waar je engineers in werken. Deze pagina is een overzicht-op-één-scherm. Setup-stappen staan in de Beheerdersgids.
Communicatie
| Provider | Wat het doet |
|---|---|
| Slack | Ontvangt berichten uit gekoppelde channels en DM's. Plaatst patch- en issue-updates terug. Geverifieerd via ondertekende payloads — elk event wordt gecontroleerd. |
| Microsoft Teams | Zelfde rol als Slack. Stuurt adaptive cards voor approve/reject-acties direct in Teams. |
| Op de roadmap — nog niet beschikbaar. |
| Provider | Wat het doet |
|---|---|
| Gmail | Polling of Pub/Sub-push voor inkomende mail. Per-tenant routing via plus-addressing. |
| Office 365 / Exchange | Microsoft Graph-subscriptions duwen nieuwe mail in near-realtime. Subscriptions worden automatisch vernieuwd voor ze verlopen. |
Beide providers volgen dezelfde intake-flow — afzender, onderwerp, body en bijlagen worden genormaliseerd naar één vorm voordat triage draait.
Code (Git-providers)
FixControl wijzigt je repo nooit zonder expliciete Approve. Bij Run fix wordt de patch geopend als pull request (GitHub, Bitbucket) of merge request (GitLab) op de branch die je project specificeert.
| Provider | Auth-opties |
|---|---|
| GitHub | GitHub App (aanbevolen), OAuth of Personal Access Token. |
| GitLab | OAuth of PAT. Self-hosted instances ondersteund. |
| Bitbucket Cloud | OAuth-consumer of app password. |
| Bitbucket Server | Personal access token, on-premise URL. |
Per tenant kun je meerdere providers koppelen — bijvoorbeeld een GitHub App voor productie en een GitLab OAuth voor een interne monorepo. Elke codebase wijst naar precies één provider.
Issue-trackers & support
Wanneer een issue is goedgekeurd kan FixControl die spiegelen naar je tracker zodat engineers en PM's hem in hun normale workflow zien. De koppeling is bidirectioneel — comments en statuswijzigingen blijven synchroon.
| Tracker | Auth-opties |
|---|---|
| Jira | OAuth of e-mail + API-token. |
| Linear | OAuth of API-key. |
| Freshdesk | API-key + je Freshdesk-domein. |
| Odoo Helpdesk | Instance-URL + database + gebruikerslogin + API-sleutel (JSON-RPC). |
| TOPdesk | Instance-URL + operator-loginnaam + application password. |
Freshdesk is zowel een issue-tracker als support-systeem-van-record, dus het doet iets meer dan Jira/Linear:
- Tickets blijven in Freshdesk. FixControl maakt en koppelt tickets en leest hun status terug — het neemt nooit het klantgesprek over of vervangt Freshdesk.
- Gerelateerde support-historie als bewijs. Bij een nieuw issue toont FixControl een paar eerdere Freshdesk-tickets die gerelateerd lijken — mét waarom elk matchte en hoeveel je het mag vertrouwen — zodat triage begint met "dit hebben we eerder gezien, en zó liep het af". Het is bewijs om te wegen, nooit een automatisch antwoord.
- Opgeloste tickets worden KB-concepten. Als een ticket is opgelost, kan FixControl de oplossing van de agent omzetten in een concept voor de kennisbank. Er wordt niets automatisch gepubliceerd — een mens keurt eerst goed. Zie Kennisbank.
- Status kan terugsyncen. Met een optionele inbound webhook (zie Beheerdersgids) pusht Freshdesk statuswijzigingen, zodat het FixControl-issue de live support-status toont — zonder ooit de FixControl-workflowstatus zelf te wijzigen.
Odoo Helpdesk speelt dezelfde dubbelrol voor teams die support in Odoo draaien:
- Tickets aanmaken en koppelen. FixControl maakt en koppelt Odoo-helpdesktickets en leest hun stage terug — Odoo blijft het systeem-van-record voor het klantgesprek.
- Two-way statussync. Een optionele inbound webhook pusht stagewijzigingen zodat het issue de live support-status toont; optioneel zet het oplossen van een issue het ticket op een stage die de operator benoemt — nooit een geraden stage.
- Gegoverneerde klant-replies. Een opgestelde klant-reply loopt door de communicatie-goedkeuringsflow; pas nadat een mens goedkeurt wordt hij als klant-zichtbaar bericht op het ticket geplaatst.
- Opgeloste tickets als bewijs. Triage toont gerelateerde afgehandelde Odoo-tickets, mét waarom elk matchte en hoeveel je het mag vertrouwen — bewijs om te wegen, nooit een automatisch antwoord.
TOPdesk speelt dezelfde dubbelrol voor teams die hun servicedesk in TOPdesk draaien:
- Incidenten aanmaken en koppelen. FixControl maakt en koppelt TOPdesk-incidenten en leest hun behandelstatus terug — TOPdesk blijft het systeem-van-record voor het gesprek met de melder.
- Two-way statussync. Een inbound webhook die je zelf in TOPdesk instelt pusht wijzigingen zodat het issue de live servicedeskstatus toont; optioneel zet het oplossen van een issue het incident op afgehandeld en op een behandelstatus die de operator benoemt — nooit een geraden status.
- Gegoverneerde klant-replies. Een opgestelde reply loopt door de communicatie-goedkeuringsflow; pas nadat een mens goedkeurt wordt hij geplaatst als incidentactie die zichtbaar is voor de melder. Voortgangsnotities blijven onzichtbaar voor de melder.
- Opgeloste incidenten als bewijs. Triage toont gerelateerde afgehandelde TOPdesk-incidenten, mét waarom elk matchte en hoeveel je het mag vertrouwen — bewijs om te wegen, nooit een automatisch antwoord.
Slack maakt nooit rechtstreeks supportdesk-tickets aan. De flow is altijd Slack → FixControl-intake → FixControl-issue → (optioneel) Freshdesk-, Odoo- of TOPdesk-ticket.
DevOps & CI/CD
FixControl kan ook je CI/CD-providers koppelen om deployments te observeren en te governen. Het ontvangt pipeline- en deploy-events, beoordeelt elk op risico en legt een onveranderlijk logboek aan. Voor de meeste providers triggert of rolt het zelf geen deployments. Het enige uitvoeringspad vandaag is Argo Rollouts-promotie, en dat draait pas nadat een mens een deployment-poort goedkeurt, waar Argo daarvoor is ingericht — er is geen autonome deploy, en een rollback voert FixControl nooit zelf uit.
| Provider | Hoe je koppelt |
|---|---|
| GitHub Actions | GitHub App |
| GitLab CI | OAuth + project-ID |
| Jenkins · Azure DevOps · Argo CD · Vercel · Terraform Cloud · Kubernetes | Handmatige webhook + eenmalig geheim |
Setup staat in de Beheerdersgids → DevOps & CI/CD.
Automatisering — Webhooks & API
| Surface | Wat je krijgt |
|---|---|
| Uitgaande webhooks | HMAC-SHA256 ondertekende deliveries op issue-/patch-/run-events. Filtering per event. Retry met exponentiële backoff. Zie Webhooks. |
| Publieke API | Bearer-token REST-API voor issues, patches, integraties en audit. Tenant-gescopete sleutels met expliciete scopes. Zie API. |
En de rest?
FixControl richt zich op de brug van inbox naar PR. Het probeert niet een CRM, factureringssysteem of generiek automatiseringsplatform te zijn — dat zijn de systemen waar we data naartoe sturen (via webhooks) en context uit halen (via je kennisbank of REST-endpoints), geen vervangers die we binnen FixControl bouwen. Hetzelfde geldt voor ERP's: FixControl koppelt met Odoo's Helpdesk-module als support-tracker — het vervangt of integreert niet de rest van het ERP (verkoop, facturatie, voorraad, …).
Wil je in een ander systeem reageren op een FixControl-event? Abonneer een uitgaande webhook → handel de ondertekende delivery aan jouw kant af. Heb je tijdens triage data uit een ander systeem nodig? Zet die in de Kennisbank zodat agents het kunnen lezen.
Zichtbaarheid
De live status van elke integratie zie je in Settings → Integraties:
- connected — credentials geldig, verkeer loopt
- setup_required — gedeeltelijk geconfigureerd, actie nodig
- error — credentials verlopen of upstream onbereikbaar; klik door voor de melding
- not_connected — nooit ingesteld
Integration-health komt ook terug op het admin-dashboard, zodat een ongezonde integratie niet over het hoofd te zien is.