Narvar Returns & ExchangesUpdated 2 months ago

Narvar is a cloud-based post-purchase customer experience platform that enables businesses to track orders, streamline returns and exchanges, and communicate with customers through messaging.

Please keep in mind that, for non-Shopify merchants, this integration is limited to Track Page only, the rest of the features will not be available.

How it works

Narvar Return & Exchanges for Shopify can be integrated with Gorgias to provide customer returns data. Information like shipping status, return reasons, and links to your dashboard can be displayed within the customer's sidebar under support tickets!

We are pulling up to 10 most recent returns per customer from your Narvar dashboard 🙂

Setup instructions

1. Open Gorgias and navigate to Settings → Integrations and select HTTP Integrations.

   
   

2. Click 'Add HTTP Integration'.

   
   

3. Complete the fields as shown below:
   • Integration Name: “Narvar”
   • Description: “Narvar Integration”
   • Triggers: Check the box next to each trigger.
   • URL: Enter the following URL exactly as it appears https://szero.narvar.com/api/returns?email={{ticket.customer.email}}&created_max=2032-01-01&limit=10
   • HTTP Method: “GET”
   • Response content type: “application/json”

API Key Setup

This part of the setup requires a Narvar API key. If you have not received a key you’ll need to contact Narvar support.

1. From a new tab in your web browser, open the Narvar Returns & Exchanges app and click Settings. Select the Advanced tile, then click RMA Post Credentials.
2. In the Additional API Credentials section, click ADD API KEY. In the Username field, type “Gorgias”, then click the save icon (to the right of the password field) to generate the Basic Authorization header.

3. Copy the Authorization Header then click Ok.
   *Note: New passwords are only visible once, so make sure you copy to a safe location.

4. Navigate back to Gorgias and click Add header.

5. In the Key field, type “AUTHORIZATION”. In the Value field, paste the Basic Authorization header that you generated in the Narvar API Credentials settings.

6. Click Add header and type "X-NARVAR-SHOP-DOMAIN" in the Key section and paste your store URL in the Value field, then click Save changes.

Activation

Before data can flow between the Narvar Return & Exchange app and Gorgias, you’ll need to activate the integration. This can be done by creating a new ticket in Gorgias for a customer with an existing return or exchange.

1. Navigate to Shopify and copy the email address of a customer that has an existing return or exchange.
2. Return to the Gorgias Helpdesk and click the three dots next to Settings in the upper-left corner of the screen, then click Customers.

   
   

3. Paste the email address of the customer in the Search customers box, then select the customer profile.

   
   

4. Leave an internal note in the ticket that says “Narvar Integration”, then click Send. This will activate the integration.

   
   

5. Refresh the page, then click the gear icon (i.e Widget) in the upper-right corner of the screen. 

   
   

6. Hover your cursor over the middle part of the screen and scroll down to the HTTP Data section and you’ll see the Narvar section directly below. Drag the Narvar section to the widget column on the right to activate the Narvar widget.

   
   

Customize the Narvar widget

Once the integration is active you can customize the Narvar widget to display, hide, and edit how specific returns data and links appear in Gorgias admin and tickets. Below are some examples of how you can customize fields in the widget.

Customize Fields

Move a Field

• Rearrange the order of fields by dragging a field up or down in the column.

Edit a Field

• Select the field that you want to edit and change the Title and/or Type, then click Submit.

Delete a Field

• Hover over a field and click the red X.

Link to the Narvar Return & Exchange Dashboard

Create a link to your Narvar Return Portal from the Gorgias Helpdesk.

1. In the widget column, click the gear icon in the upper-right corner of the screen, then click Add Redirection Link.

   
   

2. Complete the fields as shown below. You can view all relevant JSON fields and related documentation here.
   • Title: “Narvar Return & Exchange Dashboard”
   • Link: Enter the link to your Narvar Returns & Exchange Dashboard