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

# Stamped

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

## Prerequisites

* A Stamped account that collects product reviews
* Your Stamped **Public API Key** and **Store ID** (instructions below)

## Getting Your Public API Key and Store ID

Alhena needs two values from Stamped: your **Public API Key** and your **Store ID**. Both are the public identifiers your storefront's Stamped review widget already uses.

1. Log in to your **Stamped dashboard**
2. Go to **Settings > Review Integrations > API Keys**
3. Copy the **Client ID**. This is your **Public API Key**
4. Copy the **Store Hash**. This is your **Store ID**

{% hint style="warning" %}
Don't paste your **Secret Key**. Alhena only needs the Client ID and Store Hash.
{% endhint %}

{% hint style="info" %}
The Public API Key and Store ID are already embedded in your storefront's Stamped widget, and Alhena only uses them to read reviews. They can't post, edit, or delete reviews, so they're safe to share with Alhena.
{% endhint %}

***

## Setup

### Step 1: Enable Stamped in Alhena

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

### Step 2: Connect Your Account

1. Paste your Client ID into **Stamped Public API Key**
2. Paste your Store Hash into **Stamped Store ID**
3. Click **Connect**

Alhena checks the key and Store ID with Stamped before saving them. If the pair is wrong or unrecognized, you'll see an error explaining what to fix.

***

## Enabled Agents and Capabilities

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

| Capability          | Description                                                                                                                                        |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Product Reviews** | The Product Expert Agent reads your Stamped 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 Stamped 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 published Stamped **product reviews**, including whether each one came from a verified buyer. Questions and answers from Stamped 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 %}

***

## Stamped and your store platform together

Stamped works on top of the store platform you've connected to Alhena. Stamped files each review under your store platform's product ID, and Alhena uses that same ID to match reviews to your products during the product crawl, so there's nothing to map by hand.

***

## Disconnecting

To disconnect Stamped:

1. Go to **Settings > Integrations > Stamped**
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 Stamped are unaffected.

***

## Troubleshooting

### "Stamped didn't recognize this Public API Key and Store ID pair"

* Make sure you pasted both values in full, with no leading or trailing spaces
* Check that you copied the **Client ID** into the Public API Key field and the **Store Hash** into the Store ID field, not the other way round
* Make sure you didn't paste the **Secret Key**

### "Couldn't reach Stamped" or "validation request to Stamped timed out"

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

### Some products show reviews in Stamped but not in Alhena

* Alhena matches reviews using your store platform's product ID. Reviews attached to a different ID in Stamped (for example, a product that was deleted and re-created in your store) won't match the current product

### Reviews stopped updating

* Check that Stamped still shows as **Connected** under **Settings > Integrations**