Documentação Experience Platform Guia de destinos

Zendesk conexão

Last update: Wed Jul 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Destinos

Criado para:

Administrador
Usuário

Zendesk é uma solução de atendimento ao cliente e uma ferramenta de vendas.

Este Adobe Experience Platform destino aproveita a Zendesk API de Contatos para criar e atualizar identidades dentro de um público-alvo como contatos dentro de Zendesk.

Zendesk usa tokens de portador como um mecanismo de autenticação para se comunicar com a API de Contatos do Zendesk. As instruções para autenticar na sua instância do Zendesk estão mais abaixo, na seção Autenticar no destino.

Casos de uso use-cases

O departamento de atendimento ao cliente de uma plataforma B2C multicanal deseja garantir uma experiência personalizada contínua para seus clientes. O departamento pode criar públicos-alvo a partir de seus próprios dados offline para criar novos perfis de usuário ou atualizar informações de perfil existentes de diferentes interações (por exemplo, compras, devoluções etc.) e envie esses públicos do Adobe Experience Platform para Zendesk. Ter as informações atualizadas no Zendesk garante que o agente de atendimento ao cliente tenha as informações recentes do cliente imediatamente disponíveis, permitindo respostas e soluções mais rápidas.

Pré-requisitos prerequisites

Pré-requisitos do Experience Platform prerequisites-in-experience-platform

Antes de ativar dados para o destino Zendesk, você deve ter um esquema, um conjunto de dados e segmentos criados em Experience Platform.

Consulte a documentação do Experience Platform para Grupo de campos do esquema de Detalhes da associação do público-alvo se precisar de orientação sobre os status do público-alvo.

Zendesk pré-requisitos prerequisites-destination

Para exportar dados da Platform para sua conta Zendesk, é necessário ter uma conta Zendesk.

Obter credenciais de Zendesk gather-credentials

Anote os itens abaixo antes de autenticar no destino Zendesk:

Credencial

Descrição

Exemplo

Bearer token

O token de acesso gerado na sua conta Zendesk.
Siga a documentação para gerar um Zendesk token de acesso se você não tiver um.

a0b1c2d3e4...v20w21x22y23z

Medidas de proteção guardrails

A página Limites de Preço e Taxa detalha os limites de API Zendesk associados à sua conta. Você precisa garantir que seus dados e carga estejam dentro dessas restrições.

Identidades suportadas supported-identities

Zendesk oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino

Exemplo

Descrição

Obrigatório

email

test@test.com

Endereço de email do contato.

Sim

Tipo e frequência de exportação export-type-frequency

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Item

Tipo

Notas

Tipo de exportação

Baseado em perfil

Você está exportando todos os membros de um segmento, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), de acordo com o mapeamento de campos.
Cada status de segmento em Zendesk é atualizado com o status de público correspondente da Platform, com base no valor ID de Mapeamento fornecido durante a etapa agendamento de público-alvo.

Frequência de exportação

Streaming

Os destinos de transmissão são conexões baseadas em API "sempre ativas". Assim que um perfil é atualizado em Experience Platform com base na avaliação do público-alvo, o conector envia a atualização downstream para a plataforma de destino. Leia mais sobre destinos de streaming.

Conectar ao destino connect

IMPORTANT

Para se conectar ao destino, você precisa de Exibir Destinos e Gerenciar Destinos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.

Em Destinos > Catálogo, pesquise por Zendesk. Como alternativa, você pode localizá-lo na categoria CRM.

Autenticar para o destino authenticate

Preencha os campos obrigatórios abaixo. Consulte a seção Coletar Zendesk credenciais para obter qualquer orientação.

Token do portador: o token de acesso gerado na sua conta do Zendesk.

Para autenticar no destino, selecione Conectar ao destino.
Captura de tela da interface do usuário da plataforma mostrando como autenticar.

Se os detalhes fornecidos forem válidos, a interface exibirá um status Conectado com uma marca de seleção verde. Você pode prosseguir para a próxima etapa.

Preencher detalhes do destino destination-details

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.
Captura de tela da Interface do Usuário da Plataforma mostrando os detalhes de destino.

Nome: um nome pelo qual você reconhecerá este destino no futuro.
Descrição: uma descrição que ajudará você a identificar este destino no futuro.

Ativar alertas enable-alerts

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.

Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.

Ativar públicos-alvo para esse destino activate

IMPORTANT

Para ativar dados, você precisa de Exibir Destinos, Ativar Destinos, Exibir Perfis e Exibir Segmentos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.
Para exportar identidades, você precisa da permissão Exibir Gráfico de Identidade controle de acesso.

