If you wish to connect a platform with Gorgias, but we don't have a direct integration with this app just yet, there are still ways to integrate!How it worksHTTP integrations allow you to connect any third-party app to Gorgias, that has an open API.

If you want to connect an app with Gorgias, but we don&apos;t have an integration with it, there are still ways to integrate - HTTP integrations allow you to connect any 3rd-party app that has an open API to Gorgias.There are two main uses for HTTP integrations:&#xA0;<ul><li style="font-family: Inter; font-size: 16px;">Fetch customer data from a third party to populate the user profile</li><li style="font-family: Inter; font-size: 16px;">Trigger an action in a third-party app when a ticket is created or updated</li></ul>Gorgias exposes a <a href="https://stackoverflow.com/questions/671118/what-exactly-is-restful-programming" target="_blank">RESTful API</a> to make it easy for you to get, create, update, and delete many objects including customers, tickets, messages, and events. Check out our <a href="https://developers.gorgias.com/" rel="noopener noreferrer" target="_blank">developer documentation</a> and&#xA0;<a href="https://developers.gorgias.com/reference/limitations" target="_blank">a detailed overview</a> of the limitations.Under&#xA0;Settings -&gt; You -&gt; REST API, you&apos;ll find a button to subscribe to the <a href="https://updates.gorgias.com/labels/developers" rel="noopener noreferrer" target="_blank">developer newsletter</a> - we highly encourage you to subscribe to it, as it contains updates about upcoming changes and breaking changes to the API, new features, and integrations.Most support teams use a custom back-office, or admin, to look up customer profiles and perform actions on them.&#xA0;With Gorgias, you can:<ul><li style="font-family: Inter; font-size: 16px;">Automatically fetch customer data when a ticket is created.</li><li style="font-family: Inter; font-size: 16px;">Display it next to tickets.</li><li style="font-family: Inter; font-size: 16px;">Use this data.</li><li style="font-family: Inter; font-size: 16px;">Fetch the data on Ticket&#xA0;Updated and New Message In Ticket events as well.</li></ul><hr><h2 id="steps"> Steps</h2><h3 id="before-you-start">Before you start</h3>To connect your back office, you&#x2019;ll need an endpoint from which Gorgias can fetch customer data given the address of a customer. For example:<pre>GET https://yourcompany.com/api/users?email={{ticket.customer.email}}</pre>Then, it would send some info about this email address to Gorgias:<pre>{
 &quot;order&quot;:{
 &quot;id&quot;:4759226956,
 &quot;name&quot;:&quot;#1002&quot;,
 &quot;note&quot;:&quot;&quot;,
 &quot;tags&quot;:&quot;&quot;,
 &quot;token&quot;:&quot;56710ab7e3ebc4d1e16078290a1536ac&quot;
 }
}</pre> <h3 id="plug-your-back-office-api-into-gorgias">Plug your back-office API into Gorgias</h3>Once you have an endpoint like that, follow these steps to fetch data on each ticket:1. In Gorgias, go to Settings -&gt; App Store -&gt;&#xA0;HTTP Integration.2. Click on Add HTTP Integration.3. Use the GET method and your back-office URL. It should look like this: https://company.com/api/users?email={{ticket.customer.email}}.Optionally, you can use a header to pass the API key. For instance: Authorization, Basic 5Nmy9Z1loPr0M45TVBVRqoKyccj1jI03aGAZEx2fkO44. Select a trigger.5. Click Add Integration.When a ticket is created or updated, Gorgias will automatically pull customer information from your back office and display it in the sidebar to the right of your tickets. <h3 id="display-the-information-in-the-sidebar">Display the information in the sidebar</h3>Now that you have this customer data available, you can display it next to your tickets:1. Go to a ticket (make sure your API can return info about the email address of the ticket customer, otherwise, there&apos;s nothing we can display).2. Add a Tag to the ticket, this will trigger a Ticket Updated event and fetch the customer data from your API.3. Click on the gear icon at the top right of the page to open widget settings.4. Drag and drop the yellow section into the sidebar, and build your own widgets.<figure><a href="http://help.gorgias.io/en/latest/_images/widgets.gif"><img src="https://hsfiles.gorgias.help/help-centers/2648/eQ5bRgGfSN/articles/QhHPPkCDoa/1514969107704/image.gif" data-hd-align="center" class="fr-fil fr-dib"></a></figure> <h3 id="use-the-sidebar-data-in-macros">Use the sidebar data in Macros</h3>You can use the content of the widgets in your Macros - for this, refer to the back-office variables, in the <a href="https://docs.gorgias.com/en-US/macro-variables-81845" rel="noopener noreferrer" target="_blank">Macro variables article</a>.<div class="note-callout">The expected delay in receiving events to HTTP Integrations is at about 10 seconds.</div><hr><h2 id="hookdeck"> Hookdeck</h2>If the endpoint you&apos;re using in your integration is unreliable or you want to have more control as to what gets delivered, we recommend using <a href="https://hookdeck.io?ref=gorgias" rel="noopener noreferrer" target="_blank">Hookdeck</a> - it offers a complete infrastructure to reliably deploy integrations that make handling and managing incoming webhooks you receive from Gorgias simple.&#xA0;They offer built-in scaling, failure recovery, monitoring, and alerting without provisioning your own infrastructure or deploying new code. You can avoid having to build your own infrastructure to successfully act on every webhook we send.&#xA0;It&apos;s generally recommended to implement logic to queue and asynchronously process webhooks, and Hookdeck is the fastest and easiest way to accomplish this.<div class="hd--embed" data-provider="Custom"><div style="position: relative; padding-bottom: 62.5%; height: 0;"><iframe src="https://www.loom.com/embed/f42b187d8f0e4a698d46c2f03fbd507c" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div></div><hr><h2 id="troubleshooting"> Troubleshooting</h2><h4 id="why-did-my-http-integration-get-disabled">Why did my HTTP integration get disabled?</h4>If you received an email saying that your HTTP integration was disabled, it can happen for several reasons - for example, the service that&apos;s used in the HTTP integration is experiencing downtime, there are latency issues, and the HTTP requests time-out.In the video below you can see how you can track the details of the issue:<div class="hd--embed" data-provider="YouTube" style="text-align: center;"><iframe style="width: 500px; height: 281px;" src="//www.youtube.com/embed/DIzU5q4tM_I" frameborder="0" allowfullscreen></iframe></div> <h4 id="i-fixed-the-problem-but-it-keeps-getting-disabled">I fixed the problem, but it keeps getting disabled.</h4>If your HTTP endpoint has intermittent issues we still try to send up to 100 HTTP requests to it. We generally keep retrying individual requests if there are timeouts, for example.However, if 100 requests fail in a row then we disable the integration to prevent abuse of our systems (and external services).&#xA0;If a couple of requests succeed, we reset the failure count back to zero.To illustrate this:<ul><li style="font-size: 16px;">100 requests fail in a row -&gt; integration gets disabled.</li><li style="font-size: 16px;">90 requests fail, then several requests succeed -&gt; the failure count gets reset to zero.</li></ul>This way some intermittent failures won&apos;t lead to the deactivation of your HTTP integration.

