Intégration Magento : installation de l’extension Zendesk pour Magento

Pour établir la communication entre Magento et Zendesk, il faut commencer par installer et configurer l’extension Zendesk pour Magento. Cette extension fournit les fonctionnalités au sein de Magento, ainsi qu’une API pour que l’application Magento puisse accéder aux informations client.

Prérequis

• Magento Community v1.7+ ou Magento Enterprise v1.9+ avec droits d’administrateur complets
• PHP 5.5+

Installez l’extension

L’extension Zendesk n’est pas disponible dans Magento Marketplace à l’heure actuelle. Téléchargez la dernière version de Magento depuis GitHub.

Chargez manuellement l’extension.

1. Téléchargez l’extension Zendesk pour Magento depuis GitHub.
2. En utilisant l’accès FTP ou SSH, extrayez le contenu du répertoire src dans votre répertoire racine Magento.
3. Videz la mémoire cache de Magento.
1. Connectez-vous à l’administration de Magento.
2. Allez à System > Cache Management.
3. Cliquez sur Flush Magento Cache.
4. Déconnectez-vous de l’administration de Magento.
5. Connectez-vous à l’administration de Magento.
6. Allez à System > Configuration > Zendesk.

Configurez les permissions

Si vous avez des rôles personnalisés configurés dans votre administration Magento, vous devez sélectionner les permissions appropriées pour ces rôles dans l’extension.

1. Allez à la page des rôles (System > Configuration > Permissions > Roles.
2. Sélectionnez le rôle pour lequel vous voulez configurer les permissions.
3. Sélectionnez Role Resources dans les onglets sur la gauche.
4. Choisissez les permissions pour le rôle.
   • Zendesk Dashboard - Donne au rôle l’accès à toutes les fonctionnalités d’administration de l’extension.
   • Dashboard - Donne au rôle l’accès au tableau de bord des tickets.
   • Bulk Actions - Permet au rôle d’effectuer des actions en masse dans le tableau de bord des tickets.
   • Create Ticket - Permet au rôle de créer des tickets.
   • Launch Zendesk - Si vous désactivez cette option, les utilisateurs avec ce rôle ne voient pas le menu de lancement de Zendesk.
   • View Logs - Permet au rôle de consulter les journaux d’API.

Connectez votre magasin Magento à votre Zendesk

Une fois l’extension Zendesk installée, vous devez remplir certains paramètres de configuration pour la connecter à Zendesk.

Option 1 - Utilisez le guide de configuration

L’utilisation du guide de configuration est la façon la plus rapide de tout configurer. Il vous suffit de cliquer sur le bouton Setup Guide de la section Setup à la page des paramètres Zendesk de l’extension Magento.

Suivez le guide de configuration

Sélectionnez les vues à afficher

Une fois que vous avez fini le guide de configuration, vous retournez à la page de configuration Zendesk pour Magento où tous les champs sont remplis. La dernière étape consiste à sélectionner les vues que vous voulez afficher dans vos tableaux de bord Zendesk.

1. Allez à la page de configuration Zendesk en sélectionnant System > Configuration > Zendesk.
2. Sélectionnez les vues que vous souhaitez afficher :
   
3. Enregistrez la configuration.

Option 2 - Configurez l’extension manuellement

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 est de fournir les informations générales. Cela permettra à Magento de communiquer avec Zendesk.

1. Allez à la page de configuration Zendesk en sélectionnant System > Configuration > Zendesk.
2. Saisissez votre domaine Zendesk.
3. Saisissez l’adresse e-mail d’un agent et le token.
   
   Un token est nécessaire, car c’est une méthode d’authentification plus sécurisée que le stockage du mot de passe de l’agent dans Magento. Pour générer un token, connectez-vous à Zendesk, puis sélectionnez Gérer > Canaux > API > Token. Copiez le token et collez-le dans le champ Agent Token.
4. 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.

1. Allez à la page de configuration de Zendesk : System > Configuration > Zendesk.
2. Sélectionnez les vues que vous souhaitez afficher :
   
3. 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 la connexion native ou avec Google pour les agents.

1. Dans Zendesk, allez à Admin > Paramètres > Sécurité.
2. Sélectionnez l’onglet Administrateurs et agents ou Utilisateurs finaux.
   * Vous ne pouvez utiliser la connexion unique pour Magento que pour un seul type d’utilisateur.
3. Sélectionnez l’option Connexion unique, puis cochez la case Token Web JSON.
4. Saisissez une URL de connexion à distance en utilisant l’une des conventions suivantes, en fonction des utilisateurs pour lesquels 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
5. Saisissez une URL de déconnexion à distance en utilisant l’une des conventions suivantes, en fonction des utilisateurs pour lesquels 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
6. Activez la mise à jour des ID externes.
7. Copiez le secret partagé, passez à la configuration de l’extension Zendesk et collez-le dans le champ Remote Authentication Token.
   
   
8. Enregistrez la configuration.
   
   (Remarque - Si vous n’arrivez pas à vous connecter quand la connexion unique est activée, vous pouvez vous connecter directement avec Zendesk en utilisanthttps://YOURSITE.zendesk.com/access/normal )

Synchronisez les clients de Magento avec Zendesk

L’extension peut créer ou mettre à jour les profils d’utilisateur dans Zendesk en utilisant les informations client existantes dans Magento. Les champs utilisateur qui existent dans Magento peuvent être créés dans Zendesk pour stocker des informations supplémentaires.

Connectez les commandes aux tickets d’assistance

L’extension Magento peut connecter un ticket d’assistance à une commande Magento en créant un champ texte personnalisé dans Zendesk.

1. Créez un champ texte personnalisé dans Zendesk.
   
   
2. Copiez l’ID du champ texte personnalisé dans la configuration de l’extension Magento.
   
   Dans Zendesk, l’ID du champ texte personnalisé se trouve ici :
   
   Dans Magento :
   
   Remarque - Pour afficher les tickets d’assistance Zendesk Support dans vos vues de commandes Magento, vous devez ajouter et enregistrer le numéro de commande correct dans ce champ d’ID de champ de numéro de commande au sein du ticket Zendesk correspondant.
3. Enregistrez la configuration.

Activez les autres fonctionnalités de l’extension

Vous pouvez activer diverses fonctionnalités de l’extension très utiles.

• Rediriger les e-mails Contactez-nous à Zendesk
  
• Ajouter un Web Widget à votre site 
• Afficher un lien d’assistance dans le pied de page de votre magasin Magento
  

Remarque - La page de vue de commande affichera les tickets d’assistance du ou des clients pour lesquels le numéro de commande correspond à la commande affichée sur cette page. Il est possible que plusieurs adresses e-mail soient associées au même numéro de commande. Pour cette raison, les tickets d’assistance qui correspondent à plusieurs adresses e-mail peuvent s’afficher à la page de vue de commande. Les tickets d’assistance spécifiques à une adresse e-mail particulière s’affichent dans la page de vue du client.

Et ensuite ?

Maintenant, les tickets devraient s’afficher dans Magento (Zendesk > Dashboard) et vous devriez pouvoir créer des tickets à partir de Magento (Zendesk > Create).

L’étape suivante est la configuration de l’application Magento pour Zendesk.