Post-meal reviews

Ask diners to rate each dish of an order your backend sent, 1 to 5 stars, from your app's AI waiter chat, and receive the ratings as review.submitted webhooks.

After an order your backend sent is served, your app can ask the diner how it was, dish by dish, 1 to 5 stars. The ratings show in the restaurant's dashboard and Insights, and your backend gets each one as a review.submitted webhook.

From the SDK

requestReview asks the chat to open its "How was your order?" sheet, held until the chat is ready. Name up to 30 dishes, each by dishId or externalId, with the title the diner saw.

PlatformCall
Web, React NativerequestReview({ orderId, dishes })
FlutterrequestReview(ReviewRequestData(orderId: …, dishes: […]))
iOSrequestReview(orderId:dishes:)
AndroidrequestReview(orderId, dishes)

requestReview arrives with each SDK's next release (1.1.0; React Native 1.2.0). Your app hears review.submitted with what the diner rated.

The rules

  • The order must be one your backend sent with Send an order, for this diner, placed or completed, within 30 days. Send the order first: asking about one Tamr hasn't received yet is refused with order_not_found, and you can ask again once it is sent.
  • The diner must be signed in: a guest gets guest_not_allowed.
  • One review per dish per order. Sending again changes a rating, and the same rating again changes nothing.
  • A test key's diner writes nothing, but their ratings are still sent to your test endpoints as test events.

From your own chat

An app that draws its own chat calls Match an order for review for the dishes it can rate, then Rate an order's dishes with the stars.

An app with its own review flow can turn Tamr's off: see Hiding features.