Jira bidirectioneel koppelen: tickets synchroon tussen support en development
Support werkt in de servicedesk, development in Jira, en ondertussen kopieert iemand statussen en reacties met de hand heen en weer. Een tweerichtingskoppeling maakt daar een einde aan. Zo werkt het, en hier gaat het meestal mis.
1. Het probleem: twee systemen, één waarheid
Bijna elk bedrijf met een eigen product of IT-afdeling kent het. De klant meldt een probleem in de servicedesk, bijvoorbeeld TOPdesk, Zendesk, Freshdesk of een eigen klantportaal. Blijkt het een bug, dan maakt support een issue aan in Jira. Vanaf dat moment bestaat dezelfde melding twee keer, en loopt een van de twee altijd achter.
Het gevolg: supportmedewerkers die developers via Slack vragen "is dit al opgelost?", klanten die niets horen terwijl de fix allang live staat, en developers die vragen van de klant missen omdat die alleen in de servicedesk staan. Dat is geen communicatieprobleem. Het is een integratieprobleem.
2. Eenrichting versus tweerichting
Een eenrichtingskoppeling zet een melding door naar Jira en stopt daar. Handig om dubbel typwerk te voorkomen, maar de terugweg blijft handwerk. Een bidirectionele koppeling houdt beide kanten gelijk: verandert de status in Jira, dan verandert hij ook in de servicedesk. Reageert de klant, dan ziet de developer dat als comment in Jira.
Wat je doorgaans synchroniseert:
- Status — van "Nieuw" en "In behandeling" naar To Do, In Progress en Done.
- Prioriteit — P1 tot en met P4 gekoppeld aan Highest tot en met Low.
- Reacties — met onderscheid tussen interne notities en berichten voor de klant.
- Bijlagen — screenshots en logbestanden, zodat niemand ze hoeft door te mailen.
- Velden — zoals klant, component, versie, deadline of verwachte releasedatum.
3. Hoe een tweerichtingskoppeling technisch werkt
Jira Cloud stuurt via webhooks een seintje zodra een issue, comment of bijlage verandert. Het andere systeem doet hetzelfde, of wordt periodiek uitgelezen als het geen webhooks kent. Daartussen zit een sync-laag die drie dingen doet: vertalen, bijhouden en bewaken.
- Vertalen. Elke kant heeft eigen statussen, velden en opmaak. Jira bewaart beschrijvingen en reacties in het Atlassian Document Format, de servicedesk vaak in HTML. De koppeling zet het ene om in het andere, inclusief lijsten, links en afbeeldingen.
- Bijhouden. Per melding wordt vastgelegd welk Jira-issue erbij hoort. Zo weet de koppeling bij elke wijziging welk record aan de andere kant aangepast moet worden.
- Bewaken. Mislukte updates worden opnieuw geprobeerd, de rate limits van de Jira-API worden gerespecteerd en alles wordt gelogd, zodat je achteraf kunt zien wat er wanneer gesynchroniseerd is.
4. De vier valkuilen
Een bidirectionele koppeling is lastiger dan twee eenrichtingskoppelingen naast elkaar. Dit zijn de punten waar het in de praktijk misgaat:
| Valkuil | Wat er gebeurt | Oplossing |
|---|---|---|
| Echo-lus | Een update in A gaat naar B, B meldt dat terug aan A, en zo eindeloos door | Wijzigingen van de koppeling zelf herkennen en negeren |
| Statusovergangen | Jira laat een status niet zomaar zetten, alleen via een toegestane transitie in de workflow | De workflow in kaart brengen en per status de juiste transitie kiezen |
| Conflicten | Hetzelfde veld wordt aan beide kanten tegelijk gewijzigd | Per veld afspreken welk systeem de eigenaar is |
| Interne notities | Een interne developernotitie belandt per ongeluk bij de klant | Expliciet filteren wat publiek is en wat intern blijft |
Vooral het eigenaarschap per veld wordt vaak vergeten. Een simpele afspraak helpt al: de servicedesk is eigenaar van klantgegevens en prioriteit, Jira van de technische status en de releaseversie. Dan weet de koppeling altijd wie er wint.
5. Marketplace-app of maatwerk?
In de Atlassian Marketplace staan kant-en-klare sync-apps. Voor een standaard koppeling tussen twee populaire tools kan dat prima zijn. Ze lopen vast als je eigen software, een minder bekend pakket of afwijkende bedrijfsregels hebt. Denk aan "alleen bugs van betalende klanten doorzetten" of "bij Done automatisch een bericht naar de klant met het releasenummer".
- Marketplace-app — snel live, licentie per gebruiker, beperkt tot wat de app ondersteunt.
- Automatiseringstool — goed voor simpele eenrichtingsstromen, wordt kwetsbaar bij tweerichtingsverkeer.
- Maatwerkkoppeling — sluit precies aan op je proces en systemen, je bent eigenaar van de logica en betaalt geen licentie per gebruiker.
6. Zo pakken wij het aan
- Inventarisatie — welke meldingen moeten naar Jira, welke velden en statussen horen bij elkaar.
- Mappingdocument — status, prioriteit en velden per richting op papier, met eigenaarschap per veld.
- Bouwen en testen — eerst op een testproject in Jira, met echte voorbeeldmeldingen.
- Livegang — eventueel met een eenmalige synchronisatie van lopende meldingen.
- Beheer — monitoring en meldingen bij fouten, zodat een haperende sync niet ongemerkt blijft.
Wil je meer weten over wat een koppeling tussen systemen in het algemeen inhoudt? Lees dan ook integraties bouwen tussen systemen.
Jira koppelen met Integratiepartners
Wij bouwen bidirectionele Jira-koppelingen met servicedesks, CRM-systemen en maatwerksoftware. Status, prioriteit, reacties en bijlagen blijven aan beide kanten gelijk, zonder echo-lussen en met logging zodat je altijd kunt zien wat er gebeurd is.