As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Integração com a Zendesk Suite
Gerencie seus tickets de suporte do Zendesk diretamente do Amazon Quick usando linguagem natural. Com o conector de ação da Zendesk Suite, você pode criar, atualizar, pesquisar e listar tickets de suporte sem sair do Amazon Quick.
A Zendesk Suite está disponível como um conector integrado no Amazon Quick. Para configurar essa integração, conclua as duas etapas a seguir. Primeiro, prepare sua conta do Zendesk com o acesso necessário. Em seguida, crie o conector no Amazon Quick e autentique-o com suas credenciais do Zendesk.
Esse conector é compatível com autenticação de usuário OAuth e autenticação de serviço de chave de API. Para obter informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.
Pré-requisitos
Antes de configurar a integração, verifique se você tem os seguintes recursos e acesso.
-
Uma conta ativa do Zendesk com função de administrador.
-
Permissões para acessar tickets e dados de suporte em sua instância do Zendesk.
-
Uma assinatura que atenda aos requisitos descritos emConfigurar integrações no console.
Verifique sua conta do Zendesk
Antes de configurar o Amazon Quick, verifique se sua conta do Zendesk atende aos seguintes requisitos.
-
Sua conta do Zendesk está ativa e você pode entrar na página de login do Zendesk no site
do Zendesk. -
Os tickets e os dados de suporte que você deseja acessar estão acessíveis em sua conta.
Configurar conta do Zendesk
O método personalizado de autenticação do aplicativo OAuth no Amazon Quick exige um cliente OAuth configurado no Zendesk. O método de autenticação da chave de API requer um token de API.
Para configurar um cliente OAuth
-
Em sua instância do Zendesk, navegue até a Central de administração, depois Aplicativos e integrações e, em seguida, clientes OAuth em API.
-
Escolha Adicionar cliente OAuth.
-
Preencha o formulário com os seguintes campos:
-
Nome — Insira um nome para seu aplicativo.
-
Descrição — Insira uma breve descrição.
-
Identificador — insira um identificador exclusivo para o cliente OAuth.
-
Redirecionar URLs — Digite.
https://region.quicksight.aws.amazon.com/sn/oauthcallbackregionSubstitua por sua AWS região, por exemplo,us-east-1.
-
-
Escolha Salvar. O Zendesk gera um segredo para o cliente.
Importante
Grave o segredo do cliente agora. Você não pode recuperá-lo depois de sair desta página.
-
Depois de capturar o segredo, escolha Salvar novamente para criar o cliente OAuth.
O identificador e o segredo servem como ID do cliente e segredo do cliente quando você configura o conector de ação no Amazon Quick com o método de autenticação do aplicativo OAuth personalizado.
Para obter mais informações, consulte Uso da autenticação OAuth com seu aplicativo no site
Para configurar um token de API
-
Navegue até a Central de administração, depois Aplicativos e integrações e, em seguida, tokens de API.
-
Escolha Adicionar token de API.
-
Em Descrição, insira uma breve descrição para o token da API.
-
Escolha Salvar. O Zendesk gera um token de API.
Importante
Grave o token da API agora. Você não pode recuperá-lo depois de sair desta página.
Se você escolher o método de autenticação da chave de API no Amazon Quick, use esse token de API como o valor da chave de API.
Para obter mais informações, consulte Gerenciamento do acesso por token de API à API do Zendesk
Configure a integração no Amazon Quick
Depois de verificar o acesso à sua conta do Zendesk, crie o conector no Amazon Quick.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Escolha a Zendesk Suite entre as opções disponíveis.
-
Na caixa de diálogo da Zendesk Suite, insira os seguintes campos:
-
Nome — Um nome descritivo para seu conector Zendesk.
-
Descrição (Opcional) — Escolha + Adicionar descrição para adicionar notas sobre como esse conector será usado.
-
Tipo de conexão — Escolha Rede pública.
-
-
Escolha seu método de autenticação e defina as configurações do conector:
-
Aplicativo OAuth personalizado — Insira os seguintes campos para sua instância do Zendesk:
-
URL base
-
ID do cliente
-
Segredo do cliente
-
URL do token
-
URL de autorização
-
URL de redirecionamento
-
-
Chave de API — Insira os seguintes campos:
-
URL base
-
Chave de API (token de API do Zendesk)
-
E-mail associado à sua conta do Zendesk
-
-
-
Escolha Próximo.
-
Analise as ações da Zendesk Suite e escolha Avançar.
-
Especifique quem pode acessar o conector:
-
Para compartilhar com uma equipe, insira o nome da equipe ou o e-mail do grupo.
-
Para mantê-lo privado, deixe o campo em branco.
-
Para compartilhar com todos os usuários, ative Todos na sua organização.
-
-
Selecione Publish.
O conector aparece no painel Disponível com o status Conectado.
Ações disponíveis
Depois de configurar o conector, você pode usar as seguintes ações de gerenciamento de tickets.
| Ação | Description |
|---|---|
| Criar tíquete | Criar novo tíquete |
| Listar resultados da pesquisa | Pesquisar ingressos |
| Listar ingressos | Ver todos os ingressos |
| Bilhete do show | Exibir detalhes do ingresso |
| Atualizar tíquete | Editar detalhes do ingresso |
nota
As ações que você pode usar dependem das permissões configuradas em sua conta do Zendesk.
Solução de problemas
Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.
Problemas de autenticação
-
Sign-in falha — Verifique se sua conta do Zendesk está ativa e se você pode entrar na página de login do Zendesk no site
do Zendesk. Se sua organização usa login único (SSO), confirme se seu provedor de identidade está configurado corretamente. -
Acesso negado — confirme se seu usuário do Zendesk tem uma função de administrador com permissões para acessar tickets e dados de suporte. Para conexões de chave de API, verifique se o token de API é válido e se o endereço de e-mail associado está correto.
