Webhooks

Webhooks brengen een extern systeem op de hoogte wanneer een geplande export klaar is. Ze worden geleverd door de app Exportelier Automation en blijven uitgeschakeld totdat een sitebeheerder bezorging via webhook inschakelt.

Beschikbare webhooktypen

• Inkomende webhook van Slack — plaatst de exportsamenvatting als een gewoon kanaalbericht.
• Microsoft Teams-workflowwebhook — plaatst een Adaptive Card 1.2 via een door de klant aangemaakte Teams-workflow.

De instellingen voor webhook-eindpunten met type, gemaskeerde referentie en status.

Een webhook linkt — hij uploadt het bestand niet naar Slack of Teams

Een webhook voegt het gegenereerde PDF-, DOCX- of Markdown-bestand nooit toe aan het providerbericht. Standaard bevat een geplande export van één item een link naar het Jira-item. Als dezelfde uitvoering ook een geslaagd Jira-bijlagendoel heeft, bevat het bericht een link naar die gegenereerde bijlage. Beide links blijven in Jira en vereisen dat de ontvanger de bijbehorende Jira-toegang heeft.

Hoe het bericht eruitziet

Beide kanalen sturen dezelfde samenvattingsregel:

Exportelier export "Weekly sprint report": sprint-report-2026-09-01.pdf (14 issues)

• Slack ontvangt de samenvatting, gevolgd door klikbare links Jira-item openen en Document openen wanneer die beschikbaar zijn.
• Teams ontvangt een Adaptive Card 1.2 met de kop Exportelier export: <naam van de planning>, dezelfde samenvattingsregel en bijbehorende OpenUrl-acties wanneer die beschikbaar zijn.

De Jira-itemlink wordt weggelaten bij exports met meerdere items. De documentlink wordt weggelaten tenzij eerst een Jira-bijlagendoel slaagt. Het eindpuntbericht Testen bevat geen links, omdat het geen document exporteert of bijvoegt.

Instellen

Beide kanalen volgen dezelfde drie stappen: bezorging eenmalig inschakelen, het eindpunt registreren en het in een planning selecteren.

1. Bezorging via webhook inschakelen

Open in Exportelier Automation Instellingen → Externe bezorging en zet Bezorging via webhook inschakelen aan. Er verschijnt een bevestigingsvenster: dit is het moment waarop een sitebeheerder expliciet accepteert dat gegevens Atlassian verlaten.

Zolang deze schakelaar uit staat, blijft het bezorgdoel Webhook in elke planning grijs en wordt er nooit iets verzonden.

2a. Een inkomende webhook van Slack registreren

Slack geeft URL's voor inkomende webhooks uit via een Slack-app:

1. Open api.slack.com/apps en kies Create New App → From scratch. Geef de app een naam — bijvoorbeeld Exportelier — en selecteer de doelwerkruimte.
2. Open in de zijbalk van de app Incoming Webhooks en zet Activate Incoming Webhooks aan.
3. Klik op Add New Webhook to Workspace, selecteer het kanaal dat de meldingen moet ontvangen en bevestig met Allow.
4. Kopieer de gegenereerde Webhook URL. Die heeft de vorm https://hooks.slack.com/services/T…/B…/…. Behandel hem als een wachtwoord: iedereen die hem heeft, kan in dat kanaal posten.
5. Ga in Exportelier Automation naar Instellingen → Webhook-eindpunten, zet Kanaal op Inkomende webhook van Slack, plak de URL in Eindpunt en klik op Eindpunt toevoegen.

Exportelier accepteert uitsluitend HTTPS-URL's op de host hooks.slack.com. Berichten verschijnen onder de naam en het pictogram van de Slack-app die u hebt aangemaakt; beide wijzigt u in Slack onder Basic Information → Display Information.

Geen trigger-URL uit Workflow Builder

Slack Workflow Builder geeft ook hooks.slack.com-URL's uit, maar die zien eruit als https://hooks.slack.com/triggers/… en verwachten de benoemde variabelen van die workflow in plaats van een text-veld. De hostcontrole van Exportelier accepteert zo'n URL, maar er verschijnt geen leesbaar bericht in het kanaal. Gebruik een inkomende webhook (/services/…) uit een Slack-app zoals hierboven beschreven.

2b. Een Microsoft Teams-workflowwebhook registreren

Microsoft heeft de Office 365-connectorwebhooks in mei 2026 uitgefaseerd. Exportelier accepteert nieuwe Teams-eindpunten daarom alleen nog uit Microsoft Teams Workflows.

1. Open in het Teams-doelkanaal Meer opties (…) → Workflows.
2. Selecteer Send webhook alerts to a channel. Dit is de Anyone-sjabloon. Bouwt u de workflow zelf, kies dan de trigger When a Teams webhook request is received en zet het verificatietype op Anyone.
3. Verifieer het Microsoft-account dat eigenaar van de workflow wordt, selecteer het team en het kanaal en voeg de workflow toe. Volgens Microsoft vereisen deze Teams-webhooksjablonen geen premiumlicentie.
4. Kopieer de gegenereerde URL. Behandel hem als een wachtwoord: iedereen met deze ondertekende URL kan de workflow activeren.
5. Ga in Exportelier Automation naar Instellingen → Webhook-eindpunten, zet Kanaal op Microsoft Teams-workflowwebhook, plak de URL in Eindpunt en klik op Eindpunt toevoegen.

Ondersteunde URL's gebruiken HTTPS op een subdomein van environment.api.powerplatform.com of logic.azure.com. Exportelier stuurt geen OAuth-header; de geheime Anyone-URL autoriseert het verzoek.

