> 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-bazaarvoice.md). # BazaarVoice Connect BazaarVoice 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 BazaarVoice account with Ratings & Reviews (the Conversations product) enabled * Your BazaarVoice **display passkey** (instructions below) ## Getting Your Passkey Alhena needs your BazaarVoice **display passkey** — the read-only key your storefront already uses to show ratings and reviews. There are two ways to find it. ### Option 1: From the BazaarVoice Portal 1. Log in to your **BazaarVoice Portal** 2. Go to **Settings → Technical → API Keys** 3. Copy the **Conversations API** key (the display passkey) ### Option 2: From your storefront If you don't have portal access, the display passkey 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 `passkey` 3. Copy the value — a long alphanumeric string that usually begins with `ca…` {% hint style="info" %} The display passkey 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 BazaarVoice in Alhena 1. In Alhena, go to **Settings > Integrations** 2. Find **BazaarVoice** and click **Enable** 3. You'll be taken to the BazaarVoice settings page ### Step 2: Connect Your Account 1. Paste your **BazaarVoice passkey** into the field 2. Click **Connect** Alhena verifies the passkey with BazaarVoice 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 BazaarVoice adds product-review awareness to your **Product Expert Agent**. | Capability | Description | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Product Reviews & Q\&A** | The Product Expert Agent reads your BazaarVoice 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 BazaarVoice 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 mattress?" * "Is this comfortable for side sleepers?" * "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 assembly?" * "Is there a question about whether this is machine washable?" 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 %} *** ## BazaarVoice and your store platform together BazaarVoice 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: Alhena works out how your BazaarVoice catalog lines up with the products in your store, whether that's by the store's product ID or its product handle. *** ## Disconnecting To disconnect BazaarVoice: 1. Go to **Settings > Integrations > BazaarVoice** 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 BazaarVoice are unaffected. *** ## Troubleshooting ### "Passkey looks malformed" * Make sure you pasted the full display passkey with no leading or trailing spaces * The passkey is a single long alphanumeric string — no spaces, slashes, or quotes ### "BazaarVoice rejected this passkey" * Double-check you copied the **Conversations API / display** passkey, not a different BazaarVoice key * Confirm the key is still active in your BazaarVoice Portal under **Settings → Technical → API Keys** ### "Couldn't reach BazaarVoice" or "validation timed out" * A temporary network hiccup between Alhena and BazaarVoice — 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 BazaarVoice * If you just connected, give the next crawl time to finish before expecting reviews in answers ### Reviews stopped updating * Check that BazaarVoice still shows as **Connected** under **Settings > Integrations** * If the passkey was rotated in BazaarVoice, reconnect with the new key