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 na Platform, você deve fornecer valores para as seguintes credenciais:
yoursubdomain
0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtf
Para obter mais informações sobre como autenticar sua origem Zendesk, consulte a Zendesk visão geral da origem.
Criar um esquema da plataforma para Zendesk
Antes de criar uma conexão de origem do Zendesk, você também deve garantir que primeiro crie um esquema da Platform para usar em sua origem. Consulte o tutorial sobre criação de um esquema da 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 da 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 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 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 na Platform.
Na interface da 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 da 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.active
results.alias
results.created_at
results.custom_role_id
results.default_group_id
results.details
results.email
results.external_id
results.iana_time_zone
results.id
results.last_login_at
results.locale
results.locale_id
results.moderator
results.name
results.notes
results.only_private_comments
results.organization_id
results.phone
results.photo
results.report_csv
results.restricted_agent
results.result_type
results.role
results.role_type
results.shared
results.shared_agent
results.shared_phone_number
results.signature
results.suspended
results.ticket_restriction
results.time_zone
results.two_factor_auth_enabled
results.updated_at
results.url
results.verified
Limites 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 comouser
e, 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