# Fiche connecteur Zendesk 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. ## Zendesk URL : https://get-bruno.com/features/connectors/zendesk Référence texte : https://get-bruno.com/features/connectors/zendesk/reference.txt Origine : Catalogue Pipedream Statut : Catalogue Pipedream — connexion à vérifier Catégories : Assistance client Description : Zendesk est un logiciel de service client pour gérer les tickets, les articles d’aide, les macros et les conversations secondaires liées aux tickets. Cette fiche couvre les opérations exposées dans ce catalogue. Authentification : OAuth Présentation : Zendesk est un logiciel de service client pour gérer les tickets, les articles d’aide, les macros et les conversations secondaires liées aux tickets. Cette fiche couvre les opérations exposées dans ce catalogue. Usage : Créer un ticket pour une demande client Exemple de demande : Je veux ouvrir un ticket pour le client Atelier Martin à propos d’une facture manquante. Prépare les champs utiles pour enregistrer la demande. Résultat attendu : Un ticket est créé avec les informations fournies. Si des pièces jointes sont transmises, elles peuvent être téléversées puis associées au ticket. À préciser : Le nom du client, par exemple Atelier Martin ; Le sujet du ticket ; Le détail de la demande ou du problème ; Les pièces jointes éventuelles Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/zendesk/actions/create-ticket ; https://pipedream.com/apps/zendesk/actions/upload-ticket-attachments Usage : Retrouver un ticket et ses commentaires Exemple de demande : Je veux consulter le ticket 4821 et lire les commentaires associés pour vérifier l’état du dossier. Rassemble les éléments de lecture utiles avant de préparer une réponse. Résultat attendu : Les informations du ticket et la liste de ses commentaires sont récupérées pour consultation. À préciser : L’identifiant du ticket, par exemple 4821 Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/zendesk/actions/get-ticket-info ; https://pipedream.com/apps/zendesk/actions/list-ticket-comments Usage : Rechercher un article d’aide Exemple de demande : Je veux chercher un article d’aide sur la réinitialisation de mot de passe pour le service client. Prépare la recherche dans la base d’aide. Résultat attendu : La recherche renvoie des articles d’aide pertinents à consulter. La liste des articles permet aussi de parcourir le centre d’aide. À préciser : Le thème de recherche, par exemple réinitialisation de mot de passe Nature : Exemple sous réserve de connexion et de droits Sources de l’exemple : https://pipedream.com/apps/zendesk/actions/search-articles ; https://pipedream.com/apps/zendesk/actions/list-articles Limites propres au service : La création et la mise à jour des tickets utilisent les champs exposés par les actions documentées. Les conversations secondaires nécessitent l’extension Collaboration pour leur création. Les contenus dynamiques ne sont disponibles que sur les offres Professional et au-delà. Les recherches portent sur des objets Zendesk accessibles via les actions exposées. Vocabulaire français : Ajouter des étiquettes au ticket — Ajoute des étiquettes à un ticket en les cumulant avec celles déjà présentes. (https://pipedream.com/apps/zendesk/actions/add-ticket-tags) Vocabulaire français : Créer une conversation secondaire — Crée une conversation secondaire liée à un ticket Zendesk, par e-mail, agent Zendesk, Slack, Microsoft Teams ou participant d’un sous-ticket. (https://pipedream.com/apps/zendesk/actions/create-side-conversation) Vocabulaire français : Créer un ticket — Crée un ticket. (https://pipedream.com/apps/zendesk/actions/create-ticket) Vocabulaire français : Supprimer un ticket — Supprime un ticket. (https://pipedream.com/apps/zendesk/actions/delete-ticket) Vocabulaire français : Obtenir un article — Récupère un article à partir de son identifiant. (https://pipedream.com/apps/zendesk/actions/get-article) Vocabulaire français : Obtenir un élément de contenu dynamique — Récupère un élément de contenu dynamique par son identifiant. (https://pipedream.com/apps/zendesk/actions/get-dynamic-content-item) Vocabulaire français : Obtenir des éléments de contenu dynamique par nom — Récupère plusieurs éléments de contenu dynamique à partir de leurs noms. (https://pipedream.com/apps/zendesk/actions/get-dynamic-content-items-by-name) Vocabulaire français : Obtenir une macro — Récupère une macro à partir de son identifiant. (https://pipedream.com/apps/zendesk/actions/get-macro) Vocabulaire français : Obtenir une conversation secondaire — Récupère une conversation secondaire Zendesk par identifiant et peut inclure ses événements. (https://pipedream.com/apps/zendesk/actions/get-side-conversation) Vocabulaire français : Obtenir les informations d’un ticket — Récupère les informations d’un ticket précis. (https://pipedream.com/apps/zendesk/actions/get-ticket-info) Vocabulaire français : Obtenir les informations d’un utilisateur — Récupère les informations d’un utilisateur précis. (https://pipedream.com/apps/zendesk/actions/get-user-info) Vocabulaire français : Lister les macros partagées et personnelles actives — Liste toutes les macros actives disponibles pour l’utilisateur courant. (https://pipedream.com/apps/zendesk/actions/list-active-macros) Vocabulaire français : Lister les articles — Récupère une liste d’articles. (https://pipedream.com/apps/zendesk/actions/list-articles) Vocabulaire français : Lister les éléments de contenu dynamique — Récupère une liste d’éléments de contenu dynamique. (https://pipedream.com/apps/zendesk/actions/list-dynamic-content-items) Vocabulaire français : Lister les options des champs — Récupère les options disponibles pour le champ Fields. (https://pipedream.com/apps/zendesk/actions/list-fields-options) Vocabulaire français : Lister les langues locales — Récupère toutes les langues locales. (https://pipedream.com/apps/zendesk/actions/list-locales) Vocabulaire français : Lister les options de catégorie de macro — Récupère les options disponibles pour le champ Macro Category. (https://pipedream.com/apps/zendesk/actions/list-macro-category-options) Vocabulaire français : Lister les macros — Récupère toutes les macros. (https://pipedream.com/apps/zendesk/actions/list-macros) Vocabulaire français : Lister les conversations secondaires — Récupère toutes les conversations secondaires d’un ticket Zendesk. (https://pipedream.com/apps/zendesk/actions/list-side-conversations) Vocabulaire français : Lister les commentaires d’un ticket — Récupère tous les commentaires d’un ticket précis. (https://pipedream.com/apps/zendesk/actions/list-ticket-comments) Vocabulaire français : Lister les tickets — Récupère une liste de tickets. (https://pipedream.com/apps/zendesk/actions/list-tickets) Vocabulaire français : Retirer des étiquettes du ticket — Retire des étiquettes précises d’un ticket. (https://pipedream.com/apps/zendesk/actions/remove-ticket-tags) Vocabulaire français : Répondre à une conversation secondaire — Ajoute une réponse à une conversation secondaire existante et exige des destinataires pour chaque réponse. (https://pipedream.com/apps/zendesk/actions/reply-to-side-conversation) Vocabulaire français : Rechercher des articles — Recherche dans les articles du centre d’aide. (https://pipedream.com/apps/zendesk/actions/search-articles) Vocabulaire français : Rechercher des messages de la communauté — Recherche dans les messages communautaires du centre d’aide. (https://pipedream.com/apps/zendesk/actions/search-community-posts) Vocabulaire français : Rechercher dans le centre d’aide — Recherche dans les articles, les messages communautaires et les enregistrements externes via la recherche unifiée Guide. (https://pipedream.com/apps/zendesk/actions/search-help-center) Vocabulaire français : Rechercher des macros — Recherche des macros par nom. (https://pipedream.com/apps/zendesk/actions/search-macros) Vocabulaire français : Rechercher des tickets — Recherche des tickets avec l’API de recherche Zendesk. (https://pipedream.com/apps/zendesk/actions/search-tickets) Vocabulaire français : Définir les champs personnalisés du ticket — Définit une ou plusieurs valeurs de champs personnalisés sur un ticket. (https://pipedream.com/apps/zendesk/actions/set-custom-ticket-fields) Vocabulaire français : Définir les étiquettes du ticket — Remplace toutes les étiquettes existantes d’un ticket par de nouvelles étiquettes. (https://pipedream.com/apps/zendesk/actions/set-ticket-tags) Vocabulaire français : Mettre à jour une conversation secondaire — Met à jour l’état ou le sujet d’une conversation secondaire Zendesk. (https://pipedream.com/apps/zendesk/actions/update-side-conversation) Vocabulaire français : Mettre à jour un ticket — Met à jour un ticket. (https://pipedream.com/apps/zendesk/actions/update-ticket) Vocabulaire français : Téléverser des pièces jointes de ticket — Téléverse un ou plusieurs fichiers comme pièces jointes de ticket via l’API des envois Zendesk et renvoie des jetons d’envoi réutilisables. (https://pipedream.com/apps/zendesk/actions/upload-ticket-attachments) Vocabulaire français : Locale mise à jour — Déclenche un événement quand une langue locale est mise à jour. (https://pipedream.com/apps/zendesk/triggers/locale-updated) Vocabulaire français : Nouvelle conversation secondaire — Déclenche un événement quand une conversation secondaire est créée sur un ticket. (https://pipedream.com/apps/zendesk/triggers/new-side-conversation) Vocabulaire français : Nouvelle réponse à une conversation secondaire — Déclenche un événement quand une réponse est ajoutée à une conversation secondaire existante. (https://pipedream.com/apps/zendesk/triggers/new-side-conversation-reply) Vocabulaire français : Nouveau ticket — Déclenche un événement quand un ticket est créé. (https://pipedream.com/apps/zendesk/triggers/new-ticket) Vocabulaire français : Nouveau ticket ajouté à une vue — Déclenche un événement quand un ticket est ajouté à la vue indiquée. (https://pipedream.com/apps/zendesk/triggers/ticket-added-to-view) Vocabulaire français : Nouveau commentaire ajouté au ticket — Déclenche un événement quand un commentaire est ajouté à un ticket. (https://pipedream.com/apps/zendesk/triggers/new-ticket-comment-added) Vocabulaire français : Ticket clos — Déclenche un événement quand un ticket passe à l’état fermé. (https://pipedream.com/apps/zendesk/triggers/ticket-closed) Vocabulaire français : Ticket en attente — Déclenche un événement quand un ticket passe à l’état en attente. (https://pipedream.com/apps/zendesk/triggers/ticket-pended) Vocabulaire français : Ticket résolu — Déclenche un événement quand un ticket passe à l’état résolu. (https://pipedream.com/apps/zendesk/triggers/ticket-solved) Vocabulaire français : Ticket mis à jour — Déclenche un événement quand un ticket est mis à jour. (https://pipedream.com/apps/zendesk/triggers/ticket-updated) - action : Add Ticket Tags — Add tags to a ticket (appends to existing tags). See the documentation. (https://pipedream.com/apps/zendesk/actions/add-ticket-tags) - action : Create Side Conversation — Create a side conversation on a Zendesk ticket using email, Zendesk agent, Slack, Microsoft Teams, or child-ticket participants. Requires the Zendesk Collaboration add-on. Use List Side Conversations to inspect existing conversations. See the documentation (https://pipedream.com/apps/zendesk/actions/create-side-conversation) - action : Create Ticket — Creates a ticket. See the documentation. (https://pipedream.com/apps/zendesk/actions/create-ticket) - action : Delete Ticket — Deletes a ticket. See the documentation. (https://pipedream.com/apps/zendesk/actions/delete-ticket) - action : Get Article — Retrieves an article by its ID. See the documentation. (https://pipedream.com/apps/zendesk/actions/get-article) - action : Get Dynamic Content Item — Retrieves a dynamic content item. Note: Dynamic content is available only on the Professional plan and above. See the documentation. (https://pipedream.com/apps/zendesk/actions/get-dynamic-content-item) - action : Get Dynamic Content Items by Name — Retrieves multiple dynamic content items by their names. Note: Dynamic content is available only on the Professional plan and above. See the documentation. (https://pipedream.com/apps/zendesk/actions/get-dynamic-content-items-by-name) - action : Get Macro — Retrieves a macro by its ID. See the documentation. (https://pipedream.com/apps/zendesk/actions/get-macro) - action : Get Side Conversation — Retrieve a single Zendesk side conversation by ID (UUID, e.g. 8566255a-ece5-11e8-857d-493066fa7b17 ). Use List Side Conversations to discover IDs for a given ticket. Set includeEvents to true to sideload the conversation's events (creation, replies, state changes). See the documentation. (https://pipedream.com/apps/zendesk/actions/get-side-conversation) - action : Get Ticket Info — Retrieves information about a specific ticket. See the documentation. (https://pipedream.com/apps/zendesk/actions/get-ticket-info) - action : Get User Info — Retrieves information about a specific user. See the documentation. (https://pipedream.com/apps/zendesk/actions/get-user-info) - action : List Active Macros — Lists all active shared and personal macros available to the current user. See the documentation. (https://pipedream.com/apps/zendesk/actions/list-active-macros) - action : List Articles — Retrieves a list of articles. See the documentation. (https://pipedream.com/apps/zendesk/actions/list-articles) - action : List Dynamic Content Items — Retrieves a list of dynamic content items. Note: Dynamic content is available only on the Professional plan and above. See the documentation. (https://pipedream.com/apps/zendesk/actions/list-dynamic-content-items) - action : List Fields Options — Retrieves available options for the Fields field. (https://pipedream.com/apps/zendesk/actions/list-fields-options) - action : List Locales — Retrieves all locales. See the documentation. (https://pipedream.com/apps/zendesk/actions/list-locales) - action : List Macro Category Options — Retrieves available options for the Macro Category field. (https://pipedream.com/apps/zendesk/actions/list-macro-category-options) - action : List Macros — Retrieves all macros. See the documentation. (https://pipedream.com/apps/zendesk/actions/list-macros) - action : List Side Conversations — Retrieve all side conversations on a Zendesk ticket. Side conversations are collaboration threads attached to a ticket (email, Slack, Microsoft Teams, or linked child tickets). Use Get Side Conversation to fetch a single side conversation by ID. Set includeEvents to true to sideload each conversation's events (creation, replies, state changes). See the documentation. (https://pipedream.com/apps/zendesk/actions/list-side-conversations) - action : List Ticket Comments — Retrieves all comments for a specific ticket. See the documentation. (https://pipedream.com/apps/zendesk/actions/list-ticket-comments) - action : List Tickets — Retrieves a list of tickets. See the documentation. (https://pipedream.com/apps/zendesk/actions/list-tickets) - action : Remove Ticket Tags — Remove specific tags from a ticket. See the documentation. (https://pipedream.com/apps/zendesk/actions/remove-ticket-tags) - action : Reply to Side Conversation — Reply to an existing Zendesk side conversation. Zendesk requires recipients on every reply, so pass the participants the reply should go to. See the documentation (https://pipedream.com/apps/zendesk/actions/reply-to-side-conversation) - action : Search Articles — Searches Help Center articles. See the documentation. (https://pipedream.com/apps/zendesk/actions/search-articles) - action : Search Community Posts — Searches Help Center community posts. See the documentation. (https://pipedream.com/apps/zendesk/actions/search-community-posts) - action : Search Help Center — Searches across knowledge base articles, community posts, and external records using the Zendesk unified Guide search. See the documentation. (https://pipedream.com/apps/zendesk/actions/search-help-center) - action : Search Macros — Search for macros by name. See the documentation. (https://pipedream.com/apps/zendesk/actions/search-macros) - action : Search Tickets — Searches for tickets using Zendesk's search API. See the documentation. (https://pipedream.com/apps/zendesk/actions/search-tickets) - action : Set Custom Ticket Fields — Sets one or more custom field values on a ticket. See the documentation. (https://pipedream.com/apps/zendesk/actions/set-custom-ticket-fields) - action : Set Ticket Tags — Set tags on a ticket (replaces all existing tags). See the documentation. (https://pipedream.com/apps/zendesk/actions/set-ticket-tags) - action : Update Side Conversation — Update the state or subject of a Zendesk side conversation. See the documentation (https://pipedream.com/apps/zendesk/actions/update-side-conversation) - action : Update Ticket — Updates a ticket. See the documentation. (https://pipedream.com/apps/zendesk/actions/update-ticket) - action : Upload Ticket Attachments — Upload one or more files as ticket attachments via the Zendesk Uploads API. Returns upload tokens that can be used when creating or updating tickets. See the documentation. (https://pipedream.com/apps/zendesk/actions/upload-ticket-attachments) - trigger : Locale Updated — Emit new event when a locale has been updated (https://pipedream.com/apps/zendesk/triggers/locale-updated) - trigger : New Side Conversation — Emit new event when a side conversation is created on a ticket. See the documentation (https://pipedream.com/apps/zendesk/triggers/new-side-conversation) - trigger : New Side Conversation Reply — Emit new event when a reply is added to an existing side conversation on a ticket. See the documentation (https://pipedream.com/apps/zendesk/triggers/new-side-conversation-reply) - trigger : New Ticket (Instant) — Emit new event when a ticket is created (https://pipedream.com/apps/zendesk/triggers/new-ticket) - trigger : New Ticket Added to View (Instant) — Emit new event when a ticket is added to the specified view (https://pipedream.com/apps/zendesk/triggers/ticket-added-to-view) - trigger : New Ticket Comment Added (Instant) — Emit new event when a ticket comment has been added (https://pipedream.com/apps/zendesk/triggers/new-ticket-comment-added) - trigger : Ticket Closed (Instant) — Emit new event when a ticket has changed to closed status (https://pipedream.com/apps/zendesk/triggers/ticket-closed) - trigger : Ticket Pending (Instant) — Emit new event when a ticket has changed to pending status (https://pipedream.com/apps/zendesk/triggers/ticket-pended) - trigger : Ticket Solved (Instant) — Emit new event when a ticket has changed to solved status (https://pipedream.com/apps/zendesk/triggers/ticket-solved) - trigger : Ticket Updated (Instant) — Emit new event when a ticket has been updated (https://pipedream.com/apps/zendesk/triggers/ticket-updated)