Contact Center AI Platform (CCAI Platform) oferece suporte à integração com o CRM da Zendesk. Este guia aborda as etapas necessárias para realizar essa integração. As seguintes aplicações do Zendesk são compatíveis:
Chamada: versão mais recente: v1.4.0
Chat: versão mais recente: v1.3.0
Antes de começar
Estes são os pré-requisitos para a integração do CRM do Zendesk:
Faça login no portal da plataforma CCAI como administrador.
Conta do Zendesk no plano Professional ou Enterprise.
Baixe os arquivos do app Zendesk.
Leia as instruções antes de instalar.
Instalação
Os apps do Zendesk são particulares. Eles não estão listados no Zendesk App Marketplace público. Entre em contato com seu representante do Zendesk para receber e instalar na sua conta do Zendesk.
Os apps do Zendesk podem ser instalados seguindo estas instruções ou clicando no link nos apps do Zendesk. Para fazer upload e instalar um app particular no Zendesk Support:
Faça login no Zendesk e clique no ícone Admin na barra lateral.
Selecione Apps > Gerenciar.
Clique em Fazer upload do app.
Insira um nome para o app. Recomendamos usar Chamada para o app de chamadas e Chat para o app de chat.
Clique em Escolher arquivo e selecione o arquivo ZIP do app particular.
Para o app de chamadas, o nome do arquivo é zendesk-call-v1.4.zip.
Para o app de chat, o nome do arquivo é zendesk-chat-v1.3.zip.
Clique em Fazer upload.
Na janela exibida, clique em Concordar e fazer upload deste app.
Insira o subdomínio da sua conta.
Ative as restrições de função ou grupo e insira a função ou o grupo, se necessário.
Quando solicitado, clique em Instalar.
Quando o processo for concluído, o app particular vai aparecer na lista de apps instalados na página Gerenciar apps.
Repita as etapas se for necessário instalar os apps de chamada e de chat.


