# Fiche connecteur TOPdesk
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## TOPdesk
URL : https://get-bruno.com/features/connectors/topdesk
Référence texte : https://get-bruno.com/features/connectors/topdesk/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Assistance client
Description : TOPdesk est une plateforme de gestion des services informatiques. Cette fiche couvre la création, la consultation et la mise à jour d'incidents, la consultation d'articles de connaissance et de leurs statuts, des listes de valeurs de référence liées aux incidents, ainsi que des déclencheurs documentaires sur les incidents.
Authentification : API key
Présentation : TOPdesk est une plateforme de gestion des services informatiques. Cette fiche couvre la création, la consultation et la mise à jour d'incidents, la consultation d'articles de connaissance et de leurs statuts, des listes de valeurs de référence liées aux incidents, ainsi que des déclencheurs documentaires sur les incidents.
Usage : Créer un incident pour un poste bloqué
Exemple de demande : Je veux ouvrir un incident pour Atelier Martin, avec un poste qui ne démarre plus, afin d'enregistrer le ticket.
Résultat attendu : Un nouvel incident est créé avec les informations fournies, si la connexion et les droits nécessaires sont disponibles.
À préciser : Description du problème ; Valeurs à transmettre pour l'incident
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/topdesk/actions/create-incident
Usage : Lire un incident existant à partir de son identifiant
Exemple de demande : Je veux consulter l'incident ID 4821 pour relire sa description avant d'envoyer une réponse au client.
Résultat attendu : Les informations de l'incident demandé sont retournées, si l'identifiant existe et si l'accès est autorisé.
À préciser : Identifiant de l'incident
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/topdesk/actions/get-incident
Usage : Mettre à jour un incident existant
Exemple de demande : Je veux mettre à jour l'incident 4821 après sa prise en charge par l'équipe.
Résultat attendu : L'incident est mis à jour avec les valeurs transmises, si l'accès en écriture est autorisé.
À préciser : Identifiant de l'incident ; Champs à modifier
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/topdesk/actions/update-incident
Limites propres au service : Les déclencheurs de cette fiche décrivent des événements d'incident; ils ne sont pas exécutés dans Bruno. La consultation par identifiant ou par numéro est documentée pour les incidents et certains éléments associés, pas pour les articles de connaissance ni pour les listes de valeurs. Les listes de valeurs ne couvrent que les champs exposés ici. Les articles de connaissance sont listés, et leurs statuts peuvent être consultés.
Vocabulaire français : Créer un incident — Crée un nouvel incident dans TOPdesk à partir des informations fournies. (https://pipedream.com/apps/topdesk/actions/create-incident)
Vocabulaire français : Obtenir un incident — Retourne un incident à partir de son identifiant. (https://pipedream.com/apps/topdesk/actions/get-incident)
Vocabulaire français : Obtenir les actions d'incident par identifiant — Récupère les actions associées à un incident à partir de son identifiant. (https://pipedream.com/apps/topdesk/actions/get-incident-actions-by-id)
Vocabulaire français : Obtenir les actions d'incident par numéro — Récupère les actions associées à un incident à partir de son numéro. (https://pipedream.com/apps/topdesk/actions/get-incident-actions-by-number)
Vocabulaire français : Obtenir le fil de progression d'incident par identifiant — Retourne l'historique de progression d'un incident à partir de son identifiant. (https://pipedream.com/apps/topdesk/actions/get-incident-progress-trail-by-id)
Vocabulaire français : Obtenir le fil de progression d'incident par numéro — Retourne l'historique de progression d'un incident à partir de son numéro. (https://pipedream.com/apps/topdesk/actions/get-incident-progress-trail-by-number)
Vocabulaire français : Lister les incidents — Retourne une liste d'incidents. (https://pipedream.com/apps/topdesk/actions/get-incidents)
Vocabulaire français : Obtenir les statuts des articles de connaissance — Retourne la liste des statuts possibles pour un article de connaissance. (https://pipedream.com/apps/topdesk/actions/get-knowledge-item-statuses)
Vocabulaire français : Lister les articles de connaissance — Retourne une liste d'articles de connaissance. (https://pipedream.com/apps/topdesk/actions/get-knowledge-items)
Vocabulaire français : Lister les options d'identifiant de site — Récupère les options disponibles pour le champ identifiant de site. (https://pipedream.com/apps/topdesk/actions/list-branch-id-options)
Vocabulaire français : Lister les options d'identifiant de type d'appel — Récupère les options disponibles pour le champ identifiant de type d'appel. (https://pipedream.com/apps/topdesk/actions/list-call-type-id-options)
Vocabulaire français : Lister les options d'identifiant de catégorie — Récupère les options disponibles pour le champ identifiant de catégorie. (https://pipedream.com/apps/topdesk/actions/list-category-id-options)
Vocabulaire français : Lister les options d'identifiant de code de clôture — Récupère les options disponibles pour le champ identifiant de code de clôture. (https://pipedream.com/apps/topdesk/actions/list-closure-code-id-options)
Vocabulaire français : Lister les options d'identifiant de durée — Récupère les options disponibles pour le champ identifiant de durée. (https://pipedream.com/apps/topdesk/actions/list-duration-id-options)
Vocabulaire français : Lister les options d'identifiant de type d'entrée — Récupère les options disponibles pour le champ identifiant de type d'entrée. (https://pipedream.com/apps/topdesk/actions/list-entry-type-id-options)
Vocabulaire français : Lister les options d'identifiant d'impact — Récupère les options disponibles pour le champ identifiant d'impact. (https://pipedream.com/apps/topdesk/actions/list-impact-id-options)
Vocabulaire français : Lister les options d'identifiant de localisation — Récupère les options disponibles pour le champ identifiant de localisation. (https://pipedream.com/apps/topdesk/actions/list-location-id-options)
Vocabulaire français : Lister les options d'identifiant de priorité — Récupère les options disponibles pour le champ identifiant de priorité. (https://pipedream.com/apps/topdesk/actions/list-priority-id-options)
Vocabulaire français : Lister les options d'identifiant de statut de traitement — Récupère les options disponibles pour le champ identifiant de statut de traitement. (https://pipedream.com/apps/topdesk/actions/list-processing-status-id-options)
Vocabulaire français : Lister les options d'identifiant de SLA — Récupère les options disponibles pour le champ identifiant de SLA. (https://pipedream.com/apps/topdesk/actions/list-sla-id-options)
Vocabulaire français : Lister les options d'identifiant d'urgence — Récupère les options disponibles pour le champ identifiant d'urgence. (https://pipedream.com/apps/topdesk/actions/list-urgency-id-options)
Vocabulaire français : Mettre à jour un incident — Met à jour un incident existant avec les valeurs transmises. (https://pipedream.com/apps/topdesk/actions/update-incident)
Vocabulaire français : Incident mis à jour — Déclenche un événement quand un incident est mis à jour. (https://pipedream.com/apps/topdesk/triggers/incident-updated)
Vocabulaire français : Nouvel utilisateur assigné à un incident — Déclenche un événement quand un incident est attribué à un nouvel utilisateur. (https://pipedream.com/apps/topdesk/triggers/new-incident-assignee)
Vocabulaire français : Nouvel incident créé — Déclenche un événement quand un nouvel incident est créé. (https://pipedream.com/apps/topdesk/triggers/new-incident-created)
Vocabulaire français : Nouveau groupe assigné à un incident — Déclenche un événement quand un incident est attribué à un nouveau groupe. (https://pipedream.com/apps/topdesk/triggers/new-incident-group-assigned)
Vocabulaire français : Nouvelle réponse interne à un incident — Déclenche un événement quand une nouvelle réponse interne est ajoutée à un incident. (https://pipedream.com/apps/topdesk/triggers/new-incident-memo-reply)
Vocabulaire français : Nouvelle réponse à un incident — Déclenche un événement quand une nouvelle réponse est ajoutée à un incident. (https://pipedream.com/apps/topdesk/triggers/new-incident-reply)
Vocabulaire français : Nouveau statut d'incident — Déclenche un événement quand le statut d'un incident change. (https://pipedream.com/apps/topdesk/triggers/new-incident-status)
- action : Create Incident — Creates a new incident. See the documentation (https://pipedream.com/apps/topdesk/actions/create-incident)
- action : Get Incident — Returns an incident by ID. See the documentation (https://pipedream.com/apps/topdesk/actions/get-incident)
- action : Get Incident Actions By ID — Get incident actions by incident ID. See the documentation (https://pipedream.com/apps/topdesk/actions/get-incident-actions-by-id)
- action : Get Incident Actions By Number — Get incident actions by incident number. See the documentation (https://pipedream.com/apps/topdesk/actions/get-incident-actions-by-number)
- action : Get Incident Progress Trail By ID — Get incident progress trail by incident ID. See the documentation (https://pipedream.com/apps/topdesk/actions/get-incident-progress-trail-by-id)
- action : Get Incident Progress Trail By Number — Get incident progress trail by incident number. See the documentation (https://pipedream.com/apps/topdesk/actions/get-incident-progress-trail-by-number)
- action : Get Incidents — Returns a list of incidents. See the documentation (https://pipedream.com/apps/topdesk/actions/get-incidents)
- action : Get Knowledge Item Statuses — Returns the list of possible Knowledge Item statuses. See the documentation (https://pipedream.com/apps/topdesk/actions/get-knowledge-item-statuses)
- action : Get Knowledge Items — Returns a list of Knowledge Items. See the documentation (https://pipedream.com/apps/topdesk/actions/get-knowledge-items)
- action : List Branch ID Options — Retrieves available options for the Branch ID field. (https://pipedream.com/apps/topdesk/actions/list-branch-id-options)
- action : List Call Type ID Options — Retrieves available options for the Call Type ID field. (https://pipedream.com/apps/topdesk/actions/list-call-type-id-options)
- action : List Category ID Options — Retrieves available options for the Category ID field. (https://pipedream.com/apps/topdesk/actions/list-category-id-options)
- action : List Closure Code ID Options — Retrieves available options for the Closure Code ID field. (https://pipedream.com/apps/topdesk/actions/list-closure-code-id-options)
- action : List Duration ID Options — Retrieves available options for the Duration ID field. (https://pipedream.com/apps/topdesk/actions/list-duration-id-options)
- action : List Entry Type ID Options — Retrieves available options for the Entry Type ID field. (https://pipedream.com/apps/topdesk/actions/list-entry-type-id-options)
- action : List Impact ID Options — Retrieves available options for the Impact ID field. (https://pipedream.com/apps/topdesk/actions/list-impact-id-options)
- action : List Location ID Options — Retrieves available options for the Location ID field. (https://pipedream.com/apps/topdesk/actions/list-location-id-options)
- action : List Priority ID Options — Retrieves available options for the Priority ID field. (https://pipedream.com/apps/topdesk/actions/list-priority-id-options)
- action : List Processing Status ID Options — Retrieves available options for the Processing Status ID field. (https://pipedream.com/apps/topdesk/actions/list-processing-status-id-options)
- action : List SLA ID Options — Retrieves available options for the SLA ID field. (https://pipedream.com/apps/topdesk/actions/list-sla-id-options)
- action : List Urgency ID Options — Retrieves available options for the Urgency ID field. (https://pipedream.com/apps/topdesk/actions/list-urgency-id-options)
- action : Update Incident — Updates an existing incident. See the documentation (https://pipedream.com/apps/topdesk/actions/update-incident)
- trigger : Incident Updated — Emit new event when an incident is updated. See the documentation (https://pipedream.com/apps/topdesk/triggers/incident-updated)
- trigger : New Incident Assignee — Emit new event when an incident is assigned to a new user. See the documentation (https://pipedream.com/apps/topdesk/triggers/new-incident-assignee)
- trigger : New Incident Created — Emit new event when a new incident is created. See the documentation (https://pipedream.com/apps/topdesk/triggers/new-incident-created)
- trigger : New Incident Group Assigned — Emit new event when an incident is assigned to a new group. See the documentation (https://pipedream.com/apps/topdesk/triggers/new-incident-group-assigned)
- trigger : New Incident Memo Reply — Emit new event when a new memo reply is created. See the documentation (https://pipedream.com/apps/topdesk/triggers/new-incident-memo-reply)
- trigger : New Incident Reply — Emit new event when a new incident reply is created. See the documentation (https://pipedream.com/apps/topdesk/triggers/new-incident-reply)
- trigger : New Incident Status — Emit new event when an incident status is updated. See the documentation (https://pipedream.com/apps/topdesk/triggers/new-incident-status)