HTTP Integrations

Segment's software and APIs collect, clean, and control your customers' data.How it worksYou can send data about your tickets in Segment by adding Gorgias as a Source on your Segment account. By doing so, you can understand if customers who contacted

<div class="note-callout">Note: this integration is available to any Gorgias; however help with set ip or fixing any issues will only be supported for customers on the Advanced plan or higher, due to the manual work required on our end.</div><a href="https://segment.com/" target="_blank"> Segment&apos;s</a>&#xA0;software and APIs collect, clean, and control your customers&apos; data - you can send data about your tickets in Segment by adding Gorgias as a Source on your Segment account.&#xA0;By doing so, you can understand if customers who contacted support in the last year are generating more revenue.<hr><h2 id="steps"> Steps</h2><h3 id="add-gorgias-as-a-source-to-segment">Add Gorgias as a Source to Segment</h3>1. In your Segment account, click on Sources.2. Click Add Source.3. In the Server section, click HTTP API.4. Click Connect.5. Type in Gorgias as a nickname and SQL schema name, then click Create source.6. Open your newly created&#xA0;Gorgias&#xA0;source.7. Locate Write Key under Installation and copy it.8. Go to <a href="http://decodebase64.com/">http://decodebase64.com/</a> and paste the Write Key value under ASCII Plain Text.9. After pasting the value, make sure you add a colon character (:) &#xA0;at the end of the string.10. Copy the resulting text that shows up in the Base64 section.<a href="http://help.gorgias.io/en/latest/_images/segment.png"><img src="https://hsfiles.gorgias.help/help-centers/2648/eQ5bRgGfSN/articles/QhHPPkCDoa/1514969118594/image.png" data-hd-align="center" class="fr-fic fr-dib"></a><h3 id="notify-segment-when-a-ticket-is-created">Notify Segment when a ticket is created</h3>1. Go to Settings -&gt; App Store -&gt; HTTP integration.2. Click Add HTTP Integration.3. Use the following configuration, and click Add Integration.Integration name: Send info to Segment on Ticket Created Description: Segment Trigger: Ticket created URL: https://api.segment.io/v1/track HTTP Method: POST Headers: Key: Authorization, Value: Basic Paste Base64 code from Setup Instructions (step 10) here Request Body (JSON): &#xA0; &#xA0;{ &#xA0; &#xA0; &#xA0; &#xA0; &quot;timestamp&quot;: &quot;{{ticket.created_datetime}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &quot;properties&quot;: { &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &quot;subject&quot;: &quot;{{ticket.subject}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &quot;ticket_id&quot;: &quot;{{ticket.id}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &quot;status&quot;: &quot;{{ticket.status}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &quot;assignee&quot;: &quot;{{ticket.assignee_user}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &quot;channel&quot;: &quot;{{ticket.channel}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &quot;name&quot;: &quot;{{ticket.customer.name}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &#xA0; &quot;tags&quot;: &quot;{{ticket.tags}}&quot; &#xA0; &#xA0; &#xA0; &#xA0; }, &#xA0; &#xA0; &#xA0; &#xA0; &quot;userId&quot;: &quot;{{ticket.customer.email}}&quot;, &#xA0; &#xA0; &#xA0; &#xA0; &quot;event&quot;: &quot;Ticket created&quot; &#xA0; &#xA0;}Every time a ticket is created, data about the ticket will be sent to Segment, so you can use it in other apps.