Para a configuração do app, especifique os seguintes valores de campo:
- Subdomínio: insira o subdomínio da sua conta do Zendesk, que você já deve conhecer. (cliente, por exemplo, customer.example.com)
-- Nome de domínio: deixe o valor padrão example.com.
Gerenciamento de apps
Depois de instalados, os aplicativos de chat e chamadas podem ser gerenciados pelo Zendesk.
Alterar as configurações do app
Para mudar as configurações do aplicativo, siga estas instruções. É possível mudar as configurações de um app, incluindo o título.
Faça login no Zendesk e clique no ícone Admin na barra lateral.
Selecione Apps > Gerenciar.
Na página Meus apps, encontre o app que você quer mudar.
Clique no ícone do app para abrir a página de configurações dele.
Faça as mudanças desejadas e clique em Salvar configurações na parte de baixo da página. Suas alterações foram salvas.
Atualizar apps
Periodicamente, pode ser necessário atualizar os apps instalados. Para atualizar um app, siga estas instruções:
Você pode encontrar instruções para atualizar um app particular ou clicar no link a seguir da Zendesk, "Apps particulares".
Faça login no Zendesk e clique no ícone Admin na barra lateral.
Selecione Apps > Gerenciar.
Na página Meus apps, encontre o app que você quer atualizar.
Clique no ícone no ícone do app para abrir o menu de configurações.
Clique em Atualizar para abrir a tela em que você pode fazer upload de um arquivo zip atualizado.
Configurar um cliente OAuth
Os apps do Zendesk usam o OAuth2 para autenticar solicitações de API para o Zendesk. Configure um cliente OAuth para apps do Zendesk.
As instruções a seguir orientam você no processo de configuração do OAuth, incluindo o registro do aplicativo no Zendesk.
Registro de aplicativos
No Zendesk Support, clique em Gerenciar .
Selecione API na categoria "Canais".
Clique na guia Clientes OAuth na página "Canais / API".
Clique no ícone no lado direito da lista de clientes.
Preencha os seguintes campos para criar um cliente:
Nome do cliente: insira um nome para o app. Esse é o nome que os usuários vão ver quando precisarem conceder acesso ao aplicativo e quando verificarem a lista de apps de terceiros que têm acesso ao Zendesk deles.
Descrição: (opcional) uma breve descrição do seu app que os usuários vão ver quando for solicitado que concedam acesso a ele.
Empresa: (opcional) é o nome da empresa que os usuários vão ver quando precisarem conceder acesso ao seu aplicativo. Essas informações ajudam a entender a quem estão concedendo acesso.
Logotipo: (opcional) é o logotipo que os usuários vão ver quando for solicitado que eles concedam acesso ao seu aplicativo. A imagem pode ser um JPG, GIF ou PNG. Para melhores resultados, faça upload de uma imagem quadrada. Ela será redimensionada para a página de autorização.
Identificador exclusivo: o campo é preenchido automaticamente com uma versão reformatada do nome inserido para o app. Você pode mudar se quiser.
URLs de redirecionamento: insira o URL ou URLs que o Zendesk deve usar para enviar a decisão do usuário de conceder acesso ao seu aplicativo. Os URLs precisam ser absolutos e não relativos, https (a menos que sejam localhost ou 127.0.0.1) e separados por quebras de linha.
Clique em Salvar.
Depois que a página for atualizada, um novo campo Secret preenchido automaticamente vai aparecer na parte de baixo. Esse é o valor
client_secretespecificado na especificação do OAuth2.Copie o valor de Secret para a área de transferência e salve-o em um lugar seguro.
Defina o URL de redirecionamento do OAuth.
https://YOUR_SUBDOMAIN.example.com/v1/zendesk/oauth_callbackSubstitua YOUR_SUBDOMAIN pelo subdomínio real da sua conta do Zendesk.
Defina os campos Identificador exclusivo e Chave secreta, que são preenchidos automaticamente ao adicionar um novo cliente OAuth. É possível editar o Identificador único, mas não o Secret. O secret é mostrado por completo apenas uma vez ao adicionar um novo cliente. Mantenha essa informação em segurança. São os valores client_id e client_secret nas especificações do OAuth2.
Configurar as definições do aplicativo OAuth
Faça login no portal da CCAI Platform.
Acesse Configurações > Configurações do desenvolvedor.
Selecione a plataforma do agente Zendesk na seção CRM.
Defina Subdomínio do Zendesk como o subdomínio da sua conta do Zendesk.
Defina o ID do cliente OAuth como o Identificador exclusivo do seu cliente OAuth do Zendesk.
Defina a Chave secreta do cliente OAuth como a Chave secreta do seu cliente OAuth do Zendesk.
Clique em Salvar.
Gerar um token de API
A API Zendesk usa tokens para segurança. Para gerar um token de API no Zendesk, siga estas etapas:
No Zendesk, clique no ícone Admin na barra lateral.
Selecione Canais > API.
Clique na guia Configurações e verifique se o acesso por token está ativado.
Clique no ícone à direita de Tokens de API ativos.
Se quiser, insira uma descrição em Descrição do token da API.
O token é gerado e exibido para você:

Copie e cole o token em um lugar seguro. Depois que você fechar esta janela, o token completo nunca mais será exibido.
Clique em Salvar para voltar à página da API.
Uma versão truncada do token é exibida:

Configurar token de API
Para atribuir o token de API às configurações do CRM do Zendesk, siga estas etapas:
Faça login no portal da plataforma CCAI com uma conta de administrador.
Acesse Configurações > Configurações do desenvolvedor.
Defina o token da API como o token da API copiado do seu cliente Zendesk.
Criar campos de cliente e tíquete
Opcionalmente, os campos de cliente e tíquete podem ser criados. Siga estas etapas:
Crie uma conta do Zendesk com as funções de administrador e agente.
No Zendesk, acesse Configurações > Equipe de agentes e gerentes.
Selecione Adicionar um administrador.
Marque Este administrador também é um agente.
Ative a conta no e-mail de convite.
Saia da conta de administrador atual e faça login com a nova conta.
Faça login no Zendesk com uma função de administração, não de agente.
No Zendesk, faça login usando o widget com credenciais de um administrador com função de agente.
Clique em Autorizar.
Abra o portal da plataforma CCAI e acesse Configurações > Configurações do desenvolvedor.
Clique no botão Criar em CRM > seção Campos do cliente para contato e ticket.
Verifique se os campos personalizados de tíquete foram criados em Administrador > Gerenciar > Campos de usuário e administrador > Gerenciar > Campos de tíquete.
Eles precisam incluir os campos:
Campos do usuário:
Identificador
Campos de tíquete:
Verificação (caixa de seleção)
Feedback de texto do cliente (texto multilinha)
Classificação de satisfação do cliente (numérica): de 1 a 5
Avaliação compartilhada do cliente (texto): Twitter ou Facebook