> 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-powerreviews.md). # PowerReviews Connect PowerReviews 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 PowerReviews account with Ratings & Reviews enabled * Your PowerReviews **Merchant ID** and **API key** (instructions below) ## Getting Your Credentials Alhena needs two values — your **Merchant ID** and your **API key** (the read-only display key your storefront already uses to show reviews). There are two ways to find them. ### Option 1: From your storefront Both values are 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 `readservices-b2c.powerreviews.com` 3. Copy the **Merchant ID** and **API key** from the PowerReviews widget request ### Option 2: From your PowerReviews dashboard Find your **Merchant ID** and **API key** in your PowerReviews account settings. {% hint style="info" %} The display API 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 PowerReviews in Alhena 1. In Alhena, go to **Settings > Integrations** 2. Find **PowerReviews** and click **Enable** 3. You'll be taken to the PowerReviews settings page ### Step 2: Connect Your Account 1. Enter your **Merchant ID** 2. Enter your **API key** 3. (Optional) Set a **Locale** — leave it as `en_US` unless your reviews are published in a different locale 4. Click **Connect** Alhena verifies the credentials with PowerReviews before saving them. If something is wrong, you'll see an error explaining what to fix. A valid setup on a store that doesn't have any reviews yet still connects successfully. *** ## Enabled Agents and Capabilities Connecting PowerReviews adds product-review awareness to your **Product Expert Agent**. | Capability | Description | | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Product Reviews & Q\&A** | The Product Expert Agent reads your PowerReviews 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 PowerReviews 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 use?" * "How do people rate the quality?" * "Do reviewers think it's worth the price?" * "Has anyone mentioned how it holds up over time?" ### 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 the warranty?" * "Is there a question about compatibility?" 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 %} *** ## PowerReviews and your store platform together PowerReviews 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 PowerReviews: 1. Go to **Settings > Integrations > PowerReviews** 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 PowerReviews are unaffected. *** ## Troubleshooting ### "PowerReviews merchant ID and API key are required" * Both the Merchant ID and the API key must be filled in before connecting * Paste each value with no leading or trailing spaces ### "PowerReviews rejected these credentials" * Double-check the **Merchant ID** and **API key** — both must belong to the same PowerReviews account * Confirm the API key is still active in your PowerReviews account settings ### "PowerReviews doesn't recognize this merchant ID and locale" * Verify the Merchant ID is correct * If your reviews are published in a non-default language, set the matching **Locale** (otherwise leave it as `en_US`) ### "Couldn't reach PowerReviews" or "validation timed out" * A temporary network hiccup between Alhena and PowerReviews — 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 PowerReviews * If you just connected, give the next crawl time to finish before expecting reviews in answers ### Reviews stopped updating * Check that PowerReviews still shows as **Connected** under **Settings > Integrations** * If the API key changed in PowerReviews, reconnect with the new credentials