FyneDesk-meldingen sturen naar Microsoft Teams

Ontvang een bericht in je Teams-kanaal telkens wanneer een ticket wordt aangemaakt, er een reactie op wordt geplaatst of de status verandert. FyneDesk stuurt de gebeurtenis naar een webhook en een korte Power Automate-flow zet het om in een Teams-bericht. Volg de onderstaande stappen in volgorde — het duurt ongeveer tien minuten.

Hoe het werkt

FyneDesk stuurt elke gebeurtenis (nieuw ticket, nieuwe reactie enzovoort) als een klein JSON-datapakket naar de URL die je opgeeft. Microsoft Teams toont dat pakket niet zelf — je Power Automate-flow moet de gegevens ophalen en als bericht posten.

Daarom kan een test "succesvol verzonden" melden terwijl er niets in Teams verschijnt: Power Automate antwoordt met 202 Accepted zodra het een verzoek ontvangt, dus "succes" betekent alleen dat Microsoft de gegevens heeft ontvangen. Het zegt niets over of er een bericht is geplaatst. Zodra je de poststap toevoegt in Deel 3, zullen berichten verschijnen.

Voordat je begint

• Een Microsoft Teams-team en -kanaal waar je de meldingen wilt ontvangen, en een Power Automate-account met een licentie die berichten naar Teams kan posten.
• Beheerderstoegang tot FyneDesk-webhooks, via Beheerdersinstellingen → Geavanceerd → Webhooks (ook bereikbaar via Instellingen → Verbindingen → Webhooks).
• Ongeveer tien minuten. Je bouwt een flow op basis van een kant-en-klare sjabloon, plakt de URL ervan in FyneDesk en voegt dan één stap toe die het bericht post.

Instellen

Dit is het exacte pad dat ons team gebruikt, van begin tot eind. Het produceert een eenvoudig, leesbaar tekstbericht. (Wil je dat het bericht elk type gebeurtenis benoemt, of geef je de voorkeur aan een opgemaakte kaart? Zie de geavanceerde opties hieronder.)

Deel 1 — De flow aanmaken vanuit een sjabloon

Ga naar make.powerautomate.com en meld je aan. Kies in het linkermenu Sjablonen, typ webhook in het zoekvak en open Webhook-meldingen verzenden naar een kanaal — de normale versie, niet de "(TEST)"-versies. Klik op Doorgaan (meld je opnieuw aan indien gevraagd).

De sjabloon toont dat het Teams → Microsoft Teams verbindt en een webhook-URL genereert. Voordat je op Maken klikt, stel het Team en Kanaal in waar je de meldingen wilt ontvangen — dit is makkelijk over het hoofd te zien, maar het is belangrijk.

Kies je Team en kanaal en klik vervolgens op Maken. Wanneer de flow wordt geopend, klik je op Bewerken om te beginnen met bewerken.

Deel 2 — De URL doorgeven aan FyneDesk

Klik in de flow op het eerste vak, "Wanneer een Teams-webhookverzoek wordt ontvangen," en kopieer de HTTP-URL die wordt weergegeven.

Ga vervolgens in FyneDesk naar Beheerdersinstellingen → Geavanceerd → Webhooks en klik op Webhook toevoegen:

• Geef het een naam die je later herkent, bijv. Microsoft Teams.
• Plak de Power Automate-URL in Eindpunt-URL (dit moet een HTTPS-link zijn).
• Laat ticket.created aangevinkt staan — dat is alles wat je nodig hebt om te beginnen. (Je kunt later meer gebeurtenissen toevoegen.)
• Klik op Opslaan.

Deel 3 — De flow vertellen wat hij moet posten

Dit is de stap die makkelijk wordt gemist — en precies waarom een test "verzonden" kan zeggen terwijl er niets in Teams verschijnt.

1. Verwijder de twee voorgemaakte stappen. De sjabloon voegt een actie Variabele initialiseren (soms twee) en een voorwaarde Bijlagen is null toe. Verwijder beide — klik op de … bij elke stap en kies Verwijderen. Als je ze laat staan, krijg je de "AdaptiveCard"-fout.

2. Voeg de postactie toe. Klik op de + onder de trigger en kies Bericht plaatsen in een chat of kanaal (de Microsoft Teams-connector). Stel de dropdowns in:

3. Bouw het bericht. Klik in het vak Bericht, klik op de blauwe knop fx (Expressie invoegen), plak de onderstaande expressie exact en klik op Toevoegen.

concat('New ticket ', triggerBody()?['data']?['ticket_number'], ' - ', triggerBody()?['data']?['title'], ' | Status: ', triggerBody()?['data']?['status'], ' | Priority: ', triggerBody()?['data']?['priority'], ' | https://fynedesk.ai/tickets/', string(triggerBody()?['data']?['id']))

