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, consulte[Métodos de autenticação](quick-action-auth.md). ## 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 em[Configurar integrações no console](integration-console-setup-process.md). ## 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](https://www.zendesk.com/login/) 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 1. **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.** 1. Escolha **Adicionar cliente OAuth.** 1. 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/oauthcallback` {{region}}Substitua por sua AWS região, por exemplo,`us-east-1`. 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. 1. 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](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application) da Zendesk. ### Para configurar um token de API 1. Navegue até a **Central de administração**, depois **Aplicativos e integrações** e, em seguida, **tokens de API**. 1. Escolha **Adicionar token de API**. 1. Em **Descrição**, insira uma breve descrição para o token da API. 1. 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](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) no site do Zendesk. ## Configure a integração no Amazon Quick Depois de verificar o acesso à sua conta do Zendesk, crie o conector no Amazon Quick. 1. No console do Amazon Quick, escolha **Conectores**. 1. Escolha a guia **Criar para sua equipe**. 1. Escolha a **Zendesk Suite** entre as opções disponíveis. 1. 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**. 1. 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 1. Escolha **Próximo**. 1. Analise as ações da Zendesk Suite e escolha **Avançar**. 1. 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**. 1. 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ções disponíveis da Zendesk Suite** | 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, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations). ### 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](https://www.zendesk.com/login/) 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.