Zendesk
O Zendesk cria software para melhorar o relacionamento com os clientes. Com vários produtos em seu portfólio, a Zendesk fornece uma plataforma de tíquetes de atendimento e suporte ao cliente que dá às empresas a capacidade de lidar com chamadas, e-mails e outras consultas técnicas de clientes a partir de uma interface unificada.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | 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) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , 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 | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://www.zendesk.com/ |
| Política de privacidade | https://www.zendesk.com/company/customers-partners/privacy-policy/ |
Problemas conhecidos e limitações
- O conector retorna apenas propriedades atômicas da entidade Zendesk (ou seja, listas, registros e outros tipos complexos não são suportados). Por exemplo,
Ticketa entidade temtagspropriedade representada por array no lado do Zendesk. O conector Zendesk retorna[List]a cadeia de caracteres para esses campos. - O conector requer
updated_ata existência de coluna para qualquer tabela usada com gatilhos. - A API do Zendesk Search tem uma limitação no retorno de 1000 resultados por consulta. Isso afeta algumas ações do conector, que falhariam 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:
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 (de caracteres) | O nome da empresa Zendesk é a parte do subdomínio da URL do seu site. Por exemplo, https://{empresa}.zendesk.com | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Atualizar item |
Atualiza um item existente do Zendesk |
| 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 mesas |
Recupera tabelas do Zendesk de um site |
| Pesquisar Artigos |
Devolve um número predefinido de 25 artigos por página, até um máximo de 1000 resultados. |
Atualizar item
Atualiza um item existente do Zendesk
Parâmetros
| Name | Chave | Necessá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 |
Devoluções
Criar Item
Cria um item do Zendesk
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome da tabela
|
table | True | string |
Tipo de item do Zendesk (exemplo: 'Ticket') |
|
Item
|
item | True | dynamic |
Item do Zendesk para criar |
Devoluções
Excluir item
Exclui um item do Zendesk
Parâmetros
| Name | Chave | Necessá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 excluir |
Obter item
Recupera um item do Zendesk
Parâmetros
| Name | Chave | Necessá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 |
Devoluções
Obter itens
Recupera itens do Zendesk de um determinado tipo de Zendesk (exemplo: 'Ticket')
Parâmetros
| Name | Chave | Necessá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). |
|
|
Encomendar por
|
$orderby | string |
Uma ordem ODATAPor consulta para especificar a ordem das entradas |
|
|
Pular 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 recuperar (padrão = 512) |
|
|
Selecionar consulta
|
$select | string |
Campos específicos para recuperar de entradas (padrão = todos). |
Devoluções
Obter mesas
Pesquisar Artigos
Devolve um número predefinido de 25 artigos por página, até um máximo de 1000 resultados.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
Artigo para pesquisar. |
|
Localidade
|
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 este ID de categoria. |
|
|
Seção
|
section | integer |
Limitar a pesquisa a este ID de secção |
|
|
Nomes de rótulos
|
label_names | string |
Uma lista separada por vírgulas de nomes de rótulos. |
|
|
Multimarcas
|
multibrand | boolean |
Habilite a pesquisa em todas as marcas, se for verdade. |
Devoluções
- Body
- SearchResult
Acionadores
| Quando um item é criado |
Aciona um fluxo quando um item é criado no Zendesk |
| Quando um item é modificado |
Aciona um fluxo quando um item é modificado no Zendesk |
| Quando um item é modificado |
Aciona um fluxo quando um item é modificado no Zendesk |
Quando um item é criado
Aciona um fluxo quando um item é criado no Zendesk
Parâmetros
| Name | Chave | Necessá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). |
|
|
Encomendar por
|
$orderby | string |
Uma ordem ODATAPor consulta para especificar a ordem das entradas |
|
|
Pular 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 recuperar (padrão = 512) |
Devoluções
Quando um item é modificado
Aciona um fluxo quando um item é modificado no Zendesk
Parâmetros
| Name | Chave | Necessá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). |
|
|
Encomendar por
|
$orderby | string |
Uma ordem ODATAPor consulta para especificar a ordem das entradas |
|
|
Pular 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 recuperar (padrão = 512) |
Devoluções
Quando um item é modificado
Aciona um fluxo quando um item é modificado no Zendesk
Parâmetros
| Name | Chave | Necessá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). |
|
|
Encomendar por
|
$orderby | string |
Uma ordem ODATAPor consulta para especificar a ordem das entradas |
|
|
Pular 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 recuperar (padrão = 512) |
Devoluções
Definições
Table
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
Name | string | |
|
Nome de Exibição
|
DisplayName | string |
Resultado da pesquisa
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
id
|
results.id | integer |
ID do artigo atribuído 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 desativados; falso caso contrário |
|
rascunho
|
results.draft | boolean |
True se a tradução para a localidade atual for um rascunho |
|
promovido
|
results.promoted | boolean |
Verdadeiro se este artigo for promovido; falso caso contrário. false por padrão |
|
posição
|
results.position | integer |
A posição deste artigo na lista de artigos. 0 por defeito |
|
vote_sum
|
results.vote_sum | integer |
A soma dos votos positivos (+1) e negativos (-1), que podem ser positivos ou negativos |
|
vote_count
|
results.vote_count | integer |
O número total de votos positivos e negativos |
|
section_id
|
results.section_id | integer |
O 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 |
|
região
|
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 |
O 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ão que define quem pode editar e publicar este artigo |
|
content_tag_ids
|
results.content_tag_ids | array of string |
A lista de tags de conteúdo anexadas ao artigo |
|
label_names
|
results.label_names | array of string |
Uma matriz de nomes de rótulos associados a este artigo |
|
body
|
results.body | string |
Corpo HTML do artigo |
|
fragmento
|
results.snippet | string |
Trechos HTML do artigo |
|
result_type
|
results.result_type | string |
Tipo de Resultado |
Lista de Tabelas
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | array of Table |