Pour que Magento communique avec Zendesk, vous devez commencer par installer et configurer l’extension Zendesk pour Magento. Cette extension fournit des fonctionnalités dans Magento, ainsi qu’une API pour que l’application Magento puisse accéder aux informations sur les clients.
Prérequis
- Magento Community v1.7+ ou Magento Enterprise v1.9+ avec droits d’administrateur complets
- PHP 5.5+
- Votre serveur Magento doit utiliser HTTPS - HTTP n’est pas pris en charge
- Vérifiez que votre pare-feu est configuré pour autoriser l’accès à Zendesk. Consultez Configuration de votre pare-feu pour utilisation avec Zendesk pour en savoir plus.
- Vérifiez que votre réseau, votre CDN ou votre configuration de serveur n’applique pas de redirections aux appels aux points de terminaison de l’API Extension (zendesk/api/customers/ et zendesk/api/orders/).
Installez l’extension
L’extension Zendesk n’est pas actuellement disponible sur la marketplace Magento. Téléchargez la dernière version de l’extension Magento (version 2.4.0) à partir de Github.
Chargez l’extension manuellement
- Téléchargez l’extension Zendesk pour Magento à partir de GitHub .
- En utilisant un accès FTP ou SSH, extrayez le contenu du répertoire src dans votre répertoire racine Magento.
- Effacez le cache Magento :
- Connectez-vous à l’administration Magento.
- Allez à System > Cache Management .
- Cliquez sur Flush Magento Cache .
- Déconnectez-vous de l’administration Magento.
- Connectez-vous à l’administration Magento.
- Allez à System > Configuration > Zendesk .
Configurez les permissions
Si vous avez des rôles personnalisés configurés dans l’administration Magento, vous devez sélectionner les permissions qu’ont ces rôles dans l’extension.
- Allez à la page Rôles en sélectionnant System > Configuration > Permissions > Roles .
- Sélectionnez le rôle pour lequel vous voulez configurer les permissions.
- Sélectionnez Role Resources dans les onglets sur la gauche.
- Choisissez les permissions que vous voulez accorder au rôle.
- Zendesk Dashboard - Le rôle a accès à toutes les fonctionnalités d’administration de l’extension.
- Dashboard - Le rôle a accès au tableau de bord des tickets.
- Bulk Actions - Le rôle peut effectuer des actions en masse dans le tableau de bord des tickets.
- Create Ticket - Le rôle peut créer des tickets.
- Launch Zendesk - Si vous désactivez cette option, le menu Launch Zendesk est masqué pour les utilisateurs avec ce rôle.
- View Logs - Le rôle peut consulter les journaux de l’API.
Liez votre magasin Magento à votre Zendesk
Maintenant que l’extension Zendesk est installée, vous devez remplir certains paramètres de configuration pour la lier à Zendesk.
Option 1 - Utilisation du guide de configuration
Le moyen le plus rapide de tout configurer est d’utiliser le guide de configuration. Cliquez sur le bouton Setup Guide dans la section Setup de la page des paramètres Zendesk de l’extension Magento.
Lisez le guide configuration
Sélectionnez les vues à afficher
Une fois que vous avez lu le guide de configuration, vous retournerez à la page de configuration de Zendesk pour Magento, sur laquelle tous les champs sont remplis. La dernière étape consiste à sélectionner les vues que vous voulez afficher dans vos tableaux de bord Zendesk.
- Allez à la page de configuration de Zendesk en sélectionnant System > Configuration > Zendesk .
- Sélectionnez les vues que vous souhaitez afficher :
- Enregistrez la configuration.
Option 2 - Configuration manuelle de l’extension
Si vous avez déjà un compte Zendesk, vous pouvez configurer l’extension Magento manuellement en suivant les instructions ci-dessous.
Fournissez des informations générales
La première étape de la configuration consiste à fournir les informations générales. Cela permettra à Magento de communiquer avec Zendesk.
- Allez à la page de configuration de Zendesk en sélectionnant System > Configuration > Zendesk .
- Saisissez votre domaine Zendesk.
- Saisissez l’adresse e-mail d’un agent et son token.
Un token est nécessaire, car c’est une méthode d’authentification plus sûre que le stockage du mot de passe de l’agent dans Magento. Pour générer un jeton, connectez-vous à Zendesk, puis sélectionnez Gérer > Canaux > API > Token. Copiez le token et collez-le dans le champ Token de l’agent. - Enregistrez la configuration.
Sélectionnez les vues à afficher
Une fois les options de configuration générales enregistrées, vous devez sélectionner les vues que vous voulez afficher dans Magento.
- Allez à la page de configuration de Zendesk : System > Configuration > Zendesk.
- Sélectionnez les vues que vous souhaitez afficher :
- Enregistrez la configuration.
Activez la connexion unique (facultatif)
Les agents ou les utilisateurs finaux peuvent s’authentifier avec la connexion unique. Nous vous conseillons de configurer la connexion unique pour les utilisateurs finaux et de demander aux agents de se connecter de façon native ou avec Google.
- Dans votre Zendesk, allez à Admin > Paramètres > Sécurité.
- Sélectionnez l’onglet Administrateurs et agents ou Utilisateurs finaux.
* La connexion unique pour Magento ne peut être utilisée que pour un seul type d’utilisateur. - Sélectionnez l’option Connexion unique, puis l’option Token Web JSON.
- Saisissez une URL de connexion à distance en utilisant l’une des conventions suivantes, selon le type d’utilisateur pour lequel vous voulez activer la connexion unique.
Administrateurs et agents : http://your_site_base_url/admin/zendesk/authenticate
Utilisateurs finaux : http://your_site_base_url/zendesk/sso/login - Saisissez une URL de déconnexion à distance en utilisant l’une des conventions suivantes, selon le type d’utilisateur pour lequel vous voulez activer la connexion unique.
Administrateurs et agents : http://your_site_base_url/admin/zendesk/logout
Utilisateurs finaux : http://your_site_base_url/zendesk/sso/logout - Activez Mise à jour des ID externes.
- Copiez le secret partagé, passez à la configuration de l’extension Zendesk et collez-le dans le champ Token d’authentification à distance.
- Enregistrez la configuration.
(Notez que si vous n’arrivez pas à vous connecter quand la connexion unique est activée, vous pouvez vous connecter directement avec Zendesk en utilisant https://YOURSITE.zendesk.com/access/normal)
Synchronisez les clients de Magento avec Zendesk
L’extension peut créer ou mettre à jour des profils d’utilisateur dans Zendesk en utilisant les informations des comptes d’utilisateur existants de Magento. Les champs d’utilisateur qui existent dans Magento peuvent être créés dans Zendesk pour stocker des informations supplémentaires.
Liez les commandes aux tickets d’assistance
L’extension Magento peut lier un ticket d’assistance à une commande Magento en créant un champ de texte personnalisé dans Zendesk.
- Créez un champ de texte personnalisé dans votre Zendesk.
- Copiez l’ID du champ de texte personnalisé dans la configuration de l’extension Magento.
Dans Zendesk, l’ID du champ de texte personnalisé se trouve ici :
Dans Magento :
Remarque – Pour afficher vos tickets d’assistance Zendesk Support dans vos vues des commandes Magento, vous devez ajouter et enregistrer le bon numéro de commande dans cet ID de champ du numéro de commande dans le ticket Zendesk correspondant. - Enregistrez la configuration.
Activez les autres fonctionnalités de l’extension
L’extension fournit d’autres fonctionnalités très utiles que vous pouvez facilement activer.
-
Redirection des demandes de contact à Zendesk
- Ajoutez un Web Widget à votre site
-
Affichez un lien d’assistance dans le pied de page de votre magasin Magento
Remarque – La page Order View affichera les tickets d’assistance du ou des clients dont le numéro de commande correspond à la commande affichée sur la page. Plusieurs adresses e-mail peuvent être associées à un même numéro de commande. Pour cette raison, les tickets d’assistance qui correspondent à plusieurs adresses e-mail peuvent s’afficher à la page Order View. Les tickets d’assistance spécifiques à une adresse e-mail spécifique s’afficheront à la page Customer View.
Et ensuite ?
Désormais, vos tickets devraient s’afficher dans Magento (Zendesk > Dashboard) et vous devriez pouvoir créer des tickets à partir de Magento (Zendesk > Create).
Vous allez ensuite devoir installer Magento M1 Commerce - by agnoStack/Particular à partir de Zendesk Marketplace. Après l’installation, si vous rencontrez des problèmes avec la nouvelle application, consultez au guide de dépannage de la configuration de l’extension Magento 1.