Oversai connects to your Gorgias helpdesk through the Gorgias REST API, so you can evaluate, coach, and report on your support conversations in Oversai. The setup takes about 3 minutes and needs three things from Gorgias: your subdomain, the email address of your Gorgias account, and an API key.
Before you start
A Gorgias account with the Owner or Admin role. Only these roles can see the API credentials and create API keys.
An Oversai account with Admin access.
For Gorgias's own guide to these credentials, see Access your Gorgias REST API credentials.
Step 1 — Find your Gorgias API credentials
In Gorgias, click the Settings icon in the bottom-left corner.
In the menu, under Account, select REST API.
Under API Access & Credentials you'll see three values: the Base API URL, your Username (the email address on your account) and the Password (API Key).
Your subdomain is the part of the Base API URL before .gorgias.com. For example, if the Base API URL is https://mycompany.gorgias.com/api/, your subdomain is mycompany.
Step 2 — Create an API key (if you don't have one)
If the Password (API Key) field shows a Create API Key button instead of a key, click it. The key is generated right away and shown next to the other credentials. Click Copy to copy it.
API keys are tied to an individual Gorgias account, not to the whole helpdesk. Use an account that will stay active: if that user is removed, or the key is reset, the connection to Oversai stops working.
Step 3 — Connect Gorgias in Oversai
In Oversai, go to Integrations and click New Integration.
In the Integrations Gallery, find Gorgias and click Connect.
Fill in the fields on the New Gorgias connection page:
Name: a name to recognize this connection in Oversai, for example "Gorgias – Support".
Subdomain: only your Gorgias subdomain, for example mycompany for mycompany.gorgias.com. Don't enter the full URL.
Email: the email address of the Gorgias account that owns the API key (the Username from step 1).
Token: the API key from step 1 or step 2.
Click Connect to Gorgias.
If something isn't working
The connection saves but no conversations arrive: check that the Subdomain is only the subdomain and not the full URL, that the Email is the owner of the API key, and that the key was copied completely.
Syncing was working and then stopped: the API key was probably reset, or the Gorgias user who owns it was removed. Create or copy a current key and update the Token in your Oversai integration. Resetting a key in Gorgias immediately invalidates the old one.
Need help?
If you run into any issues, contact [email protected] or your Oversai account manager. We're happy to help.