Set up product reviews
Summary
Section titled “Summary”You connect Lipscore on the Product reviews page under Settings > Entry-points in the KonversAI console. The page carries the heading Reviews (Lipscore). After you connect, each new product review with text arrives in KonversAI as a conversation under Conversations > Reviews. The assistant drafts a public reply to each review. By default, a person reads the draft and publishes it. You can let KonversAI publish some or all replies by itself. A published reply appears under the review on your product page. Product reviews is an add-on.
Who can do this
Section titled “Who can do this”A team member with the View tenant settings permission opens Settings > Entry-points and sees the Product reviews page. A team member with the Modify tenant settings permission adds the keys, tests the connection, switches the channel on or off, and changes the reply settings. A Tenant Admin holds both permissions. Without Modify tenant settings, the page shows the settings without the buttons to change them.
Before you start
Section titled “Before you start”Your workspace needs the Product reviews add-on. Without the add-on, the Product reviews page shows an Enable button. A team member with Modify tenant settings selects Enable there, or on the Product reviews card under Settings > Cost & contract > Addons. See Turn an add-on on or off.
You need a Lipscore account for your shop, and access to its API settings. KonversAI needs three keys from Lipscore: the API key, the Secret API key and the HMAC secret.
To open a case for each low-rated review, your workspace also needs the Customer cases add-on. To get a draft email to the reviewer on the case, it also needs an email address KonversAI can send from. See How cases keep a customer matter together.
Open the Product reviews page in KonversAI
Section titled “Open the Product reviews page in KonversAI”- In KonversAI: Select Settings in the left sidebar, then select Entry-points. The screen opens with the heading Entry points.
- In KonversAI: Select Add entry point, then find the Product reviews card. Select Configure. When the add-on is off, the card shows Enable instead: select Enable, and KonversAI turns the add-on on and opens the page. The page opens with the heading Reviews (Lipscore).
Copy the keys in Lipscore
Section titled “Copy the keys in Lipscore”- In Lipscore: Open Settings > General > API settings.
- In Lipscore: Copy the API key, the Secret API key and the HMAC secret. Keep the page open, because you paste each key in turn.
Connect Lipscore in KonversAI
Section titled “Connect Lipscore in KonversAI”- In KonversAI: Under Lipscore connection, select Add next to API key. Paste the key in the window, then select Save. The row now shows Configured. KonversAI stores the key encrypted and never shows the key again.
- In KonversAI: Repeat step 5 for Secret API key and HMAC secret. Until all three keys are added, the page says Add all three keys to test the connection.
- In KonversAI: Select Test connection. The button shows Testing connection…. The test checks the API key, the Secret API key and the webhook access in Lipscore. It cannot check the HMAC secret, so paste that one carefully. When the test passes, the page shows Connected. Lipscore will send new reviews here. The first successful test switches the channel on. The status shows Connected, and Lipscore webhooks shows Registered. Conversations > Reviews now appears in the left sidebar.
Choose how replies work in KonversAI
Section titled “Choose how replies work in KonversAI”- In KonversAI: Under Replies, write the Reply instructions. Say which tone the replies use, how they sign off, and where an unhappy customer gets help. For example: Sign off as “The Shop team”. Point unhappy customers to our contact form at shop.example/contact. Every reply is public, so the assistant is told never to put personal details in a reply.
- In KonversAI: Under Publish replies automatically, choose when a
reply goes out without a person reading the reply first:
- Never send automatically keeps every draft for a person to read and publish. A new connection starts here.
- Evaluate only (dry run) checks each draft against your description in Send drafts automatically when and records the verdict. Every draft still waits for a person.
- Send when the description below matches publishes the drafts that match your description in Send drafts automatically when. Every other draft waits for a person.
- Send every reply automatically publishes every draft without review.
- In KonversAI: When you chose a mode that reads a description, write the description in Send drafts automatically when. For example: Publish automatically when the review is positive and the reply only thanks the customer. A draft that the description does not clearly cover waits for a person.
- In KonversAI: Select Save. The page shows Saved.
Open a case for low-rated reviews in KonversAI
Section titled “Open a case for low-rated reviews in KonversAI”- In KonversAI: Optional: in the Notifications card, switch on Open a case for low-rated reviews. The card shows only when your workspace has the Customer cases add-on.
- In KonversAI: Pick the star limit in Rating that counts as low, such as 2 stars or fewer. Pick the address in Send drafts from. The reviewer’s answer to the draft email lands at that address.
- In KonversAI: Select Save in the Notifications card. From now on, a review at or below the limit opens a case with the review in it. KonversAI adds a draft email to the reviewer on the case. KonversAI never sends the draft email by itself.
Why is Reviews missing from the left sidebar?
Section titled “Why is Reviews missing from the left sidebar?”Conversations > Reviews appears in the left sidebar of the KonversAI console only while your workspace has the Product reviews add-on and an enabled Lipscore connection. Your role also needs the View conversations permission. Open Settings > Entry-points > Product reviews, and check that the status reads Connected. If the status reads Turned off, set the switch to Enabled and select Save.
Which reviews arrive in KonversAI?
Section titled “Which reviews arrive in KonversAI?”New product reviews with text arrive under Conversations > Reviews in the KonversAI console, from the moment the Lipscore connection is on. A review with a star rating and no text does not arrive. A review that already has a reply in Lipscore does not arrive either. Reviews written before you connected Lipscore stay in Lipscore. Last review received on the Product reviews page shows when Lipscore last delivered a review to KonversAI, including a review KonversAI ignored.
Does KonversAI publish replies to reviews by itself?
Section titled “Does KonversAI publish replies to reviews by itself?”Only when you allow it. A new Lipscore connection starts on Never send automatically, so every AI reply waits under Conversations > Reviews for a person to select Publish reply. To let KonversAI publish some replies, open Settings > Entry-points > Product reviews. Choose Send when the description below matches or Send every reply automatically under Publish replies automatically, then select Save. A published reply appears under the review on your product page for everyone to see.
The page says “Lipscore sent reviews we could not verify.” What do I do?
Section titled “The page says “Lipscore sent reviews we could not verify.” What do I do?”The Product reviews page in the KonversAI console shows Lipscore sent reviews we could not verify. Check that the HMAC secret matches the one in Lipscore’s API settings. when the HMAC secret in KonversAI does not match Lipscore. Reviews do not arrive until the secret matches. Copy the HMAC secret again from Settings > General > API settings in Lipscore. In KonversAI, select Update next to HMAC secret, paste the secret and select Save.
What happens when I switch the channel off?
Section titled “What happens when I switch the channel off?”Set the switch on the Product reviews page in the KonversAI console to Disabled, then select Save. KonversAI removes its webhooks from Lipscore, and new reviews stop arriving. KonversAI keeps the review conversations, but Reviews disappears from the left sidebar and you cannot publish replies. Drafts that were waiting stay unpublished. Set the switch to Enabled and select Save to start again.
What happens when I remove the Lipscore connection?
Section titled “What happens when I remove the Lipscore connection?”Select Remove connection on the Product reviews page in the KonversAI console. KonversAI asks Remove the Lipscore connection? New reviews stop arriving. Existing conversations are kept. After you confirm, KonversAI forgets the three keys. The kept conversations no longer show under Reviews. To connect again, add the keys and select Test connection.
Why does a low-rated review open a case with no draft email?
Section titled “Why does a low-rated review open a case with no draft email?”KonversAI opens the case but adds no draft email when it has no email address for the reviewer, when the address in Send drafts from cannot send, or when the assistant could not write the draft. When you leave Send drafts from on the default, KonversAI uses your default sender. KonversAI never falls back to another address once you pick one. Open Settings > Entry-points > Product reviews in the KonversAI console, and pick an address in Send drafts from in the Notifications card that can send. Your team can still write to the reviewer from the case. See Work on a case.
Can I connect a review provider other than Lipscore?
Section titled “Can I connect a review provider other than Lipscore?”Not yet. KonversAI connects to Lipscore only. Select Need a different provider? under the heading Reviews (Lipscore) on the Product reviews page, and name the provider you use. KonversAI gets your request.
Last reviewed . Tell us when a step no longer matches the product.