Partager via


Zendesk

Zendesk crée des logiciels pour de meilleures relations client. Avec plusieurs produits de son portefeuille, Zendesk fournit un service client et une plateforme de ticketing de support qui permet aux entreprises de gérer les appels clients, les e-mails et d’autres demandes techniques à partir d’une interface unifiée.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Microsoft
URL Microsoft LogicApps Support
Prise en charge de Microsoft Power Automate
Prise en charge de Microsoft Power Apps
Métadonnées du connecteur
Éditeur Microsoft
Site internet https://www.zendesk.com/
Politique de confidentialité https://www.zendesk.com/company/customers-partners/privacy-policy/

Problèmes connus et limitations

  1. Le connecteur retourne uniquement les propriétés atomiques de l’entité Zendesk (c’est-à-dire les listes, les enregistrements et d’autres types complexes ne sont pas pris en charge). Par exemple, Ticket l’entité a tags une propriété représentée par un tableau côté Zendesk. Le connecteur Zendesk retourne [List] une chaîne pour ces champs.
  2. Le connecteur nécessite l’existence updated_at d’une colonne pour toute table utilisée avec des déclencheurs.
  3. L’API Recherche Zendesk présente une limitation quant au retour de 1 000 résultats par requête. Cela affecte certaines actions de connecteur, qui échoueraient avec une erreur (« Échec de la requête Http : le contenu n’était pas un JSON valide ») si la table cible contient 1 000 enregistrements ou plus :

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Nom de la société ficelle Le nom de la société Zendesk est la partie sous-domaine de votre URL de site. Par exemple, https://{company}.zendesk.com Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer un élément

Crée un élément Zendesk

Mettre à jour un élément

Met à jour un élément Zendesk existant

Obtenir des tables

Récupère des tables Zendesk à partir d’un site

Obtenir des éléments

Récupère les éléments Zendesk d’un certain type Zendesk (exemple : « Ticket »)

Obtenir un élément

Récupère un élément Zendesk

Rechercher des articles

Retourne un nombre par défaut de 25 articles par page, jusqu’à un maximum de 1 000 résultats.

Supprimer un élément

Supprime un élément Zendesk

Créer un élément

Crée un élément Zendesk

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Type d’élément Zendesk (exemple : « Ticket »)

Élément
item True dynamic

Élément Zendesk à créer

Retours

Les sorties de cette opération sont dynamiques.

Mettre à jour un élément

Met à jour un élément Zendesk existant

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Type d’élément Zendesk (exemple : « Ticket »)

Clé d’élément
id True string

Identificateur unique de l’élément à mettre à jour

Élément
item True dynamic

Élément Zendesk avec des valeurs mises à jour

Retours

Les sorties de cette opération sont dynamiques.

Obtenir des tables

Récupère des tables Zendesk à partir d’un site

Retours

Corps
TablesList

Obtenir des éléments

Récupère les éléments Zendesk d’un certain type Zendesk (exemple : « Ticket »)

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Type d’élément Zendesk (exemple : « Ticket »)

Filtrer la requête
$filter string

Requête de filtre ODATA pour restreindre les entrées retournées (par exemple, stringColumn eq 'string' OR numberColumn lt 123).

Commande par
$orderby string

Requête ODATA orderBy pour spécifier l’ordre des entrées

Ignorer le nombre
$skip integer

Nombre d’entrées à ignorer (valeur par défaut = 0)

Nombre maximal d’obtentions
$top integer

Nombre maximal d’entrées à récupérer (valeur par défaut = 512)

Sélectionner la requête
$select string

Champs spécifiques à récupérer à partir d’entrées (valeur par défaut = all).

Retours

Les sorties de cette opération sont dynamiques.

Obtenir un élément

Récupère un élément Zendesk

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Type d’élément Zendesk (exemple : « Ticket »)

Clé d’élément
id True string

Identificateur unique de l’élément à récupérer

Retours

Les sorties de cette opération sont dynamiques.

Rechercher des articles

Retourne un nombre par défaut de 25 articles par page, jusqu’à un maximum de 1 000 résultats.

Paramètres

Nom Clé Obligatoire Type Description
Query
query True string

Article à rechercher.

Paramètres régionaux
locale string

Paramètres régionaux affichés dans l’élément

ID de marque
brand_id integer

Recherchez des articles dans la marque spécifiée.

Catégorie
category integer

Limitez la recherche à cet ID de catégorie.

Section
section integer

Limiter la recherche à cet ID de section

Noms d’étiquettes
label_names string

Liste séparée par des virgules des noms d’étiquettes.

Multibrand
multibrand boolean

Activez la recherche sur toutes les marques si la valeur est true.

Retours

Corps
SearchResult

Supprimer un élément

Supprime un élément Zendesk

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Type d’élément Zendesk (exemple : « Ticket »)

