This guide will help you integrate Gorgias for chat with your Reactiv Mobile App. Gorgias is an all-in-one customer support platform that turns your helpdesk into a profit center with seamless eCommerce integration
Prerequisites
Before setting up the Gorgias integration, ensure the following:
You have an active Gorgias account with access to the API Token & Chat Widget Key
Your Reactiv Mobile App is already set up and functioning.
Step 1: Access the Integrations Page
Log in to your Shopify admin dashboard.
In the left-hand menu, locate Reactiv - Mobile App Builder under the "Sales channels" section.
Click on Reactiv - Mobile App Builder to open the Reactiv dashboard.
Select Integrations from the sidebar.
Step 2: Locate Gorgias
On the Integrations page, use the search bar or scroll to find Gorgias under the "Chat" category.
Click the Connect button next to Gorgias to access the integration settings.
Step 3: Connect Gorgias to Your Mobile App
In the Gorgias integration popup, you will see a fields for the Email for the Admin Account User, Account Subdomain, API Token & Chat Widget Key
Obtain the necessary fields (steps in the below green callout box)
Paste the appropriate information within the fields in the Reactiv integration popup.
1. Account Subdomain:
The account subdomain is the first part of the URL you use to access Gorgias.
For example, if your Gorgias URL is
https://yourcompany.gorgias.com, then "yourcompany" is your subdomain.
2. API Token:
To generate or find your API Token:
Log in to your Gorgias dashboard.
Click on your profile picture (or the settings icon) in the bottom-left corner to open the Settings.
In the Settings menu, navigate to REST API under the Integrations section.
Click on API Token or Create API Token if it’s your first time creating one.
Once generated, copy the token to use it in your integrations.
3. Chat Widget Key:
To find your Chat Widget Key:
Log in to your Gorgias dashboard.
Go to Settings.
Under Channels, select Chat.
In the chat widget settings, you should see an option for installation or widget code.
The Chat Widget Key will be part of the JavaScript embed code used to add the chat widget to your site. It will look like a unique alphanumeric string.
Copy this key for your use.
If you can't find any of these details, Gorgias' support documentation or customer support can help you further.
Step 4: Save the Integration
After entering your information, click the Connect/Update button to save the integration.
Once saved, Gorgias will be connected to Reactiv.
Step 5: Add Chat Widget to Mobile
Navigate to Studio > Settings > Integrations
Scroll to the Chat Provider Section
From the Dropdown, select
GorgiasOnce the Chat provider is selected, you will have the ability to manage the Chat Widget Position
Once complete, click Save & Publish
Step 6: Verify the Integration
Return to the Studio and Preview your mobile app to confirm that the chat is displaying as expected.
If any issues arise, recheck the Gorgias settings make sure to Save the settings correctly.
Limitations
Gorgias Convert: The current integration supports chatbot only. Gorgias Convert Campaigns are not supported within the Reactiv Mobile App.
Customization: Chat options may be limited to the default settings provided by the Gorgias integration.
Troubleshooting
Invalid API Token & Chat Widget Key: Ensure that you have correctly copied the API Token & Chat Widget Key from your Gorgias account.
Chat Not Displaying: Confirm that the integration was successfully updated and check for any necessary configurations within the Gorgias dashboard.
For more detailed information on managing and customizing your reviews, please refer to your account manager at Gorgias.