Connect Loox

Loox can send its reviews to Charm in two ways. Pick the one your Loox plan allows:

	Loox webhook (recommended)	Shopify Flow
Loox plan	Convert or Unlimited	Any plan
A review earns	Once Loox publishes it	As soon as it’s written
Photo or video added later	Earns the photo/video bonus	Not seen
Verified purchase	Loox’s own verified mark	The review carries a Loox order ID
How Charm tells reviews apart	Loox’s review ID	The reviewer’s email, the product and the review date

Both earn whatever your Post a product review rule pays, the same way a review from any other review app does.

Connect with the Loox webhook

Loox’s API keys and webhooks are available on the Loox Convert and Unlimited plans.

In your Shopify admin, open Charm and go to Settings → Integrations → Review apps.
Pick Loox in the Review provider dropdown.
Under How Loox sends reviews, choose Loox webhook and click Generate setup. Copy the Payload URL.
In Loox, open Settings → API keys and scroll to Webhooks. Add an endpoint:
- URL: the Payload URL from Charm.
- Events: product-review.published and product-review.updated.media-added.
- Validation key: any secret you make up, for example a long random string. Loox signs every webhook with it.
Back in Charm, paste the same key into Loox validation key and click Save validation key.
Make sure the Post a product review rule is on under Program → Earning points.

When the key is saved, the Loox card shows Loox webhook on with the last four characters of the key.

Loox has no API that lets Charm register the webhook itself, so the endpoint is added in Loox by hand. Charm only needs the Payload URL and the validation key: the Public Store ID and Secret API keys on the same Loox page aren’t used.

Which reviews earn

Published reviews only. A review earns when Loox publishes it. With auto-approve on in Loox that’s straight away; otherwise it’s when you approve the review. A review you never publish earns nothing.
Photos and videos added later. When a customer adds a photo or video to a review that already earned, Charm pays the photo/video bonus on top, once.
Signed webhooks only. A webhook whose signature doesn’t match the saved validation key earns nothing. If you change the key in Loox, save the new one in Charm too.
Once per review. A review Loox sends more than once still earns one reward.
Product reviews only. Loox store reviews don’t earn points.

While the key is saved, Charm ignores Loox requests from Shopify Flow. If you used Flow before, a review can’t earn twice this way, and you can turn the workflow off in Shopify Flow.

Connect with Shopify Flow

Use this on Loox plans without webhooks.

In Settings → Integrations → Review apps, pick Loox, choose Shopify Flow under How Loox sends reviews and click Generate setup.
In Shopify Flow, create a workflow with Loox’s New review trigger.
Add a Send HTTP request action: method POST, the Payload URL from Charm as the URL, header Content-Type: application/json, and the Example JSON body from Charm as the body. Keep the | json filters in it.
Turn the workflow on.

The example body maps the fields Charm needs:

email: who wrote the review. It has to match a customer in your Shopify store.
orderId: Loox sets it on reviews written from a Loox review request. A review with an order ID counts as a verified purchase, which matters while Only reward verified purchases is on.
reviewDate and productId: Loox’s trigger has no review ID, so Charm tells reviews apart by the reviewer’s email, the product and the review date. Keep all three in the body.
photoUrl: a review with a photo earns the photo/video bonus.

Loox’s Flow trigger fires when a review is written, so the review earns then, before you moderate it.

Switch between the two

Pick the other option under How Loox sends reviews. Switching to Shopify Flow removes the saved validation key, so Flow requests earn again; also delete the endpoint in Loox. Switching to Loox webhook keeps Flow working until you save the validation key.

Disconnect

Click Disconnect on the Loox card. New Loox reviews stop earning points straight away. Charm can’t reach into Loox or Shopify Flow, so delete the webhook endpoint in Loox, or turn off the Flow workflow, yourself. Anything they keep sending is acknowledged without awarding points.