Clé d’élément
id True string

Identificateur unique de l’élément à supprimer

Déclencheurs

Lorsqu’un élément est créé

Déclenche un flux lorsqu’un élément est créé dans Zendesk

Lorsqu’un élément est modifié

Déclenche un flux lorsqu’un élément est modifié dans Zendesk

Lorsqu’un élément est modifié

Déclenche un flux lorsqu’un élément est modifié dans Zendesk

Lorsqu’un élément est créé

Déclenche un flux lorsqu’un élément est créé dans Zendesk

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Nom de la table Zendesk

Filtrer la requête
$filter string

Requête de filtre ODATA pour restreindre les entrées retournées (par exemple, stringColumn eq 'string' OR numberColumn lt 123).

Commande par
$orderby string

Requête ODATA orderBy pour spécifier l’ordre des entrées

Ignorer le nombre
$skip integer

Nombre d’entrées à ignorer (valeur par défaut = 0)

Nombre maximal d’obtentions
$top integer

Nombre maximal d’entrées à récupérer (valeur par défaut = 512)

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’un élément est modifié

Déclenche un flux lorsqu’un élément est modifié dans Zendesk

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Nom de la table Zendesk

Filtrer la requête
$filter string

Requête de filtre ODATA pour restreindre les entrées retournées (par exemple, stringColumn eq 'string' OR numberColumn lt 123).

Commande par
$orderby string

Requête ODATA orderBy pour spécifier l’ordre des entrées

Ignorer le nombre
$skip integer

Nombre d’entrées à ignorer (valeur par défaut = 0)

Nombre maximal d’obtentions
$top integer

Nombre maximal d’entrées à récupérer (valeur par défaut = 512)

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’un élément est modifié

Déclenche un flux lorsqu’un élément est modifié dans Zendesk

Paramètres

Nom Clé Obligatoire Type Description
Nom de la table
table True string

Nom de la table Zendesk

Filtrer la requête
$filter string

Requête de filtre ODATA pour restreindre les entrées retournées (par exemple, stringColumn eq 'string' OR numberColumn lt 123).

Commande par
$orderby string

Requête ODATA orderBy pour spécifier l’ordre des entrées

Ignorer le nombre
$skip integer

Nombre d’entrées à ignorer (valeur par défaut = 0)

Nombre maximal d’obtentions
$top integer

Nombre maximal d’entrées à récupérer (valeur par défaut = 512)

Retours

Les sorties de cette opération sont dynamiques.

Définitions

Table

Nom Chemin d’accès Type Description
Nom
Name string
DisplayName
DisplayName string

SearchResult

Nom Chemin d’accès Type Description
results
results array of object
pièce d'identité
results.id integer

ID d’article attribué automatiquement

URL
results.url string

URL de l’API de l’article

html_url
results.html_url string

URL de l’article dans le Centre d’aide

author_id
results.author_id integer

ID d’auteur

comments_disabled
results.comments_disabled boolean

True si les commentaires sont désactivés ; false sinon

draft
results.draft boolean

True si la traduction des paramètres régionaux actuels est un brouillon

promu
results.promoted boolean

True si cet article est promu ; false sinon. false par défaut

position
results.position integer

Position de cet article dans la liste des articles. 0 par défaut

vote_sum
results.vote_sum integer

Somme des upvotes (+1) et des downvotes (-1), qui peuvent être positives ou négatives

vote_count
results.vote_count integer

Nombre total d’appel et d’appel

section_id
results.section_id integer

ID de la section à laquelle appartient cet article

date_de_création
results.created_at date-time

Heure de création de l’article

updated_at
results.updated_at date-time

Heure de la dernière mise à jour de l’article

nom
results.name string

Nom de l’article

title
results.title string

Titre de l’article

source_locale
results.source_locale string

Paramètres régionaux source (par défaut) de l’article

paramètres régionaux
results.locale string

Paramètres régionaux affichés dans l’article

suranné
results.outdated boolean

Deprecated

outdated_locales
results.outdated_locales array of string

Paramètres régionaux dans lesquels l’article a été marqué comme obsolète

edited_at
results.edited_at date-time

Heure de la dernière modification de l’article dans ses paramètres régionaux affichés

user_segment_id
results.user_segment_id integer

ID du segment d’utilisateur qui définit qui peut voir cet article

permission_group_id
results.permission_group_id integer

ID du groupe d’autorisations qui définit qui peut modifier et publier cet article

content_tag_ids
results.content_tag_ids array of string

Liste des balises de contenu jointes à l’article

label_names
results.label_names array of string

Tableau de noms d’étiquettes associés à cet article

body
results.body string

Corps HTML de l’article

extrait
results.snippet string

Extrait de code HTML de l’article

result_type
results.result_type string

Type de résultat

TablesList

Nom Chemin d’accès Type Description
value
value array of Table