4. Opslaan. Klik op Opslaan (rechtsboven). Je zou "Je flow is klaar voor gebruik." moeten zien.

Deel 4 — Testen

Maak of werk een echt ticket bij in FyneDesk. Binnen enkele seconden verschijnt er een bericht in je Teams-kanaal.

Optioneel: elke gebeurtenis benoemen of een kaart posten

De bovenstaande expressie begint altijd met "New ticket". Als je wilt dat het bericht het type gebeurtenis benoemt (nieuwe reactie, statuswijziging enzovoort) of als je de voorkeur geeft aan een opgemaakte kaart, gebruik dan een van de onderstaande opties. De installatie is identiek — alleen de expressie bij Bericht verandert.

Wat FyneDesk verstuurt

Je webhook kan zich abonneren op vier gebeurtenissen. Hieronder staat de structuur van elk pakket (waarden zijn voorbeelden).

ticket.created

{
  "event": "ticket.created",
  "timestamp": "2026-05-30T22:19:59",
  "organization": { "id": 173, "name": "SafePACS" },
  "data": {
    "id": 6381,
    "ticket_number": "INC004736",
    "title": "Printer not working",
    "description": "The 3rd floor printer is offline",
    "status": "New",
    "priority": "Medium",
    "ticket_type": "Incident",
    "source": "Email",
    "created_at": "2026-05-30T22:19:59"
  }
}

ticket.updated en ticket.status_changed gebruiken dezelfde structuur als hierboven, plus updated_at, assigned_to en assigned_team_id.

ticket.commented — let op dat de veldnamen hier iets anders zijn:

{
  "event": "ticket.commented",
  "timestamp": "2026-05-30T22:19:59",
  "organization": { "id": 173, "name": "SafePACS" },
  "data": {
    "ticket_id": 6381,
    "ticket_number": "INC004736",
    "ticket_title": "Printer not working",
    "ticket_status": "New",
    "content": "Any update on this?",
    "comment_id": 8809,
    "is_internal": false
  }
}

Optie A — Een rijker tekstbericht

Typ in plaats van de enkele expressie de onderstaande indeling in het vak Bericht. Alles dat geen 〈plaatshouder〉 is, is gewone tekst die je intypt. Voor elke 〈plaatshouder〉 klik je op de fx-knop, plak je de bijbehorende expressie uit de tabel en klik je op Toevoegen.

〈eventLabel〉  〈ticketNumber〉
〈title〉

Status: 〈status〉   •   Priority: 〈priority〉

〈message〉

Open in FyneDesk: 〈link〉

Optie B — Een opgemaakte kaart

Geef je de voorkeur aan een kaart? Gebruik de actie Kaart plaatsen in een chat of kanaal en plak het volgende in het veld Adaptive Card. Het gebruikt dezelfde expressies, dus het zijn dezelfde gegevens in een nettere indeling.

{
  "type": "AdaptiveCard",
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.2",
  "body": [
    {
      "type": "TextBlock",
      "size": "Medium",
      "weight": "Bolder",
      "text": "@{if(equals(triggerBody()?['event'],'ticket.created'),'🎫 New ticket',if(equals(triggerBody()?['event'],'ticket.commented'),'💬 New comment',if(equals(triggerBody()?['event'],'ticket.status_changed'),'🔄 Status changed','✏️ Ticket updated')))} @{triggerBody()?['data']?['ticket_number']}"
    },
    {
      "type": "TextBlock",
      "text": "@{coalesce(triggerBody()?['data']?['title'],triggerBody()?['data']?['ticket_title'],'(no title)')}",
      "wrap": true
    },
    {
      "type": "FactSet",
      "facts": [
        { "title": "Status", "value": "@{coalesce(triggerBody()?['data']?['status'],triggerBody()?['data']?['ticket_status'],'-')}" },
        { "title": "Priority", "value": "@{coalesce(triggerBody()?['data']?['priority'],'-')}" }
      ]
    },
    {
      "type": "TextBlock",
      "text": "@{coalesce(triggerBody()?['data']?['content'],triggerBody()?['data']?['description'],'')}",
      "wrap": true
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Open in FyneDesk",
      "url": "@{concat('https://fynedesk.ai/',if(equals(triggerBody()?['data']?['ticket_type'],'Service Request'),'requests/','tickets/'),string(coalesce(triggerBody()?['data']?['id'],triggerBody()?['data']?['ticket_id'])))}"
    }
  ]
}

Probleemoplossing

Een opmerking over beveiliging

Je Power Automate-URL bevat een geheime handtekening (het deel sig=...) — behandel de volledige URL als een wachtwoord en deel hem niet. FyneDesk ondertekent ook elk verzoek met een X-FyneDesk-Signature-header (HMAC-SHA256) als je authenticiteit ooit wilt verifiëren binnen de flow, hoewel dat optioneel is en niet vereist om berichten te laten werken.

Veelgestelde vragen