Magento 2

Updated 3 weeks ago by Axelle Heems

Magento is an ecommerce platform built on open source technology which provides online merchants with a flexible shopping cart system, as well as control over the look, content and functionality of their online store.

The Gorgias plugin for Magento is currently compatible with Magento 2.2, 2.3 and 2.4 for all Magento versions: Open Source (CE), Commerce using on prem (EE), Commerce on Cloud (ECE).

This feature is now available on Pro and higher plans.

Integration benefits

  • 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

Setup instructions

To connect your Magento 2 store to your Gorgias account, you first need to install the Gorgias plugin on your store. Please follow these steps in order to do so:

  1. Get the Gorgias plugin from the Magento Marketplace (don't worry, it's free!)
  2. Connect to your Magento store's server with SSH with your developers' assistance
  3. Run these 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

  1. Click on "Add Magento 2 store"

  1. 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
  2. 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
  3. 🎉 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:

Please note that Magento 2 customers' phone data can't be imported at the moment and for that reason, you won't find the customers' phone number in Gorgias.

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.

What do you think? Yay or Nay?