Magento 2

Updated 2 weeks ago by Axelle Heems

Benefits of Magento 2

You can:

• Display customer profiles next to tickets
• Display orders, shipments and credit memos
• Insert Magento 2 variables in macros
• Use Magento 2 variables as filters in rules

How to connect Magento 2?

To connect your Magento 2 store to your Gorgias account, you first need to install the Gorgias plugin on your store.

To do so:

1. Buy the "Gorgias" plugin from the Magento Marketplace: https://marketplace.magento.com/gorgias-module-magento-connect.html (don't worry, it's free!)

Then, please ask your developer to:

1. Connect to your Magento store's server with SSH
2. Run those commands:

composer require gorgias/module-magento-connect

bin/magento se:up

bin/magento se:di:co

Once this is done, go to your Gorgias account:

1. Click on "Settings" > "Integrations" > "Magento 2"
2. Click on "Add Magento 2 store"

   

3. For "One-click installation" follow the next steps:

   

   1. Enter the URL of the Admin panel of your Magento 2 store, then click on "Add integration"

      

   2. You will be redirected to your Magento 2 store: there, click on "Create"

      

   3. You will then be redirected back to your Gorgias account

      

4. For "Manual installation" follow the next steps:
   This option is useful if you have a firewall configured on your Magento store that prevents you from adding the integration using the one-click installation process.
   1. Go to Magento admin dashboard
   2. Click on Settings > Integrations
   3. Click on Add New Integration and set variables as such:
      1. name: "Gorgias - Manual Integration"
      2. Enter your password at the bottom
      3. In the left panel, click on API, and then check those permissions:

         Sales > Operations > Orders > Actions > View

         Sales > Operations > Orders > Actions > Edit

         Sales > Operations > Orders > Actions > Cancel

         Sales > Operations > Orders > Actions > Credit Memos

         Sales > Operations > Shipments

         Sales > Operations > Credit Memos

         Customers (and then uncheck the All Customers, Now Online and Customer Groups nested permissions)

   4. Click on Save in the top-right corner
   5. When you're back on the list, on the "Gorgias - Manual Integration", click on Activate
   6. Click on Allow
   7. Copy all credentials
   8. Click on Done
   9. Go back to Gorgias interface and paste all credentials into the form together with the store url

      

   10. Click on Add Integration
5. 🎉 your Magento 2 store is now connected to your Gorgias account! From this point, we will do an initial import of all your customers into Gorgias. Any new order / customer will also be synchronized, and data about orders will be updated when there are new shipments or credit memos related to them.

Below is a screenshot of how customer & order info will appear:

Magento 2.4

Version 1.2 of our Magento plugin, with support for Magento 2.4, is now live.

If you are upgrading from an existing installation, you'll have to follow the instructions below. please ask your developer to run these instructions when doing the upgrade, in order to avoid lags on your Magento server:

- SSH into your Magento server

- Put your store in maintenance mode

- Connect into your database

- Run this query: `DELETE FROM gorgias_sync_log WHERE sync_flag = 1 OR sync_fail_count > 5;`

- If it takes too long, you can interrupt it and run `DELETE FROM gorgias_sync_log WHERE sync_flag = 1 OR sync_fail_count > 5 LIMIT 10000;` multiple times, until it doesn't delete anything anymore

That's it, you should be good to go! You can then resume upgrading the Gorgias plugin as usual.

Installing the Gorgias Chat Widget on your Magento store

You can use our chat widget on your Magento store as well. If you go to your Chat Integration Page > Your Chat Integration > Installation, you will notice a Javascript code there with instructions on where to place the code on your store's page (above the </body> tag).

If you're looking to customize your chat's appearance, please refer to the article about basic customization here and we also have some more advanced instructions here.

How did we do?

Related Articles

• Textline
• Mobile app fact sheet
• Installing the Self-service Portal