Configurer l'intégration avec Magento (par API)

Pour pouvoir importer dans Dialog Insight des données provenant de votre site transactionnel Magento, vous devez au préalable autoriser la communication entre les deux sites. Chaque application de commerce électronique présente une procédure d'autorisation spécifique qu'il importe de respecter pour une connexion adéquate.

Pré-requis	Activation du module E-Commerce.
Chemin d'accès	> Configuration > Données relationnelles > page E-Commerce

Comment faire

1. Dans la section Intégration, en regard de l'application Magento, cliquez sur le bouton Activer, si la connexion à Magento n'est pas encore activée, ou sur le bouton Modifier pour modifier ou ajouter une autorisation.
2. Si une ou plusieurs autorisations existent :
   1. Choisissez la connexion que vous souhaitez activer.
      *Une seule autorisation Magento peut être activée à la fois. Ainsi, si vous en avez plusieurs, vous devrez désactiver/activer vos autorisations selon vos besoins.
   2. Cliquez sur Sauvegarder.
3. Si aucune autorisation n'existe :
   1. Vous devrez au préalable en créer une.
   2. Pour ce faire, cliquez sur Créer une autorisation.
   3. Assurez-vous de choisir la version utilisée par votre site transactionnel.
      Les versions de Magento possibles sont :
      • Version 2 REST
      • Version 1 REST
      • Version 1 SOAP
      • Selon la version de Magento que vous utilisez, les types et versions d’API seront différents. L’API de type REST est utilisable seulement avec Magento 1.7 ou supérieur. L’API de type SOAP est utilisable uniquement avec les versions 1.x de Magento. IMPORTANT - L’API de type REST n’est pas la même pour les versions Magento 1.x et Magento 2.x. Il est recommandé d’utiliser l’API de type REST quand cela est possible.
   4. Cliquez sur Continuer.
   5. Dans la page d'autorisation Magento, précisez les informations demandées. Il faut savoir que les données à fournir ainsi que la procédure sont différentes selon la version de Magento choisie. De plus, pour pouvoir fournir les informations demandées par Dialog Insight, vous devez au préalable avoir créer un compte Magento et avoir défini au moins un utilisateur.

Magento Version 2 REST

Ce format est compatible avec Magento 2.x.

1. Commencez par créer ou récupérer vos clés Magento :
   1. Une fois connecté à votre compte Magento, accédez à la section administrative (Admin Panel).
   2. Allez dans System > Integrations.
   3. Appuyez sur Add New Integration, et remplissez les champs Name et Email.
      
      
   4. Dans l'onglet API, attribuez à votre utilisateur au moins toutes les permissions de lecture sur les « customers » et « orders »

      

   5. Faites Save & Activate.
   6. Cliquez ensuite sur Allow.
   7. Dans la page qui suit, prenez en note la valeur des champs Key, Secret Key, Token et Secret token.
      
      

2. Retournez dans l'application Dialog Insight pour y saisir vos clés Magento.
   
   
   

   1. Une fois toutes les informations saisies, cliquez sur Tester la connexion.
   2. La page d'accès au module d'administration de Magento s'ouvrira de nouveau.
      1. Entrez-y votre nom d'utilisateur et votre mot de passe.
      2. Dans la fenêtre suivante, confirmez l'accès à l'utilisateur affiché.
   3. De retour dans Dialog Insight, vous verrez que l'autorisation est réussie.
   4. Cliquez sur Continuer.
   5. Une page affichant la confirmation de la configuration s'affiche.
   6. Cliquez sur Terminer.

Magento Version 1 REST

Ce format est compatible avec Magento 1.7 ou supérieur.

1. Commencez par créer ou récupérer votre clé principale et votre clé secrète Magento :
   1. Une fois connecté à votre compte Magento, accédez à la section administrative (Admin Panel).
   2. Dans la menu System, sélectionnez Web Services et REST - OAuth Consumers.
   3. Dans cette page, sélectionnez votre nom de consommateur ou créez-en un si vous n'en avez pas. Pour voir vos clés, sélectionnez votre nom de consommateur pour ouvrir la page Consumer Information. Vous y trouverez votre clé (Key) et votre clé secrète (Secret).
2. Retournez dans l'application Dialog Insight pour y saisir vos deux clés Magento.
   
   1. Une fois toutes les informations saisies, cliquez sur Autoriser l'accès.
   2. La page d'accès au module d'administration de Magento s'ouvrira de nouveau.
      1. Entrez-y votre nom d'utilisateur et votre mot de passe.
      2. Dans la fenêtre suivante, confirmez l'accès à l'utilisateur affiché.
   3. De retour dans Dialog Insight, vous verrez que l'autorisation est réussie.
   4. Cliquez sur Continuer.
   5. Une page affichant la confirmation de la configuration s'affiche.
   6. Cliquez sur Terminer.

Magento Version 1 SOAP

1. Dans la page d'autorisation Magento, fournissez les informations demandées. Ces données proviennent de votre compte Magento.
   
   
2. Une fois l'adresse, le nom d'utilisateur et la clé API de Magento saisis, validez la connexion en cliquant sur Tester la connexion.
   Si les informations sont correctes, l'autorisation sera acceptée.
3. Cliquez sur Continuer.
4. Une page affichant la confirmation de la configuration s'affiche.
5. Cliquez sur Terminer.