Zendesk Visão geral da extensão da API de eventos
O Zendesk é uma solução de atendimento ao cliente e uma ferramenta de vendas. A extensão encaminhamento de eventos do Zendesk aproveita o Zendesk Events API para enviar eventos do Edge Network Adobe Experience Platform para o Zendesk para processamento adicional. Você pode usar a extensão para coletar interações de perfil do cliente para uso na análise e na ação de downstream.
Este documento aborda como instalar e configurar a extensão na interface do usuário do.
Pré-requisitos
Você deve ter uma conta do Zendesk para usar essa extensão. Você pode se inscrever para obter uma conta do Zendesk no site do Zendesk.
Você também deve coletar os seguintes detalhes para sua configuração do Zendesk:
xxxxx.zendesk.com
(onde xxxxx
é o valor fornecido durante a criação da conta)cwWyOtHAv12w4dhpiulfe9BdZFTz3OKaTSzn2QvV
Por fim, você deve criar um segredo de encaminhamento de eventos para o token da API. Defina o tipo secreto como Token e defina o valor para o token de API que você coletou da sua configuração do Zendesk. Consulte a documentação sobre segredos no encaminhamento de eventos para obter mais detalhes sobre como configurar segredos.
Instalar a extensão install
Para instalar a extensão do Zendesk na interface do usuário, navegue até Encaminhamento de eventos e selecione uma propriedade à qual adicionar a extensão ou crie uma nova propriedade.
Depois de selecionar ou criar a propriedade desejada, navegue até Extensões > Catálogo. Pesquise por "Zendesk" e selecione Install na Extensão do Zendesk.
Configurar a extensão configure
Selecione Extensões na navegação à esquerda. Em Instalado, selecione Configurar na extensão do Zendesk.
Em Domínio do Zendesk, insira o valor para o subdomínio do Zendesk. Em Zendesk Token, selecione o segredo criado anteriormente que contém o token da API.
Configurar uma regra de encaminhamento de eventos
Comece a criar uma nova regra de encaminhamento de eventos regra e configure suas condições conforme desejado. Ao selecionar as ações para a regra, selecione a extensão Zendesk e selecione o tipo de ação Criar evento.
Ao configurar a configuração da ação, você é solicitado a atribuir elementos de dados às várias propriedades que serão enviadas para o Zendesk.
Esses elementos de dados devem ser mapeados conforme referenciado abaixo.
event
chaves
event
é um objeto JSON que representa o evento acionado pelo usuário. Consulte o documento do Zendesk sobre a anatomia de um evento para obter detalhes sobre as propriedades capturadas pelo objeto event
.
As seguintes chaves podem ser referenciadas dentro do objeto event
ao mapear para elementos de dados:
event
source
arc.event.xdm._extconndev.event_source
Zendesk
como um valor, pois é um nome de origem protegido para eventos padrão do Zendesk. Tentar usá-lo resultará em um erro.O valor não deve exceder 40 caracteres.
type
arc.event.xdm._extconndev.event_type
description
arc.event.xdm._extconndev.description
created_at
arc.event.xdm.timestamp
properties
arc.event.xdm._extconndev.EventProperties
profile
chaves
profile
é um objeto JSON que representa o usuário que acionou o evento. Consulte o documento do Zendesk sobre a anatomia de um perfil para obter detalhes sobre as propriedades capturadas pelo objeto profile
.
As seguintes chaves podem ser referenciadas dentro do objeto profile
ao mapear para elementos de dados:
profile
source
arc.event.xdm._extconndev.profile_source
Support
, CompanyName
ou Chat
.type
arc.event.xdm._extconndev.profile_type
name
arc.event.xdm._extconndev.name
user_id
arc.event.xdm._extconndev.user_id
identifiers
arc.event.xdm._extconndev.identifiers
identifiers
. Todos os campos e valores devem ser exclusivos.attributes
arc.event.xdm._extconndev.attrbutes
Validar dados no Zendesk validate
Se a coleção de eventos e a integração do Adobe Experience Platform forem bem-sucedidas, os eventos no console do Zendesk deverão aparecer conforme mostrado abaixo. Isso indica uma integração bem-sucedida.
Perfis:
Eventos:
Limites de solicitação limits
Com base no tipo de conta, o Zendesk Events API pode lidar com o seguinte número de solicitações por minuto:
Consulte a Documentação do Zendesk para obter mais informações sobre esses limites.
Erros e solução de problemas errors-and-troubleshooting
Ao usar ou configurar a extensão, os erros abaixo podem ser retornados pela API de eventos do Zendesk:
{"error": [{"code":"InvalidProfileTypeLength","title": "Profile type length > 40 chars"}]}
{subdomain}.zendesk.com
{"error": [{"description": "No route found for host {subdomain}.zendesk.com","title": "RouteNotFound"}]}
{"error": [{"code":"MissingOrInvalidAuthentication","title": "Invalid or Missing Authentication"}]}
{"error": [{"code":"PermissionDenied","title": "Insufficient permisssions to perform operation"}]}
{"error": [{"code":"TooManyRequests","title": "Too Many Requests"}]}
Próximas etapas
Este documento abordou como instalar e configurar a extensão de encaminhamento de eventos do Zendesk na interface do usuário do. Para obter mais informações sobre como coletar dados do evento no Zendesk, consulte a documentação oficial: