Skip to main content
Sanne van Opstal-Brakel
Employee
Employee
May 12, 2026

Microsoft Teams integration for TOPdesk

Related products:Incident ManagementIntegrations
  • May 12, 2026
  • 45 replies
  • 2131 views

Updated: 27 July2026

Microsoft Teams has become a central place for collaboration in many organizations. For many operators, it's also where a large share of incoming questions and requests are received through chats, group conversations, or channels.

While this makes communication fast and accessible, it also introduces a challenge. Turning those informal messages into properly registered incidents in TOPdesk — or keeping existing calls up to date with new information from Teams conversations — often still requires switching between tools, copying information, and manually rebuilding context.

To support this way of working, the Microsoft Teams integration for TOPdesk is now available for all customers.

From conversation to structured incident

With the Microsoft Teams integration, you can create a TOPdesk incident directly from a Teams conversation without leaving the Teams environment. This ensures that informal chat messages are converted into structured incidents that can be properly tracked and managed in TOPdesk.
 

Add Teams messages to existing calls

In addition to creating new incidents, you can now also add Teams messages to an existing, open TOPdesk call. This means that follow-up information shared in Teams — such as updates from a colleague or additional context from a customer — can be added directly to the right call without switching tools or copy-pasting.
 

What this enables

The Microsoft Teams integration allows you to:

  • Create incidents directly from Microsoft Teams
    Turn a chat message into a TOPdesk incident in just a few steps, without switching between tools.
  • Add messages to existing open calls
    Select a Teams message and add it to an existing TOPdesk call, keeping all relevant context in one place.
  • Work without leaving Teams
    Register and update incidents from the place where the conversation already happens, reducing context switching in your daily work.
  • Preserve conversation context
    Relevant messages are included in the incident, helping operators understand the request from the start.
  • Include attachments from Teams
    Files shared in the conversation can be added to the incident, so all supporting information is available in one place.
  • Link back to TOPdesk from Teams
    Once created, the incident is available via a direct link, making it easy to continue working on it in TOPdesk.
  • Reduce manual work and improve data quality
    By avoiding copy-paste actions, you save time and ensure incident information is complete and consistent.

 

Together, this leads to a more efficient workflow and better structured data within TOPdesk.

Getting started

The Microsoft Teams integration is now available for all TOPdesk customers.

To start using the integration, you'll need to install the TOPdesk application within Microsoft Teams and connect it to your TOPdesk environment. You can connect using an application token, or via OAuth, which lets an application manager set up the connection once, centrally, for all operators. See the documentation for setup instructions.

Once installed, you can create incidents directly from your Teams conversations, or add messages to existing open calls.

Want to see how it works in practice? In this video, we guide you through both the setup and usage step by step.

For more detailed information about requirements, installation, and usage, you can also refer to the documentation.


Bringing collaboration and service management closer together

By integrating Microsoft Teams with TOPdesk, you can act directly on requests where they are discussed, without recreating information elsewhere. Whether you're logging a new incident or updating an existing call, everything stays connected.

This helps your team work more consistently, respond faster, and keep a complete overview of incoming requests.

If you’ve started using the Microsoft Teams integration, we’d love to hear your experience. How does this integration fit into your current workflow? And where has it helped you save time or improve collaboration?

45 replies

Juno
Starter ⭐
May 12, 2026

Deze lijkt me erg handig maar om 1 of andere reden krijg ik telkens deze melding als ik wil inloggen in de app:

De gebruikersnaam of het applicatietoken is ongeldig of verlopen.

 

Ik heb mijn persoon geopend en al geprobeerd om een nieuwe gebruikersnaam en wachtwoord in te stellen op mijzelf als behandelaar maar dat heeft niet geholpen. De login werkt wel als ik deze probeer om in het behandelaarsportaal in te loggen.

New Member ⭐
May 12, 2026

Iemand een idee hoe je de behandelaar + behandelaarsgroep automatisch kunt laten vullen wanneer je een melding uit teams laat aanmaken ?

Explorer ⭐
May 12, 2026

Leuke feature, als dit uitgebreid zou worden dan denk ik dat ik het dagelijks ga gebruiken. voor nu is het nog wel te summier is.

De dingen die ik erg zou missen zijn:

Velden (eigenlijk gelijk aan de mailimport opties)

  • Status
  • Behandelaargroep
  • Behandelaar
  • Soort binnenkomst (Teams)

Gebruik

De addon zou ik als beheerder liever voor alle behandelaren willen activeren, met 80+ behandelaren is dit niet echt een feest, in principe heb je het mailadres van de operator al en evt een personeelsnummer misschien zou je daar een koppeling op kunnen maken. Of een koppeling per behandelaarsgroep.

 

