O Zendesk A fonte está em beta. Consulte a visão geral das fontes para obter mais informações sobre o uso de fontes com rótulo beta.
Este tutorial fornece etapas para criar um Zendesk conexão de origem usando a interface do usuário do Adobe Experience Platform.
Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
Para acessar o Zendesk na Platform, você deve fornecer valores para as seguintes credenciais:
Credencial | Descrição | Exemplo |
---|---|---|
Host | O domínio exclusivo específico da sua conta criado durante o processo de registro. | https://yoursubdomain.zendesk.com |
Token de acesso | Token da API do Zendesk. | 0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtf |
Para obter mais informações sobre como autenticar seu Zendesk na fonte, consulte o Zendesk visão geral da fonte.
Antes de criar um Zendesk na conexão de origem, você também deve garantir que primeiro crie um esquema da plataforma para usar na origem. Veja o tutorial em criação de um schema da plataforma para obter etapas abrangentes sobre como criar um schema.
Para obter mais orientações sobre Zendesk schema necessário para o Zendesk Search API, consulte o limites abaixo.
Na interface do usuário da plataforma, selecione Fontes na barra de navegação esquerda para acessar o Fontes espaço de trabalho. O 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.
Em Sucesso do cliente categoria , selecione Zendesk e selecione Adicionar dados.
O Conta do Zendesk será exibida. Nesta página, você pode usar novas credenciais ou credenciais existentes.
Para usar uma conta existente, selecione a Zendesk conta com a qual deseja criar um novo fluxo de dados e selecione Próximo para continuar.
Se estiver criando uma nova conta, selecione Nova conta e, em seguida, forneça um nome, uma descrição opcional e suas credenciais. Quando terminar, selecione Conectar-se à origem e, em seguida, permitir que a nova conexão seja estabelecida.
Depois que a origem é autenticada, a página é atualizada em uma árvore de esquema interativa que permite explorar e inspecionar a hierarquia de seus dados. Selecionar Próximo para continuar.
Ao seguir este tutorial, você autenticou e criou uma conexão de origem entre os Zendesk conta e plataforma. Agora você pode continuar para o próximo tutorial e criar um fluxo de dados para trazer os dados de sucesso do cliente para a Platform.
As seções abaixo fornecem recursos adicionais que você pode consultar ao usar o Zendesk fonte.
As linhas gerais a seguir podem ser usadas para validar que você conectou seu Zendesk e que Zendesk Os perfis estão sendo assimilados no Platform.
Na interface do usuário da plataforma, selecione Conjuntos de dados na navegação à esquerda para acessar o Conjuntos de dados espaço de trabalho. O 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 visualizar para ver detalhes específicos sobre a execução do fluxo de dados.
Finalmente, selecione Visualizar conjunto de dados para exibir os dados que foram assimilados.
Você também pode verificar os dados da sua plataforma em relação aos dados da Zendesk > Customers página.
A tabela abaixo lista os mapeamentos compatíveis que devem ser configurados para o Zendesk.
Consulte API de pesquisa do Zendesk > Exportar resultados de pesquisa para obter mais informações sobre a API.
Fonte | Tipo |
---|---|
results.active |
Booleano |
results.alias |
String |
results.created_at |
String |
results.custom_role_id |
Número inteiro |
results.default_group_id |
Número inteiro |
results.details |
String |
results.email |
String |
results.external_id |
Número inteiro |
results.iana_time_zone |
String |
results.id |
Número inteiro |
results.last_login_at |
String |
results.locale |
String |
results.locale_id |
Número inteiro |
results.moderator |
Booleano |
results.name |
String |
results.notes |
String |
results.only_private_comments |
Booleano |
results.organization_id |
Número inteiro |
results.phone |
String |
results.photo |
String |
results.report_csv |
Booleano |
results.restricted_agent |
Booleano |
results.result_type |
String |
results.role |
String |
results.role_type |
Número inteiro |
results.shared |
Booleano |
results.shared_agent |
Booleano |
results.shared_phone_number |
Booleano |
results.signature |
String |
results.suspended |
Booleano |
results.ticket_restriction |
String |
results.time_zone |
String |
results.two_factor_auth_enabled |
Booleano |
results.updated_at |
String |
results.url |
String |
results.verified |
Booleano |
filter[type]
é definido como user
e, portanto, a conexão do Zendesk retorna somente os usuários.page[size]
parâmetro. O valor é definido como 100
. Isso é feito para reduzir o impacto das restrições de redução de velocidade definidas pelo Zendesk.