Segment

Customer Fields by Helium allows Shopify merchants to obtain, store, and display unique data about customers.How it worksWhen you view a ticket in Gorgias, the relevant customer data will be conveniently displayed in the right sidebar. You can even d

<div class="note-callout">This integration was built by our partners and the wait time in case of any technical issues might be a bit longer than for a regular support request.</div> <a href="http://customerfields.com" target="_blank">Customer Fields</a>&#xA0;by Helium allows Shopify merchants to obtain, store, and display unique data about customers.When you view a ticket in Gorgias, the relevant customer data will be conveniently displayed in the right sidebar - you can even display different data for different types of customers.Quick access to relevant information allows your team to focus on providing a more helpful, personalized customer experience.<hr><h2 id="steps"> Steps </h2>This integration requires you to have a Customer Fields account.1. In Customer Fields, go to Customers -&gt; Import to import your customers (including any custom fields).2. Collect customer data via a registration form.<figure><img src="https://hsfiles.gorgias.help/help-centers/2648/eQ5bRgGfSN/articles/gxncpqja1j/1598297037307/screen-shot-2020-08-24-at-12-23-33-pm.png" data-hd-align="center" class="fr-dib" style="width: 395px;"></figure>3. Go to Settings -&gt; Customer note editor to <a href="http://help.heliumdev.com/en/articles/3649580-customer-note-editor" rel="noopener noreferrer" target="_blank">customize the data</a> you&#x2019;d like to see in Gorgias.<figure><img src="https://hsfiles.gorgias.help/help-centers/2648/eQ5bRgGfSN/articles/gxncpqja1j/1598297071590/screen-shot-2020-06-12-at-12-28-10-pm.png" data-hd-align="center" class="fr-fil fr-dib"></figure>Now the new customer data is visible in Gorgias:<img src="https://attachments.gorgias.help/k5/hc/mz0e/010c0210-b42c-40df-abce-3c26334ad23e-124a9b16-69bf-42c1-b8f6-3a417b6e8126.png" style="width: 692px;" class="fr-fic fr-dib">

Customer Fields by Helium

Please feel free to reach out to our Support Team via email anytime!

What's new

Webinars

Academy

Community

Main website

Gorgias

Integrations (Apps)

Set up a trial account

Migrate from non-Zendesk providers

Help Desk Migration

Zendesk migration 101

Import data from Zendesk

Enable/disable channels

Migrate from Zendesk

Helpdesk migration

Get started

Gorgias Academy

Agent knowledge checklist

About us

Customer data & privacy

GDPR requests

Policy

About Gorgias

Support

Fireside Chats

REST API

Build a custom app

Developer resources

Resources

AI Agent explained

Navigate AI Agent from setup to going live

How Gorgias' AI Agent works

