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

​

Choose the look

• Style: start from a preset (Editorial, Minimal, Soft or Bold), then pick the star color (or your theme’s text color), corners, how reviews are framed (lines, outlines or filled cards) and whether headings use your theme’s heading font.
• Content: turn the AI summary, the row of customer photos, photos in reviews, the verified-buyer mark, reviewer initials, review dates and your replies on or off.
• Settings: the default sort, and whether products without reviews show the section at all.

• Product reviews and All reviews: the layout (summary beside the list, cards, or one column).
• Star rating: three badge styles.
• Carousel: which reviews, the card (photo on top, quote only, or a wall), cards per view on desktop, whether it moves on its own, and the product.
• Review wall: which reviews, and the photo filter.
• Testimonials: which reviews, whether it moves on its own, and the product.
• Rating banner: a band with quotes, or one line.
• Review highlights: the AI summary and the best quote.

​

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>

<!-- Reviews side by side -->
<div data-boom-reviews="carousel"></div>

<!-- A wall of reviews and photos -->
<div data-boom-reviews="wall"></div>

<!-- One large quote at a time -->
<div data-boom-reviews="testimonials"></div>

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

<!-- Your rating, with a link for the one-line style -->
<div data-boom-reviews="banner" data-link="/pages/reviews"></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"
  }'

​

The AI summary on product pages

​

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