A primeira etapa do processo de comunicação do Magento com o Zendesk é instalar e configurar a extensão do Zendesk para o Magento. Esta extensão fornece funcionalidade dentro do Magento e também uma API para que o aplicativo Magento acesse as informações do cliente.
Pré-requisitos
- Magento Community v1.7+ ou Magento Enterprise v1.9+ com direitos completos de administrador
- PHP 5.5+
- Seu servidor Magento usar o HTTPS, pois o HTTP é incompatível
- O firewall estar configurado para permitir acesso do Zendesk. Para obter detalhes, ,consulte Configuração do firewall para uso com o Zendesk.
- Garantir que as chamadas para os pontos de extremidade da Extension API (zendesk/api/customers/ e zendesk/api/orders/) não tenham redirecionamentos aplicados por sua rede, CDN ou configuração do servidor
Instale a extensão
No momento, a extensão do Zendesk está indisponível no Marketplace da Magento. Acesse o Github para baixar a versão mais recente da extensão do Magento (versão 2.4.0).
Carregue a extensão manualmente
- Baixe a extensão do Zendesk para o Magento no GitHub.
- Acesse o FTP ou SSH e nele extraia o conteúdo do diretório src para o seu diretório raiz do Magento.
- Limpe o cache do Magento:
- Entre na administração do Magento.
- Navegue até System > Cache Management .
- Clique em Flush Magento Cache .
- Saia da administração do Magento.
- Entre na administração do Magento.
- Navegue até System > Configuration > Zendesk .
Configure as permissões
Se você tem funções personalizadas configuradas na administração do Magento, precisa selecionar as permissões corretas que essas funções têm na extensão.
- Navegue até a página Roles em System > Configuration > Permissions > Roles .
- Selecione a função para a qual você deseja definir as permissões.
- Selecione os recursos da função nas abas à esquerda.
- Escolha quais permissões deseja conceder à função.
- Zendesk Dashboard – concede à função o acesso a todos os recursos da administração da extensão
- Dashboard – concede à função o acesso ao painel do ticket
- Bulk Actions – concede à função o acesso para executar ações em massa no painel do ticket
- Create Ticket – concede à função o acesso para criar tickets
- Launch Zendesk – se essa função for desativada, o menu Iniciar o Zendesk ficará oculto para os usuários da função
- View Logs – concede à função o acesso para visualizar os registros da API
Vincule a sua loja do Magento ao Zendesk
Agora que a extensão do Zendesk está instalada, você precisa preencher algumas definições de configuração para vinculá-la ao Zendesk.
Opção 1 – uso do guia de configuração
Uso do guia de configuração é a maneira mais rápida de executar as definições necessárias. Basta clicar no botão Guia de configuração na seção Configuração na página de configurações do Zendesk na extensão do Magento.
Passe pelo guia de configuração
Selecione as visualizações que deseja exibir
Depois de passar pelo guia de configuração, você voltará à página de configuração do Zendesk para o Magento com todos os campos preenchidos. A etapa final é selecionar as visualizações que deseja exibir nos painéis do Zendesk.
- Navegue até a página de configuração do Zendesk ao selecionar System > Configuration > Zendesk .
- Escolha as visualizações que deseja exibir:
- Salve a configuração.
Opção 2 – configuração manual da extensão
Se você já possui uma conta do Zendesk, pode configurar manualmente a extensão do Magento seguindo as instruções a seguir.
Forneça os detalhes gerais
A primeira configuração a executar são os detalhes gerais. Isso possibilita a comunicação do Magento com o Zendesk.
- Navegue até a página de configuração do Zendesk ao selecionar System > Configuration > Zendesk .
- Insira o domínio do seu Zendesk .
- Digite um endereço de e-mail do agente e um token .
O token se faz necessário porque é uma maneira mais segura de autenticação em vez de armazenar a senha do agente no Magento. Para gerar um token, basta entrar no Zendesk e navegar até Gerenciar > Canais > API > Token . Copie o token e cole-o no campo do token do agente. - Salve a configuração.
Selecione as visualizações que deseja exibir
Depois que as opções gerais de configuração forem salvas, você precisa selecionar as visualizações que deseja exibir no Magento.
- Navegue até a página de configuração do Zendesk: System > Configuration > Zendesk .
- Escolha as visualizações que deseja exibir:
- Salve a configuração.
Ative o single sign-on (opcional)
Agentes ou usuários finais podem se autenticar com o single sign-on (SSO). Recomendamos que você configure o SSO para usuários finais e faça com que os agentes entrem nativamente ou com o Google.
- No Zendesk, navegue até Admin. > Configurações > Segurança .
- Selecione a aba Administradores e agentes ou Usuários finais .
* O SSO para o Magento pode ser apenas usado para um tipo do usuário - Selecione a opção Single Sign-on (SSO) e, em seguida, a opção Token da web JSON .
- Insira uma URL de acesso remoto usando uma das seguintes convenções, dependendo dos usuários para os quais você deseja ativar o SSO:
Administradores e agentes : http://your_site_base_url/admin/zendesk/authenticate
Usuários finais : http://your_site_base_url/zendesk/sso/login - Insira uma URL de saída remota usando uma das seguintes convenções, dependendo dos usuários para os quais você deseja ativar o SSO:
Administradores e agentes: http://your_site_base_url/admin/zendesk/logout
Usuários finais: http://your_site_base_url/zendesk/sso/logout - Ative a opção Atualizar IDs externas? .
- Copie o segredo compartilhado, mude para a configuração da extensão do Zendesk e cole-o no campo Token de autenticação remota.
- Salve a configuração.
(Caso você não consiga fazer o acesso com o SSO ativado, poderá entrar diretamente com o Zendesk usando https://SEUSITE.zendesk.com/access/normal )
Sincronize os clientes do Magento com o Zendesk
A extensão pode criar ou atualizar perfis de usuários no Zendesk com informações de contas de clientes existentes do Magento. Os campos de usuário que existem no Magento podem ser criados no Zendesk para armazenar informações adicionais.
Vincule pedidos a tickets de suporte
A extensão do Magento pode vincular o ticket de suporte ao pedido do Magento criando um campo de texto personalizado no Zendesk.
- Crie um campo de texto personalizado em seu Zendesk.
- Copie a ID do campo de texto personalizado na configuração da extensão do Magento.
No Zendesk, a ID do campo de texto personalizado fica aqui:
No Magento:
Observação: para exibir os tickets do Zendesk Support nas visualizações Número do pedido do Magento, você precisa adicionar e salvar o número do pedido correto nesta Order Number Field ID no ticket correspondente do Zendesk. - Salve a configuração.
Ative outros recursos da extensão
Existem ótimos recursos da extensão que você pode ativar facilmente.
-
Redirecionar para o Zendesk as solicitações do Entre em contato conosco
- Adicionar um Web Widget ao seu site
-
Exibir um link para o suporte no rodapé da loja do Magento
Observação: a página "Order View" exibe os tickets de suporte de clientes cujo número do pedido corresponde ao pedido sendo visualizado na página. Pode haver mais de um endereço de e-mail associado ao mesmo número de pedido. Por esse motivo, os tickets de suporte que correspondem a mais de um endereço de e-mail podem aparecer na página "Order View". Os tickets de suporte específicos para um determinado endereço de e-mail serão exibidos na página Customer View.
E agora?
Os tickets devem estar exibidos no Magento (Zendesk > Dashboard) e você já deve saber criar tickets no Magento (Zendesk > Create).
Em seguida, você precisará instalar o Magento M1 Commerce - por agnoStack/Particular no Marketplace da Zendesk. Se após a instalação você estiver com algum problema ao usar o novo aplicativo, consulte a solução de problemas da configuração da extensão do Magento 1.