{width="100" modal="regular"}

Leia Ativar perfis e públicos-alvo para destinos de exportação de público-alvo de streaming para obter instruções sobre como ativar públicos-alvo para este destino.

Considerações e exemplo de mapeamento mapping-considerations-example

Para enviar corretamente seus dados de público-alvo do Adobe Experience Platform para o destino Zendesk, é necessário passar pela etapa de mapeamento de campos. O mapeamento consiste em criar um link entre os campos do esquema do Experience Data Model (XDM) na sua conta da Platform e seus equivalentes correspondentes no destino.

Os atributos especificados no campo de Destino devem ser nomeados exatamente como descrito na tabela de mapeamentos de atributos, pois esses atributos formarão o corpo da solicitação.

Os atributos especificados no campo Source não seguem nenhuma restrição desse tipo. Você pode mapeá-lo com base na sua necessidade. No entanto, se o formato dos dados não estiver correto quando enviado para o Zendesk, ocorrerá um erro.

Para mapear corretamente os campos XDM para os campos de destino Zendesk, siga estas etapas:

Na etapa Mapeamento, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.
Na janela Selecionar campo de origem, escolha a categoria Selecionar atributos e selecione o atributo XDM ou escolha o Selecionar namespace de identidade e selecione uma identidade.

Na janela Selecionar campo de destino, escolha a categoria Selecionar namespace de identidade e selecione uma identidade de destino, ou escolha a categoria Selecionar atributos e selecione um dos atributos de esquema compatíveis.

Repita essas etapas para adicionar os seguintes mapeamentos obrigatórios: você também pode adicionar outros atributos que deseja atualizar entre o esquema de perfil XDM e a instância Zendesk:

table 0-row-3 1-row-3 2-row-3 3-row-3
Campo de origem	Campo de público alvo	Obrigatório
`xdm: person.name.lastName`	`xdm: last_name`	Sim
`IdentityMap: Email`	`Identity: email`	Sim
`xdm: person.name.firstName`	`xdm: first_name`

Um exemplo usando esses mapeamentos é mostrado abaixo:

IMPORTANT

Os mapeamentos de destino Attribute: last_name e Identity: email são obrigatórios para este destino. Se esses mapeamentos estiverem ausentes, qualquer outro mapeamento será ignorado e não será enviado para Zendesk.

Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Avançar.

Agendar exportação de público e exemplo schedule-segment-export-example

Na etapa Agendar exportação de público-alvo do fluxo de trabalho de ativação, você deve mapear manualmente os públicos-alvo da Platform para o atributo de campo personalizado em Zendesk.

Para fazer isso, selecione cada segmento e insira o atributo de campo personalizado correspondente de Zendesk no campo ID de Mapeamento.

Um exemplo é mostrado abaixo:
Exemplo de captura de tela da Interface do Usuário da Plataforma mostrando a opção Agendar exportação de público.

Validar exportação de dados exported-data

Para validar se você configurou o destino corretamente, siga as etapas abaixo:

Selecione Destinos > Procurar e navegue até a lista de destinos.
Em seguida, selecione o destino e alterne para a guia Dados de ativação e selecione um nome de público-alvo.
Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem no segmento.
Faça logon no site Zendesk e navegue até a página Contatos para verificar se os perfis do público-alvo foram adicionados. Esta lista pode ser configurada para exibir colunas para os campos adicionais criados com o público-alvo ID de Mapeamento e status de público-alvo.
Como alternativa, você pode detalhar uma página individual de Pessoa e verificar a seção Campos adicionais que exibe o nome do público-alvo e os status do público-alvo.

Uso e governança de dados data-usage-governance

Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform impõe a governança de dados, consulte a visão geral da Governança de Dados.

Recursos adicionais additional-resources

Informações adicionais úteis da documentação do Zendesk estão abaixo:

Changelog

Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.

Exibir changelog

table 0-row-3 1-row-3 2-row-3 layout-auto
Mês de lançamento	Tipo de atualização	Descrição
Abril de 2023	Atualização da documentação	Atualizamos a seção casos de uso com um exemplo mais claro de quando os clientes se beneficiariam com o uso desse destino. Atualizamos a seção mapeamento para refletir os mapeamentos necessários corretos. Os mapeamentos de destino `Attribute: last_name` e `Identity: email` são obrigatórios para este destino. Se esses mapeamentos estiverem ausentes, qualquer outro mapeamento será ignorado e não será enviado para Zendesk. Atualizamos a seção mapping com exemplos claros de mapeamentos obrigatórios e opcionais.
Março de 2023	Versão inicial	Versão inicial de destino e publicação da documentação.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6