> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/integrations/ecommerce/product-reviews/integrating-alhena-ai-with-yotpo.md).

# Yotpo

Connect Yotpo so Alhena can answer shopper questions with your real product reviews and customer Q\&A — pulled in automatically and kept fresh on every product crawl.

## Prerequisites

* A Yotpo account with Reviews enabled
* Your Yotpo **app key** (instructions below)

## Getting Your App Key

Alhena needs your Yotpo **app key** — the public key your storefront already uses to show reviews. There are two ways to find it.

### Option 1: From your Yotpo dashboard

1. Log in to your **Yotpo dashboard**
2. Go to **Settings → General Settings**
3. Copy your **App Key**

### Option 2: From your storefront

The app key is already embedded in your live storefront:

1. Open any product page on your store
2. View the page source (right-click → **View Page Source**) and search for `staticw2.yotpo.com`
3. Copy the app key that appears in the Yotpo widget script

{% hint style="info" %}
The Yotpo app key is a public, read-only key — it's already visible in your storefront and is only used to read reviews and Q\&A. It can't post, edit, or delete reviews, so it's safe to share with Alhena.
{% endhint %}

***

## Setup

### Step 1: Enable Yotpo in Alhena

1. In Alhena, go to **Settings > Integrations**
2. Find **Yotpo** and click **Enable**
3. You'll be taken to the Yotpo settings page

### Step 2: Connect Your Account

1. Paste your **Yotpo app key** into the field
2. Click **Connect**

Alhena verifies the app key with Yotpo before saving it. If the key is wrong or unrecognized, you'll see an error explaining what to fix. A valid key on a store that doesn't have any reviews yet still connects successfully.

***

## Enabled Agents and Capabilities

Connecting Yotpo adds product-review awareness to your **Product Expert Agent**.

| Capability                 | Description                                                                                                                                                |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Product Reviews & Q\&A** | The Product Expert Agent reads your Yotpo reviews and customer Q\&A for each product and uses them to answer shopper questions with real customer feedback |

This capability is **on by default** as soon as you connect — no extra toggles to flip. You can turn it off or configure the Product Expert Agent any time from the **Connected Agents** section of the Yotpo settings page, or under **AI Settings > Agents**.

{% hint style="info" %}
Reviews and Q\&A refresh automatically on every product crawl — there's no manual sync to run. Newly added reviews show up after the next training run.
{% endhint %}

***

## What your customers can ask

Once connected, your AI assistant can answer review-driven product questions like:

### About what reviewers think

* "What do customers say about this product?"
* "Is this comfortable for everyday wear?"
* "How do people rate the fit?"
* "Do reviewers think it runs true to size?"
* "Has anyone mentioned how it holds up after a year?"

### Ratings and concerns

* "What's the average rating for this product?"
* "Are there any complaints about durability?"
* "What do the negative reviews say?"

### Customer Q\&A

* "Did anyone ask about washing instructions?"
* "Is there a question about whether this is true to size?"

Alhena answers from your actual reviews and customer Q\&A — grounded in real feedback rather than generic claims.

{% hint style="info" %}
Alhena leads with helpful, representative feedback and only surfaces negative reviews when a shopper specifically asks about concerns or downsides.
{% endhint %}

***

## Yotpo and your store platform together

Yotpo works on top of whatever commerce platform you've connected — Shopify, BigCommerce, Magento, and others. Reviews are matched to your products automatically during the product crawl, so there's nothing to map by hand.

***

## Disconnecting

To disconnect Yotpo:

1. Go to **Settings > Integrations > Yotpo**
2. Click **Disconnect**
3. Confirm the disconnection

This stops reviews and Q\&A from refreshing on future product crawls. Reviews already stored stay in place until your next training run. Your reviews in Yotpo are unaffected.

***

## Troubleshooting

### "App key looks malformed"

* Make sure you pasted the full app key with no leading or trailing spaces
* The app key is a single alphanumeric string — no spaces, slashes, or quotes

### "Yotpo rejected this app key" or "Yotpo doesn't recognize this app key"

* Double-check you copied the **App Key** from **Settings → General Settings** (or the Yotpo widget script in your storefront)
* Confirm the key is still active in your Yotpo account

### "Couldn't reach Yotpo" or "validation timed out"

* A temporary network hiccup between Alhena and Yotpo — wait a moment and click **Connect** again

### Connected successfully, but the AI isn't citing any reviews

* Reviews populate during the product crawl. Run (or wait for) a **training run**, then ask again
* Confirm the products you're asking about actually have reviews in Yotpo
* If you just connected, give the next crawl time to finish before expecting reviews in answers

### Reviews stopped updating

* Check that Yotpo still shows as **Connected** under **Settings > Integrations**
* If the app key changed in Yotpo, reconnect with the new key