Reviews

​

How it works

1. Boom learns your orders. From your connected Shopify store, or from the products and orders your store sends through Boom’s API (below).
2. Boom plans the asks. Every hour, it picks the orders due for an ask (when they were placed, shipped or delivered, plus the days you choose), merges orders shipped close together, and keeps the ask to your most valuable products. Turn on Shadow first to see who would be asked without sending anything.
3. The agent collects the reviews. Set up asks creates a “Product reviews” initiative with a ready journey: the ask, a reminder, and the conversation. Pick your WhatsApp templates, launch it, and switch asks to Live.
4. Your rules decide what’s public. Publish automatically unless the AI check flags something, only from a minimum rating, or always by hand. Photos can wait for a person even when the text is published.

​

Show reviews on Shopify

​

Show reviews on any website

<!-- Boom Reviews: once per page -->
<script src="https://www.useboom.ai/widget/v1/rv/YOUR_STORE_KEY" async></script>

<!-- Stars, near the product title -->
<div data-boom-reviews="stars" data-product-ref="YOUR_PRODUCT_ID"></div>

<!-- The reviews section -->
<div id="boom-reviews" data-boom-reviews="product" data-product-ref="YOUR_PRODUCT_ID"></div>

<!-- The reviews you featured in Boom -->
<div data-boom-reviews="carousel"></div>

<!-- Your shoppers' photos -->
<div data-boom-reviews="gallery"></div>

<!-- Every review, for a reviews page -->
<div data-boom-reviews="all"></div>

​

Send products and orders through the API

• Dates are ISO 8601 date-times with a timezone, like 2026-10-01T15:00:00Z or 2026-10-01T10:00:00-05:00. A date alone (2026-10-01) isn’t read, and an order without a readable placedAt is never asked about.
• Shipped time is fulfilledAt. If you only know when the order arrived, deliveredAt alone counts as shipped too.
• Ids (externalId, line id, productId) are strings. Keep them the same every time you send the order: a changed id reads as a new line, and Boom may ask about it again.
• A line without a title uses the product’s title in the ask.

export BASE="https://www.useboom.ai/api/v1/cdp"
curl -X POST "$BASE/custom-objects" \
  -H "Authorization: Bearer $BOOM_KEY" -H "Content-Type: application/json" \
  -d '{
    "type": "commerce_product",
    "externalId": "kit-viaje",
    "attributes": {
      "title": "Kit de viaje",
      "url": "https://tienda.example/kit-viaje",
      "imageUrl": "https://cdn.example/kit-viaje.jpg",
      "tags": ["viaje"]
    }
  }'

curl -X POST "$BASE/people" \
  -H "Authorization: Bearer $BOOM_KEY" -H "Content-Type: application/json" \
  -d '{ "externalId": "cliente-55", "firstName": "Lucía", "phoneNumber": "+5215512345678" }'

curl -X POST "$BASE/custom-objects" \
  -H "Authorization: Bearer $BOOM_KEY" -H "Content-Type: application/json" \
  -d '{
    "type": "commerce_order",
    "externalId": "web-1001",
    "attributes": {
      "name": "#1001",
      "placedAt": "2026-10-01T15:00:00Z",
      "fulfilledAt": "2026-10-03T12:00:00Z",
      "status": "FULFILLED",
      "currency": "MXN",
      "lineItems": [
        { "id": "1", "productId": "kit-viaje", "title": "Kit de viaje", "unitPrice": 499 }
      ]
    }
  }'

curl -X POST "$BASE/custom-objects" \
  -H "Authorization: Bearer $BOOM_KEY" -H "Content-Type: application/json" \
  -d '{
    "type": "commerce_order",
    "externalId": "web-1001",
    "mode": "merge",
    "attributes": { "status": "CANCELLED" }
  }'

curl -X POST "$BASE/relationships" \
  -H "Authorization: Bearer $BOOM_KEY" -H "Content-Type: application/json" \
  -d '{
    "relationshipTypeId": "PLACED_TYPE_ID",
    "personExternalId": "cliente-55",
    "customObjectExternalId": "web-1001"
  }'

​

Choose the look

​

Reach shoppers by what they rated

​

Thank photo reviews with a gift card

• Boom’s agent tells buyers that the store sends one gift card per order when they add a photo or video to a review, whatever their rating. It never offers anything else.
• Each gift card waits for your approval in Drafts before it’s sent. Approve every photo review’s gift card whatever its rating: approving only happy buyers would make the reward depend on what they said, which consumer-protection rules forbid.
• Reviews written with the reward show as Incentivized review on your store and in Boom.
• To stop offering it, publish your journey without the reward step.

​

When a buyer is unhappy

​

Bring reviews from another app

​

Related