> For the complete documentation index, see [llms.txt](https://doc.aissist.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.aissist.io/tutorial/deploy/gorgias.md).

# Gorgias

Deploy Aissist in Gorgias - sign in, choose the teams it manages, set the actor, escalation and handover rules.

*Last updated: November 1, 2026*

Deploy Aissist in Gorgias so it answers tickets for the teams you choose, tags them, and hands over to your team. Read [Deploy](/tutorial/deploy.md) first for the steps every gateway shares.

### Prepare Gorgias

* Pick or create the user Aissist will answer as. A dedicated user works best.
* Route the tickets Aissist should handle to one team, with a rule or by hand.

### Connect Gorgias

1. Go to **Deploy → Gateways**, click **Add Gateway** and choose **Gorgias**.
2. On **Connect**, choose a Gorgias connector, or create one: enter your **Gorgias subdomain** (the `acme` in `acme.gorgias.com`) and click **Save and sign in with Gorgias**.
3. Approve Aissist in Gorgias with an admin account.

The connector keeps the sign-in fresh.

### Set up the agent

* **Managing Points (Teams)**: the teams Aissist manages. By default, it manages all.
* **Stop at the following tag(s)**: tags that make Aissist skip a ticket. Use it rarely.
* **Actor**: the user that sends Aissist's replies (required).
* **Escalation**: the team that gets a ticket when Aissist escalates. If empty, Aissist only unassigns itself.
* **Handover Rules**: map sub-agents to teams, so each workflow hands over to the right team.
* **Chat Settings**: the thinking message and handover message.

On the **Advanced** tab:

* **Auto-configure in Gorgias** lists what Aissist creates in Gorgias for you (a message integration and a status integration). If one is missing, the agent does not work: click the refresh button to create it.
* **Include Shopify information from Gorgias?** passes the customer's Shopify data from Gorgias to Aissist. It is recommended for e-commerce.

No additional steps are needed in Gorgias.

### How Aissist works in Gorgias

Aissist replies on the ticket and applies tags, which your Gorgias rules can act on. When a human should take over, Aissist summarizes the ticket and moves it to the escalation team or the team of the matching handover rule.

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FlGc5F0cy3tk0TuUIbvcF%2FLWScreenShot%202026-06-01%20at%2011.03.42%E2%80%AFPM.png?alt=media&amp;token=8a321b76-9dd0-4c3f-aaae-818b23010020" alt=""><figcaption></figcaption></figure>

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FpCRJgfZCj4wRqMNWNZop%2FLWScreenShot%202026-06-01%20at%2011.56.54%E2%80%AFPM.png?alt=media&amp;token=b7f227b2-dc82-4a54-9825-45b16ff53441" alt=""><figcaption></figcaption></figure>

### In-note commands

Your agents can add an internal note with an [in-note command](/capabilities/in-note-command.md) to analyze a ticket, fill fields or evaluate a reply. If you have deployed more than one gateway on this Gorgias account, turn on **Enable Co-Pilot** on the gateway's **Settings** for the one that should answer the commands.

<figure><img src="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FuANaf0lWFSalq7f8ijqU%2FScreenshot%202026-06-05%20at%203.32.42%E2%80%AFPM.png?alt=media&amp;token=a03da80a-4ce6-43c7-9dcb-461c63875e89" alt=""><figcaption></figcaption></figure>

### Do it with Ask Engine

> Which teams does our Gorgias gateway manage, and where does it escalate?

Ask Engine answers from the gateway's settings, including whether its connection is still valid.

### Best practice

* Start with one team and a dedicated user as the actor.
* Keep **Include Shopify information from Gorgias?** on for e-commerce, so Aissist sees the customer's orders.
* Check the **Advanced** tab after setup: every auto-configured item should be ticked.

### Related

* [Deploy](/tutorial/deploy.md)
* [Escalation and Handover](/capabilities/escalation-and-handover.md)