> 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-reviewsio.md).

# REVIEWS.io

Connect REVIEWS.io so Alhena can answer shopper questions with your real product reviews, pulled in automatically and kept fresh on every product crawl.

## Prerequisites

* A REVIEWS.io account that collects product reviews
* Your REVIEWS.io **Store ID** (instructions below)

## Getting Your Store ID

Alhena needs your REVIEWS.io **Store ID**, the public identifier your storefront already uses to display your reviews. It's a short name such as `my-store`. There are two ways to find it.

### Option 1: From the REVIEWS.io dashboard

1. Log in to your **REVIEWS.io dashboard**
2. Go to **Integrations** and select **API**
3. Copy the **Store ID** from the **API Credentials** section

The Store ID also appears on your store platform's integration page in REVIEWS.io (for example **Integrations > Shopify**). You only need the Store ID. Alhena doesn't need your API key.

### Option 2: From your public review page

Your Store ID is the last part of your public REVIEWS.io review page link:

1. Open your public review page, which looks like `reviews.io/company-reviews/store/your-store-id`
2. Copy the part after `/store/`

{% hint style="info" %}
The Store ID is a public, read-only identifier. It's already visible on your storefront and your public review page, and Alhena only uses it to read reviews. It can't post, edit, or delete reviews, so it's safe to share with Alhena.
{% endhint %}

***

## Setup

### Step 1: Enable REVIEWS.io in Alhena

1. In Alhena, go to **Settings > Integrations**
2. Open the **Reviews & ratings** section, find the **REVIEWS.io** card and turn on its toggle
3. You'll be taken to the REVIEWS.io settings page. Nothing is connected until you click **Connect** in the next step

### Step 2: Connect Your Account

1. Paste your **REVIEWS.io Store ID** into the field
2. Click **Connect**

Alhena checks the Store ID with REVIEWS.io before saving it. If the ID is wrong or unrecognized, you'll see an error explaining what to fix.

***

## Enabled Agents and Capabilities

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

| Capability          | Description                                                                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Product Reviews** | The Product Expert Agent reads your REVIEWS.io product reviews 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, with 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 REVIEWS.io settings page, or under **AI Settings > Agents**.

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

{% hint style="info" %}
Alhena reads your REVIEWS.io **product reviews**. Questions and answers from REVIEWS.io aren't included.
{% 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 dress?"
* "Does this run true to size?"
* "How do people rate the quality?"
* "Is the color as shown in the photos?"
* "Has anyone mentioned how it washes?"

### Ratings and concerns

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

Alhena answers from your actual reviews, 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 %}

***

## REVIEWS.io and your store platform together

REVIEWS.io works on top of the store platform you've connected to Alhena. Reviews are matched to your products automatically during the product crawl, so there's nothing to map by hand. Alhena looks up each product the same ways the REVIEWS.io widget does: by product ID, product URL name, and the SKUs and IDs of its variants.

***

## Disconnecting

To disconnect REVIEWS.io:

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

This stops reviews from refreshing on future product crawls. Reviews already stored stay in place until your next training run. Your reviews in REVIEWS.io are unaffected.

***

## Troubleshooting

### "REVIEWS.io didn't recognize this Store ID"

* Make sure you pasted the full Store ID with no leading or trailing spaces
* Double-check you copied the **Store ID** from **Integrations > API**, not your API key or company name
* If you copied it from your public review page, make sure you took only the part after `/store/`

### "Couldn't reach REVIEWS.io" or "validation request timed out"

* A temporary network hiccup between Alhena and REVIEWS.io. 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 product reviews in REVIEWS.io
* If you just connected, give the next crawl time to finish before expecting reviews in answers

### Some products show reviews in REVIEWS.io but not in Alhena

* In REVIEWS.io, reviews are attached to a product identifier (the "SKU" in REVIEWS.io). Alhena finds a product's reviews when that identifier is the product's ID, its URL name, or one of its variant SKUs or IDs in your store
* If you attach reviews to a custom code that isn't any of these, Alhena can't match them to the product

### Reviews stopped updating

* Check that REVIEWS.io still shows as **Connected** under **Settings > Integrations**