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á.

# ZoomInfo integração
<a name="zoominfo-integration"></a>

Com o conector de ZoomInfo ação, você pode pesquisar dados da empresa e de contato e consultar dados firmográficos e de intenção diretamente no Amazon Quick por meio de linguagem natural.

O Amazon Quick oferece suporte a vários métodos de autenticação para ZoomInfo. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.
+ Aplicativo **OAuth padrão — usa um aplicativo** OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Os usuários se autenticam diretamente com suas ZoomInfo contas.
+ Aplicativo **OAuth personalizado — usa um aplicativo** OAuth gerenciado pelo cliente. Essa opção dá à sua organização controle total sobre a configuração do OAuth.
+ **Service-to-Service OAuth** — usa credenciais do cliente para autenticação de servidor a servidor sem interação com o usuário. Adequado para fluxos de trabalho automatizados.
+ **Chave de API** — usa uma chave de API para autenticação.

Para obter mais 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).

## Antes de começar
<a name="zoominfo-integration-prerequisites"></a>

Verifique se você tem o seguinte antes de configurar a integração.
+ Uma ZoomInfo conta ativa com acesso aos produtos de dados que você deseja consultar.
+ Para **aplicativo OAuth personalizado ou OAuth**: **Service-to-Service credenciais OAuth** do seu administrador. ZoomInfo ZoomInfo usa Okta para OAuth.
+ Para **chave de API**: uma chave de ZoomInfo-issued API.
+ Para obter os requisitos de assinatura do Amazon Quick, consulte[Configurar integrações no console](integration-console-setup-process.md).

## Configurando ZoomInfo
<a name="zoominfo-source-setup"></a>

Se você estiver usando a autenticação **padrão do aplicativo OAuth**, pule esta seção e prossiga para. [Configurando o conector no Amazon Quick](#zoominfo-quicksuite-setup)

Para um aplicativo OAuth personalizado ou autenticação Service-to-Service OAuth, trabalhe com seu ZoomInfo administrador para registrar um cliente OAuth no locatário do ZoomInfo Okta e adicionar o URL de retorno de chamada do Amazon Quick como um URI de redirecionamento. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` {{{region}}}Substitua pela sua AWS região (por exemplo,`us-east-1`). Para obter instruções passo a passo, consulte a [Visão geral do ZoomInfo MCP](https://docs.zoominfo.com/docs/zi-api-mcp-overview/) e o [Guia do Portal do Desenvolvedor](https://docs.zoominfo.com/docs/app-creation-developer-portal-guide) na documentação. ZoomInfo Registre o ID do cliente e o segredo do cliente — você precisa deles ao configurar o Amazon Quick. Para a autenticação da chave de API, gere uma chave de API da sua ZoomInfo conta.

## Configurando o conector no Amazon Quick
<a name="zoominfo-quicksuite-setup"></a>

### Conecte-se a partir da guia Disponível
<a name="zoominfo-quick-connect"></a>

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia **Disponível** sem configuração adicional.

1. No console do Amazon Quick, escolha **Conectores**.

1. Na guia **Disponível**, **ZoomInfo**localize e escolha **Connect**.

1.  ZoomInfo Conclua o fluxo de login e conceda as permissões solicitadas.

Para configurar um conector com um dos outros métodos de autenticação, use a guia **Criar para sua equipe**, conforme descrito abaixo.

### Crie a partir da guia Criar para sua equipe
<a name="zoominfo-full-setup"></a>

1. No console do Amazon Quick, escolha **Conectores**.

1. Escolha a guia **Criar para sua equipe**.

1. Encontre e escolha **ZoomInfo**.

1. Insira um **nome** para seu conector. Opcionalmente, escolha **\+ Adicionar descrição** para adicionar uma descrição.

1. Em **Tipo de conexão**, escolha **Rede pública**.

1. Para **Configuração do OAuth**, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.

   1. Para o **aplicativo OAuth padrão**:

      Nenhuma credencial adicional é necessária. Escolha **Próximo** para continuar.

   1. Para o **aplicativo OAuth personalizado**, configure os seguintes campos:
      + **ID do cliente** — O ID do cliente do seu cliente ZoomInfo OAuth.
      + **Cliente OAuth público** (opcional) — Selecione essa opção se seu cliente ZoomInfo OAuth estiver configurado como um cliente público (sem segredo do cliente).
      + **Segredo do cliente** — O segredo do cliente do seu cliente ZoomInfo OAuth.
      + **URL do token** — O endpoint do token. Padrão: `https://okta-login.zoominfo.com/oauth2/default/v1/token`
      + **URL de autorização** — O endpoint de autorização. Padrão: `https://okta-login.zoominfo.com/oauth2/default/v1/authorize`
      + URL de **redirecionamento — Pre-filled com o URL** de retorno de chamada do Amazon Quick.

   1. Para **Service-to-ServiceOAuth**, configure os seguintes campos:
      + **ID do cliente** — O ID do cliente do seu cliente ZoomInfo OAuth.
      + **Segredo do cliente** — O segredo do cliente do seu cliente ZoomInfo OAuth.
      + **URL do token** — O endpoint do token. Padrão: `https://okta-login.zoominfo.com/oauth2/default/v1/token`

   1. Para a **chave de API**, configure os seguintes campos:
      + **Chave de API** — A chave de ZoomInfo API.
      + **E-mail** (opcional) — O endereço de e-mail associado à chave de API.

1. Escolha **Próximo**.

1. Se você escolher Aplicativo **OAuth padrão ou Aplicativo** **OAuth personalizado**, uma ZoomInfo janela de autorização será aberta. Revise as permissões solicitadas e escolha **Permitir**.

1. Na página **Revisar**, revise as ações disponíveis para o conector. Escolha **Próximo**.

1. Na página **Publicar**, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

1. Selecione **Publish**.

## Ações disponíveis
<a name="zoominfo-integration-actions"></a>

Depois de configurar o conector, as ações expostas por ZoomInfo ficam disponíveis. Para ver o conjunto atual de ações do seu conector, acesse a visualização de **ações disponíveis** do conector no console do Amazon Quick.

## Gerenciamento e solução de problemas
<a name="zoominfo-integration-troubleshooting"></a>

Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).

### Problemas de autenticação
<a name="zoominfo-troubleshooting-auth"></a>
+ **Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado)** — Verifique se sua ZoomInfo conta está ativa. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu ZoomInfo cliente OAuth corresponde ao URL de retorno de chamada do Amazon Quick.
+ **Credenciais de cliente inválidas (aplicativo OAuth personalizado ou Service-to-Service OAuth)** — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores do seu cliente OAuth. ZoomInfo 
+ **Falha na autenticação da chave de API** — verifique se a chave de API não foi revogada.