Criar uma conexão de origem Zendesk na interface
Este tutorial fornece etapas para criar uma conexão de origem Zendesk usando a interface do usuário do Adobe Experience Platform.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de esquema.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
Coletar credenciais necessárias
Para acessar sua conta do Zendesk no Experience Platform, você deve fornecer valores para as seguintes credenciais:
yoursubdomain0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtfPara obter mais informações sobre como autenticar sua origem Zendesk, consulte a Zendesk visão geral da origem.
Criar um esquema do Experience Platform para Zendesk
Antes de criar uma conexão de origem Zendesk, você também deve garantir que primeiro crie um esquema do Experience Platform para usar na sua origem. Consulte o tutorial sobre criação de um esquema do Experience Platform para obter etapas abrangentes sobre como criar um esquema.
Para obter orientação adicional sobre o esquema Zendesk necessário para o Zendesk Search API, consulte a seção limites abaixo.
Conectar sua conta do Zendesk
Na interface do usuário do Experience Platform, selecione Fontes na barra de navegação esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.
Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.
Na categoria Sucesso do cliente, selecione Zendesk e Adicionar dados.
A página Conectar conta do Zendesk é exibida. Nesta página, você pode usar credenciais novas ou existentes.
Conta existente
Para usar uma conta existente, selecione a conta do Zendesk com a qual deseja criar um novo fluxo de dados e selecione Avançar para continuar.
Nova conta
Se você estiver criando uma nova conta, selecione Nova conta e forneça um nome, uma descrição opcional e suas credenciais. Quando terminar, selecione Conectar à origem e aguarde algum tempo para que a nova conexão seja estabelecida.
Selecionar dados
Depois que a fonte é autenticada, a página é atualizada em uma árvore de esquema interativa que permite explorar e inspecionar a hierarquia dos dados. Selecione Avançar para continuar.
Próximas etapas
Seguindo este tutorial, você autenticou e criou uma conexão de origem entre sua conta do Zendesk e a Experience Platform. Agora você pode seguir para o próximo tutorial e criar um fluxo de dados para trazer os dados de sucesso do cliente para a Experience Platform.
Recursos adicionais
As seções abaixo fornecem recursos adicionais que você pode consultar ao usar a origem Zendesk.
Validação validation
As etapas a seguir descrevem as etapas que você pode seguir para validar se conectou com êxito a origem do Zendesk e se os perfis do Zendesk estão sendo assimilados para o Experience Platform.
Na interface do Experience Platform, selecione Conjuntos de dados na navegação à esquerda para acessar o espaço de trabalho Conjuntos de dados. A tela Atividade do Conjunto de Dados exibe os detalhes das execuções.
Em seguida, selecione a ID de execução do fluxo de dados que deseja exibir para ver detalhes específicos sobre essa execução do fluxo de dados.
Finalmente, selecione Visualizar conjunto de dados para exibir os dados que foram assimilados.
Você também pode verificar seus dados do Experience Platform em relação aos dados na página Zendesk > Customers.
Esquema do Zendesk
A tabela abaixo lista os mapeamentos suportados que devem ser configurados para o Zendesk.
results.activeresults.aliasresults.created_atresults.custom_role_idresults.default_group_idresults.detailsresults.emailresults.external_idresults.iana_time_zoneresults.idresults.last_login_atresults.localeresults.locale_idresults.moderatorresults.nameresults.notesresults.only_private_commentsresults.organization_idresults.phoneresults.photoresults.report_csvresults.restricted_agentresults.result_typeresults.roleresults.role_typeresults.sharedresults.shared_agentresults.shared_phone_numberresults.signatureresults.suspendedresults.ticket_restrictionresults.time_zoneresults.two_factor_auth_enabledresults.updated_atresults.urlresults.verifiedLimites limits
-
A API de Pesquisa do Zendesk > Exportar Resultados da Pesquisa retorna um máximo de 1000 registros por página.
- O valor do parâmetro
filter[type]está definido comousere, portanto, a conexão do Zendesk retorna somente usuários. - O número de resultados por página é gerenciado pelo parâmetro
page[size]. O valor está definido como100. Isso é feito para reduzir o impacto das restrições de redução de velocidade definidas pelo Zendesk. - Consulte Limites e Paginação.
- Também é possível consultar Paginação por meio de listas usando a paginação de cursor.
- O valor do parâmetro