Conexão Zendesk no Jitterbit Studio
Introdução
Uma conexão Zendesk, criada usando o conector Zendesk, estabelece acesso ao Zendesk. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Zendesk associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).
Nota
Este conector suporta a política de organização Habilitar Reautenticação em Mudanças. Se habilitado, uma alteração na URL da Empresa ou Email nesta conexão requer que os usuários reentrem o Token da API para a conexão.
Criar ou editar uma conexão Zendesk
Uma nova conexão Zendesk é criada usando o conector Zendesk a partir de uma destas localizações:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).
Uma conexão Zendesk existente pode ser editada a partir destas localizações:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A aba Componentes do painel do projeto (veja Menu de ações de componentes em Aba Componentes do painel do projeto).
- A página Endpoints Globais (veja Editar um endpoint global em Endpoints Globais).
Configurar uma conexão Zendesk
Cada elemento da interface do usuário da tela de configuração da conexão Zendesk é descrito abaixo.
Dica
Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.
-
Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Zendesk e não deve conter barras
/ou dois pontos:. Este nome também é usado para identificar o endpoint Zendesk, que se refere tanto a uma conexão específica quanto às suas atividades. -
URL da Empresa: Insira a URL da empresa associada à conta Zendesk.
-
Email: Insira o email associado à conta Zendesk.
-
Token da API: Insira o token da API, obtido do Zendesk.
-
Configurações Opcionais: Clique no botão Adicionar para especificar o Número Máximo de Tentativas de Status do Trabalho suportado.
- Número Máximo de Tentativas de Status do Trabalho: Define o número máximo de tentativas (padrão 300; mínimo 1, máximo 21600) que o conector irá consultar o Zendesk solicitando uma atualização sobre o status das solicitações enviadas antes de retornar os resultados. Se as respostas para todas as solicitações forem recebidas antes que o máximo seja alcançado, os resultados serão retornados. Este parâmetro se aplica apenas ao criar, atualizar ou excluir organizações ou tickets.
-
Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.
-
Salvar Alterações: Clique para salvar e fechar a configuração da conexão.
-
Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.
-
Excluir: Após abrir uma configuração de conexão existente, clique em Excluir para remover permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.
Próximas etapas
Depois que uma conexão Zendesk foi criada, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).
As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Noções básicas sobre conectores.
Estes tipos de atividade são atualmente suportados:
-
Pesquisar: Recupera dados de objetos do Zendesk com suporte para paginação de grandes conjuntos de dados e é destinado a ser usado como uma fonte em uma operação.
-
Criar: Cria dados de objetos no Zendesk e é destinado a ser usado como um alvo em uma operação.
-
Atualizar: Atualiza dados de objetos no Zendesk e é destinado a ser usado como um alvo em uma operação.
-
Excluir: Exclui dados de objetos do Zendesk e é destinado a ser usado como um alvo em uma operação.
Este tipo de atividade está obsoleto:
- Query: Recupera dados de objetos do Zendesk retornando um número limitado de registros e é destinado a ser usado como uma fonte em uma operação.