- Bestsellers in product blocks, counted from your orders after refunds.
- Customer signals on each contact: last order, usual gap between orders, next order expected, favourite category and customer stage. Segments can use them.
- Picked for each customer, a product block that shows each customer products picked from what they bought.
1
Create an API key
Open Settings → API Keys and create a key with the scopes Track
events, Write catalog products and Read catalog products. Only an
owner or admin can create keys. Give the key to the person who sets up the
connection, and keep it out of your storefront.
2
Send your products
Your developer sends all your products once, then each product again when it
changes. Products keep your platform’s own product IDs, so nothing has to
store SegmentFlow.ai IDs. They appear in Content → Products.
3
Import your past orders
Your developer sends the last year of orders, marked as history. History
counts for bestsellers, customer signals and picks, but it never starts a
journey or sends an email.
4
Connect new orders and refunds
Your platform’s order webhooks go to a small mapping step, in your own
backend, n8n or Make, which sends each paid order and each refund to
SegmentFlow.ai. Sending an order again updates it, so retries never double
count.
5
Check the next day
SegmentFlow.ai calculates everything every night at 03:00 in your store’s
time zone. Open Data & Integrations → Integrations: under Order items
without a product you see order items whose product ID or SKU matched none
of your products. Ask your developer to send those products or fix the IDs.
6
Preview picks for a customer
In the email editor, add a product block and set its source to Picked for
each customer. Preview the email as a contact who has ordered: the preview
lists the products picked for them and why. A contact with no orders sees
your bestsellers.
Questions
Will importing my order history email my customers?
Will importing my order history email my customers?
No. Orders sent as history never start a journey, also not by moving a
customer into a segment that starts one.
What about refunds?
What about refunds?
Send each refund with the products refunded. Refunded products stop counting
as bought, in bestsellers and in each customer’s picks.
Do I need this for Shopify or WooCommerce?
Do I need this for Shopify or WooCommerce?
No. Those stores connect through their integration, which sends products and
orders by itself. See Set up SegmentFlow.ai on
Shopify.
Is my platform supported?
Is my platform supported?
Any platform that can send a webhook when an order is paid works, through
n8n, Make or your own backend. Platforms without webhooks can send orders
from a scheduled export.

