Zendesk conexão
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:
Bearer tokenSiga a documentação para gerar um Zendesk token de acesso se você não tiver um.
a0b1c2d3e4...v20w21x22y23zMedidas 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.
emailtest@test.comTipo 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.
- 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.
- 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
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.
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.
- 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
- 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.
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:
|Campo do Source|Campo do Target| 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:
-
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:
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.
| 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 |
|
| Março de 2023 | Versão inicial | Versão inicial de destino e publicação da documentação. |