Zendesk
O Zendesk cria software para melhores relacionamentos com os clientes. Com vários produtos em seu portfólio, o Zendesk fornece uma plataforma de tíquete de suporte e atendimento ao cliente que oferece às empresas a capacidade de lidar com chamadas de clientes, emails e outras consultas técnicas de uma interface unificada.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL |
Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://www.zendesk.com/ |
| Política de privacidade | https://www.zendesk.com/company/customers-partners/privacy-policy/ |
Problemas e limitações conhecidos
- O conector retorna apenas propriedades atômicas da entidade Zendesk (ou seja, não há suporte para listas, registros e outros tipos complexos). Por exemplo,
Ticketa entidade temtagsuma propriedade representada pela matriz no lado do Zendesk. O conector do Zendesk retorna a cadeia de caracteres[List]para esses campos. - O conector requer que
updated_ata coluna exista para qualquer tabela usada com gatilhos. - A API de Pesquisa do Zendesk tem uma limitação no retorno de 1000 resultados por consulta. Isso afeta algumas ações do conector que falharão com um erro ("Falha na solicitação Http: o conteúdo não era um JSON válido") se a tabela de destino contiver 1000 registros ou mais:
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Nome da empresa | cadeia | O nome da empresa zendesk é a parte de subdomínio da URL do site. Por exemplo, https://{company}.zendesk.com | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Artigos de pesquisa |
Retorna um número padrão de 25 artigos por página, até um máximo de 1000 resultados. |
| Atualizar item |
Atualiza um item do Zendesk existente |
| Criar item |
Cria um item do Zendesk |
| Excluir item |
Exclui um item do Zendesk |
| Obter item |
Recupera um item do Zendesk |
| Obter itens |
Recupera itens do Zendesk de um determinado tipo de Zendesk (exemplo: 'Ticket') |
| Obter tabelas |
Recupera tabelas do Zendesk de um site |
Artigos de pesquisa
Retorna um número padrão de 25 artigos por página, até um máximo de 1000 resultados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Artigo a ser pesquisado. |
|
Local
|
locale | string |
A localidade em que o item é exibido |
|
|
ID da marca
|
brand_id | integer |
Pesquise artigos na marca especificada. |
|
|
Categoria
|
category | integer |
Limite a pesquisa a essa ID de categoria. |
|
|
Seção
|
section | integer |
Limitar a pesquisa a esta ID de seção |
|
|
Nomes de rótulo
|
label_names | string |
Uma lista separada por vírgulas de nomes de rótulo. |
|
|
Multimarca
|
multibrand | boolean |
Habilite a pesquisa em todas as marcas, se for verdade. |
Retornos
- Corpo
- SearchResult
Atualizar item
Atualiza um item do Zendesk existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Tipo de item do Zendesk (exemplo: 'Ticket') |
|
Chave do item
|
id | True | string |
Identificador exclusivo do item a ser atualizado |
|
Item
|
item | True | dynamic |
Item do Zendesk com valores atualizados |
Retornos
Criar item
Cria um item do Zendesk
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Tipo de item do Zendesk (exemplo: 'Ticket') |
|
Item
|
item | True | dynamic |
Item do Zendesk a ser criado |
Retornos
Excluir item
Exclui um item do Zendesk
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Tipo de item do Zendesk (exemplo: 'Ticket') |
|
Chave do item
|
id | True | string |
Identificador exclusivo do item a ser excluído |
Obter item
Recupera um item do Zendesk
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Tipo de item do Zendesk (exemplo: 'Ticket') |
|
Chave do item
|
id | True | string |
Identificador exclusivo do item a ser recuperado |
Retornos
Obter itens
Recupera itens do Zendesk de um determinado tipo de Zendesk (exemplo: 'Ticket')
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Tipo de item do Zendesk (exemplo: 'Ticket') |
|
Filtrar Consulta
|
$filter | string |
Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Ordenar por
|
$orderby | string |
Uma consulta orderBy do ODATA para especificar a ordem das entradas |
|
|
Ignorar Contagem
|
$skip | integer |
Número de entradas a serem ignoradas (padrão = 0) |
|
|
Contagem máxima de obtenção
|
$top | integer |
Número máximo de entradas a serem recuperadas (padrão = 512) |
|
|
Selecionar Consulta
|
$select | string |
Campos específicos a serem recuperados de entradas (padrão = todos). |
Retornos
Obter tabelas
Gatilhos
| Quando um item é criado |
Dispara um fluxo quando um item é criado no Zendesk |
| Quando um item é modificado |
Dispara um fluxo quando um item é modificado no Zendesk |
| Quando um item é modificado |
Dispara um fluxo quando um item é modificado no Zendesk |
Quando um item é criado
Dispara um fluxo quando um item é criado no Zendesk
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Nome da tabela Zendesk |
|
Filtrar Consulta
|
$filter | string |
Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Ordenar por
|
$orderby | string |
Uma consulta orderBy do ODATA para especificar a ordem das entradas |
|
|
Ignorar Contagem
|
$skip | integer |
Número de entradas a serem ignoradas (padrão = 0) |
|
|
Contagem máxima de obtenção
|
$top | integer |
Número máximo de entradas a serem recuperadas (padrão = 512) |
Retornos
Quando um item é modificado
Dispara um fluxo quando um item é modificado no Zendesk
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Nome da tabela Zendesk |
|
Filtrar Consulta
|
$filter | string |
Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Ordenar por
|
$orderby | string |
Uma consulta orderBy do ODATA para especificar a ordem das entradas |
|
|
Ignorar Contagem
|
$skip | integer |
Número de entradas a serem ignoradas (padrão = 0) |
|
|
Contagem máxima de obtenção
|
$top | integer |
Número máximo de entradas a serem recuperadas (padrão = 512) |
Retornos
Quando um item é modificado
Dispara um fluxo quando um item é modificado no Zendesk
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Nome da tabela Zendesk |
|
Filtrar Consulta
|
$filter | string |
Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Ordenar por
|
$orderby | string |
Uma consulta orderBy do ODATA para especificar a ordem das entradas |
|
|
Ignorar Contagem
|
$skip | integer |
Número de entradas a serem ignoradas (padrão = 0) |
|
|
Contagem máxima de obtenção
|
$top | integer |
Número máximo de entradas a serem recuperadas (padrão = 512) |
Retornos
Definições
Table
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
Name | string | |
|
DisplayName
|
DisplayName | string |
SearchResult
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
id
|
results.id | integer |
ID do artigo atribuída automaticamente |
|
url
|
results.url | string |
A URL da API do artigo |
|
html_url
|
results.html_url | string |
A URL do artigo na Central de Ajuda |
|
author_id
|
results.author_id | integer |
ID do autor |
|
comments_disabled
|
results.comments_disabled | boolean |
True se os comentários estiverem desabilitados; false caso contrário |
|
rascunho
|
results.draft | boolean |
True se a tradução para a localidade atual for um rascunho |
|
Promovido
|
results.promoted | boolean |
True se este artigo for promovido; false caso contrário. false por padrão |
|
posição
|
results.position | integer |
A posição deste artigo na lista de artigos. 0 por padrão |
|
vote_sum
|
results.vote_sum | integer |
A soma de upvotes (+1) e downvotes (-1), que podem ser positivos ou negativos |
|
vote_count
|
results.vote_count | integer |
O número total de upvotes e downvotes |
|
section_id
|
results.section_id | integer |
A ID da seção à qual este artigo pertence |
|
criado_em
|
results.created_at | date-time |
A hora em que o artigo foi criado |
|
updated_at
|
results.updated_at | date-time |
A hora em que o artigo foi atualizado pela última vez |
|
nome
|
results.name | string |
Nome do artigo |
|
title
|
results.title | string |
O título do artigo |
|
source_locale
|
results.source_locale | string |
A localidade de origem (padrão) do artigo |
|
localidade
|
results.locale | string |
A localidade em que o artigo está sendo exibido |
|
desatualizado
|
results.outdated | boolean |
Deprecated |
|
outdated_locales
|
results.outdated_locales | array of string |
Localidades em que o artigo foi marcado como desatualizado |
|
edited_at
|
results.edited_at | date-time |
A hora em que o artigo foi editado pela última vez em sua localidade exibida |
|
user_segment_id
|
results.user_segment_id | integer |
A ID do segmento de usuário que define quem pode ver este artigo |
|
permission_group_id
|
results.permission_group_id | integer |
A ID do grupo de permissões que define quem pode editar e publicar este artigo |
|
content_tag_ids
|
results.content_tag_ids | array of string |
A lista de marcas de conteúdo anexadas ao artigo |
|
label_names
|
results.label_names | array of string |
Uma matriz de nomes de rótulo associados a este artigo |
|
body
|
results.body | string |
Corpo HTML do artigo |
|
snippet
|
results.snippet | string |
Snippet HTML do artigo |
|
result_type
|
results.result_type | string |
Tipo de resultado |
TablesList
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of Table |