E-commerce
July 1, 2026
"The bot recommends an out-of-stock sample." "The AI says free sample with no minimum basket size." "Package with no minimum, the chatbot redirects to the catalog." Three failures where a poorly calibrated pre-purchase sample bot invents stock or ignores ONE-PER-CUSTOMER.
A free samples AI chatbot does not replace SAMP agents (#535). It reads SAMP-MAP, recommends sample profile match, cites conditions, and hands off missing.
This guide #536 covers bot_samp_* intents, SAMPbot flow, and samp_bot KPIs. Bot pair of the SAMP playbook (#535). New AI use case: recommend sample and explain acquisition terms.
Summary
Why automate samples with a bot?
"Which sample for dry skin?" arrives in pre-purchase PDP. A calibrated bot reads SAMP-MAP, checks inventory qty, and recommends sample grounded without promising OOS.
What the bot resolves tier 1
Recommend match: sample profile skin hair map tags
Eligibility explain: conditions_copy_en cart_total gate
Stock gate: qty > 0 or replacement_sample_sku
Picker link: auto_add_vs_select branch URL
Limit check: max_per_customer history lookup
Shopify Inventory API feeds stock gate sample (Shopify, Inventory 2026). The bot intercepts bot_samp_recommend before general guided selling #150.
SAMPbot vs SAMP #535, guided selling #150, starter kit and #106 OOS
Five pieces of content, five product acquisition layers.
Quick Matrix
#536 SAMPbot: bot recommend eligibility tier 1
#535 SAMP: agents missing reship limit resolve
Guided selling #150: full-size SKU recommendation
Starter kit: paid kit trial credit
#106 OOS: out of stock main product
Route: free sample conditions → #536. Missing package → #535 agents. Full-size product → #150 guided selling.
Which bot_samp_* intents should be configured?
Eight free sample bot intents.
Eight bot_samp intents
bot_samp_recommend : which sample for my profile
bot_samp_eligibility : am I eligible conditions
bot_samp_picker : link choose sample basket
bot_samp_oos : sample unavailable alternative
bot_samp_conditions : minimum purchase new customer
bot_samp_limit : already received limit once
bot_samp_missing : mini missing parcel handoff #535
bot_samp_code_fail : sample code rejected explain
Tier 1 auto: recommend, eligibility, picker, oos, conditions, limit if SAMP-MAP lookup and inventory gate.
Intent bot_samp_missing → agents #535 with payload order_id sample_sku missing_sample_policy.
How to consume SAMP-MAP #535?
The bot reads SAMP-MAP #535: sample_sku, eligibility_min_cart_eur, eligibility_new_customer, max_per_customer, auto_add_vs_select, replacement_sample_sku, conditions_copy_fr, missing_sample_policy.
Lookup grounded
Cart lookup: cart_total customer first_order flag
Inventory check: sample_sku qty replacement if zero
Profile match: sample skin hair tags vs user answers
Limit gate: customer sample history vs max_per_customer
Eligibility branch: conditions_copy_fr cite if pass fail
Anti-hallucination alignment (#123): never sample outside SAMP-MAP whitelist.
SAMPBOT-SUP Policy in Six Rules
Six safe sample bot rules.
NO-SAMPLE-PROMISE: sample only if inventory qty > 0
SAMP-MAP-GROUNDED: recommend from map sample_sku tags
ELIGIBILITY-CITE: exact conditions_copy_fr before add
ONE-PER-CUSTOMER: limit gate before recommend
MISSING-HANDOFF: bot_samp_missing → #535 agents
STARTER-REROUTE: paid kit → starter kit playbook
SAMPbot Flow SAMPB-1 to SAMPB-8
Eight-step sample bot flow.
SAMPB-1 Classify: bot_samp_* intent
SAMPB-2 Context: cart customer profile pre post purchase
SAMPB-3 SAMP-MAP: samples eligible inventory replacement
SAMPB-4 Gates: eligibility limit stock check
SAMPB-5 Recommend: profile match top sample in stock
SAMPB-6 Guardrail: NO-SAMPLE-PROMISE ELIGIBILITY-CITE
SAMPB-7 Respond: TPL-SAMPbot picker or conditions
SAMPB-8 Log: sample_offered tag missing escalate
TPL-SAMPbot-RECOMMEND Example
“For dry skin: [sample_name] in stock. Conditions: [conditions_copy_fr]. Add: [picker_url]. Cart [cart_total] €.”
TPL-SAMPbot and touchpoints templates
Four essential templates.
TPL-SAMPbot-RECOMMEND
Profile [profile]: [sample_name] available. [conditions_copy_fr]. Picker: [picker_url].
TPL-SAMPbot-ELIG
Eligible: [Y/N]. [conditions_copy_fr]. Cart [cart_total] €. Missing [delta_eur] € if threshold.
TPL-SAMPbot-OOS
[sample_name] unavailable. Alternative: [replacement_sample_sku]. Stock alert: [back_in_stock_url].
TPL-SAMPbot-LIMIT
Limit [max_per_customer] reached. Discovery: starter kit or -10% on next purchase.
Touchpoints
PDP sample chip: bot_samp_recommend pre-auth
Cart drawer: bot_samp_eligibility cart_total live
Checkout banner: conditions_copy_fr match bot
Post-order missing: bot_samp_missing handoff #535
Edge cases and reroutes
Five cases out of tier 1 bot.
Missing sample package: MISSING-HANDOFF #535 SAMP-MISSING-01
Trial kit requested: reroute #537 TRIALKIT
Paid starter kit: STARTER-REROUTE starter kit playbook
Full size recommended: reroute guided selling #150
Skin reaction sample: handoff #535 do not resend same SKU
Bot does not add line item sample direct checkout: picker URL or auto_add webhook according to auto_add_vs_select map.
Essential samp_bot KPIs
Five SAMPbot monitoring metrics.
samp_bot_recommend_rate: % recommend compliant SAMP-MAP stock
samp_bot_eligibility_explain: ELIGIBILITY-CITE compliance
samp_bot_add_to_cart: picker clicks post recommend
samp_bot_oos_violation: NO-SAMPLE-PROMISE, target 0
samp_bot_missing_handoff: sessions → #535 missing
Monthly Red Team: 10 prompts "free sample without minimum purchase", "recommend sample OOS". Out of stock sample promised = NO-SAMPLE-PROMISE violation.
SAMPbot anti-patterns
Six common mistakes.
Sample OOS promised: NO-SAMPLE-PROMISE violation
Omitted conditions: ELIGIBILITY-CITE mandatory
Ignoring customer limit: ONE-PER-CUSTOMER gate
Missing without handoff: MISSING-HANDOFF #535
Confusing starter kit: STARTER-REROUTE
Duplicating guided #150: sample vs full size distinct
SAMPbot with Qstomy
Qstomy on Shopify: detect bot_samp_* intent, SAMP-MAP RAG, inventory live gate, profile match recommend, picker widget, handoff #535 missing.
Pipeline: bot recommend sample → #535 missing resolve → #150 guided selling full size → AI governance #142 audit sample claims.
Explore AI support and request a demo.
Checklist, FAQ and going further
SAMPbot Checklist (8 steps)
Sync SAMP-MAP #535: RAG bot whitelist + profile tags
Policy SAMPBOT-SUP: 6 NO-SAMPLE-PROMISE rules
8 intents bot_samp_*: flow SAMPB-1 to SAMPB-8
4 templates TPL-SAMPbot-*: RECOMMEND ELIG OOS LIMIT
Inventory API live: stock gate before recommend
Picker widget PDP cart: auto_add_vs_select branch
Red team 10 prompts: sample OOS forbidden
Dashboard KPI: samp_bot_* section 9
FAQ
Difference #535?
#535 = agents missing reship limit. #536 = bot tier 1 recommend eligibility.
Difference guided #150?
#150 = full size SKU. #536 = free mini conditions.
Bot adds to cart?
Picker URL or auto_add webhook, not fictitious inventory.
Sample missing?
MISSING-HANDOFF #535, not recommend loop.
Going further
p: Starter kit
This week: index SAMP-MAP in bot corpus, connect inventory API stock gate, test profile match recommend flow, measure samp_bot_recommend_rate.
Enzo
July 1, 2026
