Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction: 

Set up Time: 15-30 Minutes

...

The Malomo<> Gorgias integration will allow a Merchant to retrieve all order data Malomo has access to which includes Shopify Order data, Customer Information, Shipping Destination, and the last shipping event Malomo has received from a Carrier. 

Step 1: Generate Your API Key

Generate a Secret Malomo API Key on Malomo’s Developer Page and name it ‘Gorgias’. Save this key for the end of step 2.

...

Step 2: Setup & Authenticate Malomo & Gorgias

  1. Go to ‘Settings’ -> in your Gorgias Account and select ‘HTTP’. Here, you will create an HTTP Integration that will look for the Malomo Endpoint associated with your account. 

  2. Name your Integration: Malomo 

  3. Select Triggers: 

    1. Ticket Created

    2. Ticket Updated

    3. Ticket Message Created. 

  4. The URL for your integration should be: https://api.gomalomo.com/orders?customer_email={{ticket.customer.email}}

  5. HTTP Method: Get

  6. Response content type: application/json

  7. Headers (use the API key created in step 1 for Authorization). 

    1. Accept: application/vnd.malomo+json; version=2

    2. Authorization: Bearer (insert API Key)

The format for the Authorization header should look something like this when input on the Gorgias end, only you will utilize the actual API key generated from the Malomo dashboard:

Bearer sk_

...

1234Adf1234SDf1234

Congrats! Your application is now authenticated. Data will begin to populate for new tickets that come in where Malomo already has data on the customer (after an order is placed). If in further steps, your data does not populate, please review this step again, or email help@gomalomo.com.

...

Step 3: Configure Your Widgets.

Within the Gorgias platform - you can configure what data from Malomo you want to show on your main sidebar within Gorgias. Malomo will allow you to show scan events, shipment history, and data Malomo has obtained from the Shopify Order. 

...