--- title: "Gorgias - Integration Guide for Reviews and Loyalty & Referrals" slug: "gorgias-integration-guide-for-reviews-and-loyalty-referrals" tags: ["Reviews ", "Loyalty and Referrals", "Shopify", "Shopify Plus", "Adobe Commerce (Magento)", "BigCommerce"] updated: 2026-08-20T12:04:34Z published: 2026-08-20T12:04:34Z canonical: "support.yotpo.com/gorgias-integration-guide-for-reviews-and-loyalty-referrals" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.yotpo.com/llms.txt > Use this file to discover all available pages before exploring further. # Gorgias - Integration Guide for Reviews and Loyalty & Referrals Products Reviews Loyalty ###### Supported plans Premium, Enterprise ###### eCommerce Platform Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce ###### Supported plans Change this text for SMS & Email ###### eCommerce Platform Change this text for SMS & Email ###### Supported plans Premium, Enterprise ###### eCommerce Platform Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce ###### Supported plans Change this text for Visual UGC ###### eCommerce Platform Change this text for Visual UGC ###### Supported plans Change this text for Subscriptions ###### eCommerce Platform Change this text for Subscriptions ## Goals and Outcomes The Gorgias integration for Yotpo Reviews and Yotpo Loyalty & Referrals enables your support teams to view customer insights and manage reviews directly from Gorgias. By working within a familiar helpdesk environment, agents can respond to shoppers faster and deliver a more personalized experience. With this integration, your team can: - **View customer data using the Yotpo Customer Widget**, displayed in the **Customer** sidebar. It displays data for loyalty points, VIP tier, past reviews, sentiment, top topics, and more. - **Moderate reviews and Q&A**, including product and site reviews, directly from new Gorgias tickets created by [Yotpo’s escalation tools](https://support.yotpo.com/v1/docs/help-desk-integration-configuration-guide-for-reviews#auto-escalation). > [!WARNING] > Note > > You don’t need to use both Yotpo Reviews and Yotpo Loyalty & Referrals to enable the integration. The Yotpo Customer Widget will omit data for any Yotpo product you’re not using. If you add another Yotpo product later, data will begin syncing automatically with no reinstallation required. ## About Gorgias [Gorgias](https://gorgias.grsm.io/yotpo-preferred-tier) is a customer support helpdesk built for eCommerce merchants that connects you with your customers across their favorite channels, and lets you automate up to 30% of your ticket volume. ## Integrating Yotpo with Gorgias Follow these steps to add Yotpo data to the customer sidebar in Gorgias: 1. In your **Gorgias account**, go to **Settings** > **App store** > **Yotpo**. 2. Click **Add Yotpo account** to install the integration. 3. You will be **redirected to Yotpo**. If you’re not logged in, you’ll be prompted to log in to complete the installation. 4. Click **Connect** to allow Gorgias to access Yotpo data. 5. After authorization, you’ll be redirected back to Gorgias and should see a confirmation screen. ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/3aab9fe6-a44e-46c7-a5ec-21dbf9095521.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) If the confirmation screen does not appear, repeat steps 1 through 4. > [!WARNING] > Note > > Gorgias assigns a long default name to your Yotpo integration. You can customize it by editing the **Integration name** field and clicking **Update integrations**. ## How Yotpo Loyalty Data Syncs to Gorgias Loyalty profile data does not appear in the Gorgias widget immediately when a customer profile is created. Instead, data syncs based on message activity: ### When loyalty data appears - When a customer profile is first added to Gorgias (e.g., via Shopify sync), it will show no loyalty data. - Loyalty data begins syncing only after a new message event occurs. This includes: - A customer sends an email/ticket. - An agent replies to a customer. - An agent creates an internal note assigned to that customer. ### How the sync works - When a message event occurs, loyalty data is synced within five minutes. - Data will not sync again until another message event occurs. ### Example If an agent replies to a customer email, loyalty data will update after five minutes. If the agent revisits the ticket a day later without any new message activity, the loyalty data shown will only be accurate as of the last message event. > [!TIP] > Tip > > For the most up-to-date loyalty details, agents can reference the [Customers section inside the Yotpo admin](https://support.yotpo.com/docs/loyalty-and-referrals-customers-section). ### Yotpo Customer Widget Overview The widget is displayed in the sidebar, along with the customer details that appear next to the ticket. **Overview data** - **VIP tier name**: The customer’s current VIP tier - **Average rating**: Average star rating across all reviews submitted - **Number of reviews**: Total reviews submitted ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/c7bca9d1-551d-4fd4-80cc-2bac07b180a8.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) **Loyalty points** ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/70eb9431-3cd6-43f4-8593-83c0ce793c6a.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) - **Loyalty points**: Current point balance - **Total points earned**: Lifetime points earned - **Total redemptions**: Lifetime points redeemed - **Successful referrals**: Number of completed referrals - **Referrals made & clicked**: Number of referrals sent and clicked - **Referred by another customer**: Indicates whether the customer was referred by someone else **Reviews** ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/d7cb0ece-eff1-42b3-9fee-29bb58e2a953.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) - **Average rating**: Overall average rating - **Average site rating**: Average rating for site reviews - **Average product rating**: Average rating for product reviews - **Average sentiment**: Overall review sentiment (positive / neutral / negative) - **Average site sentiment**: Sentiment for all site reviews - **Average product sentiment**: Sentiment for all product reviews - **Top topics**: Most frequently mentioned and highest-sentiment topics, identified by Yotpo AI **Five latest reviews** ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/ff2e7fde-cd6c-4999-9469-9ae4b1c07140.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) For each review, the widget displays: - **Date created**: The date that this review was created - **Rating**: The star rating given by this customer in this review - **Published status**: An indicator of whether this review has been published or left unpublished - **Title and text**: The title and text of this review - **Rating upvotes and downvotes**: The number of upvotes and downvotes by other customers for these reviews - Product details, including: - **Name**: This product's name - **Product page:** The URL of this product's page - **Category**: The product category - **Reviews**: The total number of reviews made for this product - **Product rating**: The average star rating for this product from all customers ### Customizing the Widget with Action Buttons In addition to viewing customer details, you can also customize the Yotpo Customer Widget by adding action buttons. These buttons give your team more flexibility when managing customers, such as adjusting loyalty points or updating a customer’s birthday. You can create buttons for the loyalty actions supported by [Yotpo’s API](https://core-api.yotpo.com/reference/welcome). Buttons can be placed at the top of the widget or within the **Loyalty & Referrals** section. **To add a button:** 1. In Gorgias, open any ticket and **click the cog icon** in the top-right corner to enter the widget edit mode. 2. Scroll down to the Yotpo widget and click **Add Button**. 3. In the modal, **configure the HTTP action**: 1. Select the HTTP method. 2. Add the relevant endpoint. 3. Set headers, parameters, and body content as needed. 4. Click **Save** to apply your changes. Once created, custom action buttons will appear in the widget, in the ticket sidebar. When clicked, they will trigger the configured HTTP request. Depending on your setup, some fields can be edited before execution. ![An example button in the Yotpo widget](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/gorgias-example-button-in-widget.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) [Learn more about adding buttons in Gorgias widgets](https://docs.gorgias.com/en-US/custom-http-widgets-81940). #### Example 1: Creating a button to adjust a customer’s points To add a button that allows agents to manually adjust a customer’s loyalty points directly from Gorgias, follow these steps: 1. Open the widget editor and click **Add Button**. 2. In the modal, enter a **title for the button**, e.g., **Adjust Points**. 3. Set the **HTTP method** to **POST**, and enter this webhook URL: [https://loyalty.yotpo.com/api/v2/points/adjust](https://loyalty.yotpo.com/api/v2/points/adjust) 4. In the **Headers** section, [**add your API key and GUID**](https://support.yotpo.com/docs/yotpo-api). You can find both in the Yotpo Loyalty admin under **Settings > General Settings > Integrations**. ![Example of the headers setup for the button](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/gorgias-button-headers-setup.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) 1. For the API key: **Key**: x-api-key **Value**: Your API key 2. For the GUID: **Key**: x-guid **Value**: Your GUID 5. Under **Query Parameters**, select the second option for **Body**: **application/x-www-form-urlencoded**. 6. Add the following body parameters: ![Example of the query parameters setup](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/query-parameters-example.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) 1. **Key**: visible_to_customer **Value**: True 2. **Key**: customer_email **Value**: {{ticket.customer.email}} 3. **Key**: point_adjustment_amount **Value**: (Set as an editable field) 4. *(Optional)* To customize the reason for the adjustment: **Key**: history_title **Value**: (Set as an editable field) 7. Click **Save** to apply your changes. 8. (Optional) **Test the button** by adjusting points for a test customer. ![Testing the adjust points button](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/adjust-button-testing.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) Once configured, the **Adjust Points** button will appear in the Yotpo widget, allowing agents to update loyalty points directly from the ticket sidebar. --- #### Example 2: Creating a button to opt customers into your loyalty program > [!NOTE] > This applies to stores [using Shopify’s new Customer Accounts](https://support.yotpo.com/docs/using-yotpo-loyalty-referrals-with-shopifys-new-customer-accounts) and opt-in eligibility set to **Only members who signed up**. 1. Open the widget editor and click **Add Button**. 2. In the modal, enter a **title for the button**, e.g., **Enroll in Loyalty Rewards**. 3. Set the **HTTP method** to **POST**, and enter this webhook URL: [https://loyalty.yotpo.com/api/v2/customers](https://loyalty.yotpo.com/api/v2/customers) 4. In the **Headers** section, [**add your API key and GUID**](https://support.yotpo.com/docs/yotpo-api). ![The button setup in Gorgias](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/gorgias-enroll-in-loyalty-setup.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) 1. For the API key: **Key**: x-api-key **Value**: Your API key 2. For the GUID: **Key**: x-guid **Value**: Your GUID 5. Under **Query Parameters**, select the first option for **Body**: **application/json**. 6. Add the following body parameter: ```json { "email": "{{ticket.customer.email}}", "opted_in": true } ``` ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/json-example-button-gorgias.png?sv=2026-02-06&spr=https&st=2026-11-12T15%3A20%3A49Z&se=2026-11-12T16%3A20%3A49Z&sr=c&sp=r&sig=2pHl03y%2FRGSk3RjaNJCmt3psisiHt7Kqisar1daKzn4%3D) > [!WARNING] > Note > > If you want customers enrolled through this button to also receive their [New Member Reward](https://support.yotpo.com/docs/setting-up-a-new-member-reward-earning-rule-on-shopify), add `"has_account": true` to the body (for **Customer Accounts** + **Only Members Who Signed Up** opt-in). Without this parameter, the customer is opted in but won't get the reward. > > ```json > { >  "email": "{{ticket.customer.email}}", >  "opted_in": true, >  "has_account": true > } > ``` 7. Click **Save** to apply your changes. All set! The new button will be available in the Yotpo widget for agents to enroll customers in your loyalty program directly from Gorgias. ## Using Gorgias to Respond to Yotpo Reviews and Q&A Using [Yotpo’s moderation interface or automatic escalation rules](https://support.yotpo.com/v1/docs/help-desk-integration-configuration-guide-for-reviews), reviews and questions can be escalated into Gorgias as support tickets. Agents can then respond directly within Gorgias, just like any other support ticket. Need help? If you’re experiencing issues with the integration, contact Gorgias support at **support@gorgias.com**.