Security and privacy FAQ for Gorgias AI Agent

Getting started with AI Agent

Set up and go live with AI Agent

Onboard AI Agent with knowledge sources

Create Guidance to give AI Agent custom instructions

Set up and use AI Agent on Chat

Customize how AI Agent hands over Chats to live agents

Best practices for writing Guidance

How AI Agent uses Vision to understand images

Best practices: prepare Shopping Assistant for sales conversations

Coach AI Agent and give feedback to improve its responses

Onboard and set up AI Agent

How AI Agent recommends products and offers discounts

Customize your Shopping Assistant selling and discount strategy

Turn on customer engagement features for AI Agent

Control which products AI Agent recommends to shoppers

Upgrade your AI Agent subscription to use Shopping Assistant skills

Shopping Assistant skills

Explore AI Agent performance by ticket topic

Test how AI Agent responds to customer questions

Review automation performance in the AI Agent Overview report

Review performance analytics for Support Agent

Review performance analytics for Shopping Assistant

Review automation performance by feature

Measure and improve AI Agent

Create an Action to connect AI Agent to other apps

Create Actions: use advanced options to build custom Actions for AI Agent

View event logs for AI Agent Actions

AI Agent Actions: make changes to Shopify orders

AI Agent Action: Send Loop Returns portal deep link

AI Agent Action: Send return shipping status from Loop Returns

AI Agent Actions: manage Recharge subscriptions

Support Actions: Connect AI Agent to ShipStation

Support Actions: Connect AI Agent to ShipBob

Support Actions: Connect AI Agent to ShipHero

AI Agent Actions: Shipmonk

AI Agent Actions: manage Skio subscriptions

AI Agent Actions: Loop Subscriptions

Connect AI Agent with other apps

Customize how AI Agent behaves

Let AI Agent autofill tags and ticket fields

AI Agent settings

How to test automation features without creating billable tickets

Compatibility of automation features with ecommerce store providers

Flows 101

Flow builder

Create a Flow

Flow steps (triggers, options, ends)

Analyze your Flows drop-off performance

Creating Flow variables using JSONPath

HTTP request step in Flows

Add email to Klaviyo via Flows

Show LoyaltyLion points balance via Flows

Manage Recharge subscription via Flows

Templates for one-step Flows

Flows

Order Management 101

Configure Track Order option

Configure Cancel Order option

Order statuses and possible shopper actions

Return Flow

Report order issue

Order Management

Article Recommendations in Chat (Retired)

Train your Article Recommendations (Retired)

Article Recommendations (Retired)

Sunsetting Quick Responses (July 2024)

Quick Responses 101 (Retired Feature)

Create a Quick Response (Retired Feature)

Statistics for Quick Responses (Retired Feature)

Quick Responses (Retired)

Automation features (Flows & Order Management)

AI Agent & automation features

Gorgias Bot

Search

Add two-factor authentication (2FA) to your Gorgias account

Sign in to Gorgias

Join your team on Gorgias

Create a ticket

Handle incoming tickets

Assign tickets manually

Other ticket management features

Snooze tickets

Merge tickets

Assign priority to tickets in Gorgias

Manage automatic ticket assignment in Gorgias

Take action on tickets in bulk

Export tickets from Gorgias

Internal Notes

Keyboard shortcuts

Tickets auto-merge

Review customer history in Gorgias

Translate tickets in Gorgias (Beta)

Handle Gorgias Voice tickets

Forward calls into or out of Gorgias

Listen in on active Gorgias Voice calls

Match Customer by Shopify Default Address Phone Number

Voice FAQ

Voice Troubleshooting

Tickets

Customer Sentiments

Customer Intents

Intents & Sentiments

Notifications 101

Enable browser notifications in Chrome

Enable browser notifications in Safari

Enable browser notifications in Microsoft Edge

Disable browser notifications

Notifications

Daily operations

Introducing: Multiple store management in Gorgias

Set Business Hours for Gorgias Support Channels

Gorgias mobile app

Languages Gorgias can detect

Accessing Incognito Mode

SLA Policies

SLA Best Practices

Set up custom SSO for Gorgias

Manage Gorgias account access

Add a phone number to Gorgias

Manage phone numbers in Gorgias

Available phone numbers on Gorgias

Gorgias Voice and SMS coverage regions

Manage multiple stores in Gorgias

Send and receive email from Gorgias with the Gmail integration

Send and receive email from Gorgias with the Outlook integration (Microsoft 365)