El primer paso para hacer que Magento se comunique con Zendesk es instalar y configurar la extensión de Zendesk para Magento. Esta extensión proporciona funcionalidad dentro de Magento y también ofrece una API para que la aplicación de Magento tenga acceso a la información de los clientes.
Requisitos
- Magento Community v1.7+ o Magento Enterprise v1.9+ con derechos administrativos plenos
- PHP 5.5+
- El servidor Magento debe usar HTTPS; no se admite HTTP
- Asegúrese de que el firewall esté configurado para permitir el acceso de Zendesk. Consulte Configuración del firewall para usar con Zendesk para ver los detalles.
- Asegúrese de que las llamadas a los extremos Extension API (zendesk/api/customers/ y zendesk/api/orders/) no tengan redireccionamientos aplicados por la red, la CDN o la configuración del servidor.
Instalar la extensión
Actualmente el marketplace de Magento no ofrece la extensión de Zendesk. Descargue la última versión de la extensión Magento (versión 2.4.0) del sitio de Github.
Cargar la extensión manualmente
- Descargue la extensión de Zendesk para Magento desde GitHub.
- A través de un acceso FTP o SSH, extraiga el contenido del directorio src y colóquelo en el directorio raíz de Magento.
- Borre la memoria caché de Magento:
- Inicie sesión en la página de administración de Magento.
- Vaya a System > Cache Management .
- Haga clic en Flush Magento Cache.
- Cierre sesión en la página de administración de Magento.
- Inicie sesión en la página de administración de Magento.
- Vaya a System > Configuration > Zendesk.
Configurar los permisos
Si ha configurado roles personalizados en la administración de Magento, debe seleccionar los permisos correctos para estos roles en la extensión.
- Vaya a la página Roles a través de System > Configuration > Permissions > Roles .
- Seleccione el rol para el cual desea establecer los permisos.
- Seleccione Role Resources en las pestañas de la izquierda.
- Elija los permisos que desea otorgar al rol.
- Zendesk Dashboard: da al rol acceso a todas las funciones de administración de la extensión
- Dashboard: da al rol acceso al panel de tickets
- Bulk Actions: da al rol acceso para realizar acciones masivas en el panel de tickets
- Create Ticket: da al rol acceso para crear tickets
- Launch Zendesk: si se desactiva esta función, se ocultará el menú Launch Zendesk para que no lo puedan ver de los usuarios del rol
- View Logs: da al rol acceso para ver los registros de la API
Vincular la tienda de Magento con Zendesk
Ahora que ya tiene instalada la extensión de Zendesk, tendrá que proporcionar algunas opciones de configuración para vincularla con Zendesk.
Opción 1: Usar la guía de configuración
Usar la guía de configuración es la forma más rápida de configurar todo. Simplemente haga clic en el botón Setup Guide de la sección Setup en la página de configuración de Zendesk de la extensión de Magento.
Realizar los pasos que se indican en la guía de configuración
Seleccionar las vistas para mostrar
Una vez que termine de configurar con la guía de configuración, se le devolverá a la página de configuración de Zendesk para Magento con todos los campos llenos. El último paso consiste en seleccionar las vistas que desea mostrar en los paneles de Zendesk.
- Vaya a la página de configuración de la cuenta de Zendesk seleccionando Sistema > Configuración > Zendesk.
- Elija las vistas que desea mostrar:
- Guarde la configuración.
Opción 2: Configurar manualmente la extensión
Si ya tiene una cuenta de Zendesk, siga las instrucciones a continuación para configurar manualmente la extensión de Magento.
Proporcionar detalles generales
La primera configuración que se debe completar es la de los detalles generales. Esto le permitirá a Magento comunicarse con Zendesk.
- Vaya a la página de configuración de la cuenta de Zendesk seleccionando Sistema > Configuración > Zendesk.
- Ingrese su dominio de Zendesk.
- Ingrese una dirección de correo electrónico de agente y un token.
El token es necesario porque es una forma más segura de autenticar en lugar de guardar la contraseña del agente en Magento. Para generar un token, simplemente inicie sesión en Zendesk y luego vaya a Administrar > Canales > API > Token. Copie el token y péguelo en el campo Token de agente. - Guarde la configuración.
Seleccionar las vistas para mostrar
Una vez guardadas las opciones de configuración general, tendrá que seleccionar las vistas que desea que se muestren en Magento.
- Vaya a la página de configuración de Zendesk: Sistema > Configuración > Zendesk.
- Elija las vistas que desea mostrar:
- Guarde la configuración.
Activar el inicio de sesión único (opcional)
Tanto agentes como usuarios finales pueden autenticarse con el inicio de sesión único (SSO). Recomendamos que configure el SSO para los usuarios finales y haga que los agentes inicien sesión de forma nativa o con Google.
- En su cuenta de Zendesk, vaya a Administrador > Configuración > Seguridad.
- Seleccione la pestaña Administradores y agentes o Usuarios finales.
*El SSO para Magento solo se puede usar para un tipo de usuario - Seleccione la opción Inicio de sesión único (SSO) y luego la opción Token Web JSON.
- Ingrese un URL de inicio de sesión remoto usando una de las siguientes convenciones, según el usuario para el cual desee activar el SSO:
Administradores y agentes: http://your_site_base_url/admin/zendesk/authenticate
Usuarios finales: http://your_site_base_url/zendesk/sso/login - Ingrese un URL de cierre de sesión remoto usando una de las siguientes convenciones, según el usuario para el cual desee activar el SSO:
Administradores y agentes: http://your_site_base_url/admin/zendesk/logout
Usuarios finales: http://your_site_base_url/zendesk/sso/logout - Active Actualizar ID externas.
- Copie el secreto compartido, cámbiese a la configuración de la extensión de Zendesk y péguelo en el campo Token de autenticación remota.
- Guarde la configuración.
(Observe que si no puede iniciar sesión correctamente cuando el SSO está activado, podrá iniciar sesión directamente con Zendesk usando https://SUSITIO.zendesk.com/acceso/normal)
Sincronizar los clientes de Magento con Zendesk
La extensión puede crear o actualizar perfiles de usuario en Zendesk con la información de la cuenta de cliente existente que pertenece a Magento. Los campos de usuario que existen en Magento se pueden crear en Zendesk para guardar información adicional.
Vincular pedidos con tickets de soporte
La extensión de Magento puede vincular un ticket de soporte con un pedido de Magento creando un campo de texto personalizado en Zendesk.
- Cree un campo de texto personalizado en su cuenta de Zendesk.
- Copie la ID del campo de texto personalizado en la configuración de la extensión de Magento.
En Zendesk, la ID del campo de texto personalizado se encuentra aquí:
En Magento:
Nota: Para poder mostrar los tickets de Zendesk Support en las vistas de los pedidos de Magento, tendrá que agregar y guardar el número de pedido correcto en esta ID de campo del número del pedido personalizado dentro del ticket de Zendesk correspondiente. - Guarde la configuración.
Activar otras funciones de la extensión
Hay algunas excelentes funciones de la extensión que se pueden activar fácilmente.
-
Redirigir a Zendesk las solicitudes de tipo “Contáctenos”
- Agregar un Web Widget a su sitio
-
Mostrar un vínculo de soporte al pie de página de la tienda de Magento
Nota: La página "Order View" (vista del pedido) mostrará los tickets de soporte del cliente (o los clientes) cuyo número de pedido coincida con la orden que se está viendo en esta página. Es posible que exista más de una dirección de correo electrónico asociada con el mismo número de pedido. Por esta razón los tickets de soporte que correspondan con más de una dirección de correo electrónico podrían mostrarse en la página "Order View". Los tickets de soporte específicos para una dirección de correo electrónico en particular se mostrarán en la página Customer View (vista del cliente).
¿Qué sigue?
En este punto, ya debería tener tickets que aparecen en Magento (Zendesk > Dashboard) y podrá crear tickets desde Magento (Zendesk > Create).
A continuación, tendrá que instalar Magento M1 Commerce - by agnoStack/Particular. del Marketplace de Zendesk. Después de la instalación, si tiene algún problema al usar la nueva aplicación, consulte Resolución de problemas con la configuración de Magento 1 Extension.