Berichten verschijnen onder de standaardidentiteit van de Workflows-bot van Microsoft. Microsoft ondersteunt geen eigen botnaam of pictogram voor deze webhookberichten.

Uitgefaseerde Office 365-connectoren

Opgeslagen *.webhook.office.com-eindpunten blijven zichtbaar als Actie vereist, zodat planningen niet stilzwijgend worden gewijzigd. Maak een nieuw workflow-eindpunt aan en test het, werk elke betrokken planning bij en verwijder pas daarna het verouderde eindpunt. Verouderde eindpunten zijn niet beschikbaar voor nieuwe planningen en mislukken lokaal voordat er een verzoek wordt verstuurd.

2c. Het eindpunt verifiëren

Elk geregistreerd eindpunt heeft een knop Testen. Die plaatst één vast bericht —

Exportelier test message: this webhook endpoint is configured correctly. No export was generated.

— via dezelfde uitgangscontrole, hetzelfde opgeslagen geheim en dezelfde payload-bouwer die een geplande uitvoering gebruikt. Een geslaagde test bewijst dus het bezorgpad en niet alleen het URL-formaat. De rij toont Bezorgd bij succes; bij een fout verschijnt de reden boven de tabel en komt die overeen met de lijst voor probleemoplossing hieronder.

De knop is uitgeschakeld zolang bezorging via webhook uit staat, omdat er niets verzonden zou worden.

3. Het eindpunt in een planning selecteren

Open Planningen, bewerk de planning die moet melden en voeg het bezorgdoel Webhook toe. Kies het Kanaal en vervolgens het Opgeslagen eindpunt — eindpunten worden vermeld met hun gemaskeerde referentie, omdat de URL zelf na het opslaan nooit aan de browser wordt teruggegeven.

Beide linkopties zijn standaard ingeschakeld en kunnen afzonderlijk worden uitgeschakeld. Een planning kan doelen combineren: dezelfde uitvoering kan het document aan een Jira-item koppelen én een webhookmelding plaatsen. Exportelier voltooit het bijlagendoel vóór een webhook die om de documentlink vraagt, ongeacht de weergegeven volgorde.

Problemen oplossen

Er komt niet meteen iets binnen. Exportelier Automation controleert elke vijf minuten op openstaande planningen, dus een bezorging kan tot vijf minuten achterlopen op het ingestelde tijdstip. Wilt u een eindpunt controleren zonder op een uitvoering te wachten, gebruik dan de knop Testen onder Instellingen → Webhook-eindpunten — die meldt dezelfde berichten als een geplande uitvoering.

Controleer het resultaat van de laatste uitvoering. De lijst Planningen heeft een kolom Laatste uitvoering met de status Geslaagd, Gedeeltelijk geslaagd of Uitvoering mislukt, en toont de reden van een fout. Een uitvoering die het document heeft gegenereerd maar de webhook niet kon plaatsen, wordt gemeld als Gedeeltelijk geslaagd.

Melding	Wat het betekent
Bezorging via webhook is door een beheerder uitgeschakeld.	De schakelaar Bezorging via webhook inschakelen onder Instellingen → Externe bezorging staat uit.
Het webhook-eindpunt is niet geconfigureerd.	Het opgeslagen eindpunt is in Exportelier ingetrokken terwijl een planning er nog naar verwees. Registreer het opnieuw en selecteer het opnieuw in de planning.
Het opgeslagen geheim komt niet overeen met dit webhook-kanaal.	Het kanaal van de planning is omgezet naar de andere provider zonder een passend eindpunt te kiezen.
Het webhook-eindpunt heeft het verzoek geweigerd.	De provider antwoordde met een fout — meestal een in Slack ingetrokken webhook of een uitgeschakelde of verwijderde Teams-workflow. Maak aan providerzijde een nieuw eindpunt aan.
Een Slack-webhook moet een https-URL van hooks.slack.com gebruiken.	De URL is bij het opslaan geweigerd. Kopieer hem opnieuw van de pagina Incoming Webhooks van de Slack-app.
Deze Microsoft Teams-connector wordt niet meer ondersteund.	Een uitgefaseerde *.webhook.office.com-connector. Vervang deze door een workflow-eindpunt zoals hierboven beschreven.

Er komt niets in het kanaal, maar de uitvoering is geslaagd. Slack en Teams antwoorden allebei met 200 voordat het bericht wordt weergegeven. Controleer of de webhook nog aan het verwachte kanaal is gekoppeld — in Slack onder Incoming Webhooks, in Teams onder Workflows.

Betrouwbaarheid en beveiliging

• Bezorging via webhook staat standaard uit en vereist een expliciete bevestiging door een beheerder.
• Eindpunt-URL's worden opgeslagen als versleutelde Forge-secrets, worden na het opslaan nooit aan de browser teruggegeven en worden alleen als gemaskeerde referentie getoond. Ze horen niet thuis in tickets, schermafbeeldingen of logs.
• Ingeschakelde linkopties sturen het Jira-siteadres en, bij exports van één item, de itemcode naar de externe provider. De gegenereerde URL's bevatten geen aanmeldgegevens of ondertekende queryparameters en vereisen nog steeds Jira-authenticatie en -rechten.
• Verzoeken verlopen na 10 seconden en worden slechts één keer opnieuw geprobeerd, en alleen bij netwerkfouten, HTTP 429 of 5xx. Een 4xx-antwoord is definitief en wordt niet opnieuw geprobeerd.
• Een geslaagd antwoord van de provider, inclusief HTTP 200 of 202, markeert het doel als bezorgd.

Zie Beveiligingsarchitectuur voor hoe uitgaand verkeer wordt geïsoleerd, en de pagina API voor programmatisch activeren.