"Als je naar rechts kijkt zie je links niks"
New Member ⭐
May 13, 2026

Since we are using operator filters, these tickets are not visible to us.
How can I set default operator group?

Edit: It’s fixed - now I can choose operator Group. 👍

AlexHenderson
New Member ⭐
May 14, 2026

I’m clearly doing something wrong, but I can’t work out what. I’ve created a token and my copy of Teams appears connected, but when I try to add a chat message to TOPdesk I get the error “Unable to reach app. Please try again.” Has anyone seen this before and know what I need to do to correct it?

 

Sanne Haller
Inspirer
May 18, 2026

Is it correct that for every operator who wants to use this integration, they need to set up the integration themselves and therefore require their own API key?

New Member ⭐⭐⭐⭐
May 18, 2026

I appreciate that the purpose of this integration is to provide a mechanism for logging of new tickets from Teams chat messages, but our customers are directed to our formal routes to service of which Teams is not one.

I was thinking though that there is potential for streamlining the process of updating existing tickets with messages from Teams chats, as our Operators can and do use Teams as a way of engaging with customers when working on their tickets - with all relevant details documented in the TOPdesk ticket, albeit currently via a manual copy/paste at present.

A Teams integration that allowed an Operator to select relevant chat messages from a conversation (as per the demo video on this post) to put into a ticket update would be very helpful! Perhaps the integration could prompt for a ticket reference number, or even better provide the Operator with a list of open tickets logged by that Customer, for the Operator to choose which to put the update into?

AlexHenderson
New Member ⭐
May 28, 2026

I’m clearly doing something wrong, but I can’t work out what. I’ve created a token and my copy of Teams appears connected, but when I try to add a chat message to TOPdesk I get the error “Unable to reach app. Please try again.” Has anyone seen this before and know what I need to do to correct it?

 

ha - fixed it! There was a little blue spot in the top corner of my Teams window that I’d not really noticed. I clicked it and it said to “update and restart Teams.” I did that and TOPdesk started working.

Shame the error reporting wasn’t a little more informative (though I think that’s a Microsoft issue not a TOPdesk one)

Sanne van Opstal-Brakel
Employee
Employee
June 3, 2026

Deze lijkt me erg handig maar om 1 of andere reden krijg ik telkens deze melding als ik wil inloggen in de app:

De gebruikersnaam of het applicatietoken is ongeldig of verlopen.

 

Ik heb mijn persoon geopend en al geprobeerd om een nieuwe gebruikersnaam en wachtwoord in te stellen op mijzelf als behandelaar maar dat heeft niet geholpen. De login werkt wel als ik deze probeer om in het behandelaarsportaal in te loggen.

Hoi Juno, die melding betekent meestal dat het veld "applicatietoken" niet met een echt applicatietoken gevuld is (het reguliere wachtwoord werkt hier niet), of dat je operator nog niet de juiste rechten heeft.

Twee dingen om te controleren:

  1. Genereer een applicatietoken vanaf je eigen behandelaar (niet via een API-account, maar via de optie "applicatietoken genereren" op je operator). Gebruik die token in de app, niet je wachtwoord.
  2. Rechten op je behandelaar: Call Management → aanmaken eerste/tweede lijn meldingen, API-toegang → lezen REST API, en API-toegang → schrijven "applicatietokens gebruiken."

Dat de login wél werkt voor het behandelaarsportaal klopt — dat is een andere route dan de API/token-login die de Teams-app gebruikt. Lukt het hiermee? 

Sanne van Opstal-Brakel, your TOPdesk Community Fairy Godmother
Sanne van Opstal-Brakel
Employee
Employee
June 3, 2026

Is it correct that for every operator who wants to use this integration, they need to set up the integration themselves and therefore require their own API key?

​@Sanne Haller Indeed, we need every operator who will use the functionality to install the app and configure the connection to TOPdesk themselves. The reason is: Before we can create the ticket, we need to authenticate the user so that we know who is creating and viewing the ticket(s). Operators need to go to their own settings page in TOPdesk, generate an application token from their operator account and then provide it, so that we can authenticate them and allow them to see the relevant ticket info & use the functionality.

That being said, during our beta process, we also got a lot of feedback that customers find this process labor-intensive. And also they don't always want operators to have this permission, that is why we are already working on a better authentication process. We will inform you all when this is finished. But until then, yes we need operators to provide their application token.

Sanne van Opstal-Brakel, your TOPdesk Community Fairy Godmother