E-commerce
July 1, 2026
"The bot told me I was eligible with €60 even though the threshold is €75." "The AI promised a replacement gift without verifying the package." "Chatbot confuses GWP and stackable promo code." Three failures where a poorly calibrated GWP bot promises a gift or reship outside of policy.
An AI gift-with-purchase chatbot does not replace GWP agents (#553). It reads GWP-MAP, calculates grounded eligibility, cites threshold exclusions, and hands off missing reship tasks to humans.
This guide #554 covers intents bot_gwp_*, flow GWPbot, and KPI gwp_bot. Pair bot of the GWP playbook (#553). New promotional AI use case: verify GWP eligibility without making up the threshold.
Summary
Why automate GWP with a bot?
"Am I eligible for the gift?" and "how much more do I need for the free mini?" skyrocket during Black Friday campaigns. A well-calibrated bot reads GWP-MAP, calculates eligible_total cart, quotes exclusions and stack_rules without promising direct reship.
What the tier 1 bot solves
Cart eligibility: threshold calc exclusions map
Missing threshold: remaining amount for GWP
Exclusions explained: sale SKUs excluded from campaign
Promo stacking: stack_rules quoted grounded
Trigger product: buy X for gift Y map
SimplyCodes estimates 26% of promo failures are linked to misunderstood rules (SimplyCodes, codes 2026). The bot intercepts bot_gwp_eligibility before an invented threshold.
GWPbot vs GWP #553, BOGO #197, SAMP #535 and promo #111
Five contents, five distinct promo mechanics.
Quick matrix
#554 GWPbot: bot tier 1 eligibility threshold exclusions
#553 GWP: agents missing reship OOS execute
#197 BOGO: 2+1 mix-and-match return
#535 SAMP: mini sample select basket
#111 promo: general coupon cumulative rules
Pipeline: bot eligibility quotes → #553 missing reship OOS execute. BOGO = quantity discount, not bot_gwp intents.
Which bot_gwp_* intents should be configured?
Eight GWP bot intents mapped to typologies #553.
Eight bot_gwp intents
bot_gwp_eligibility: am I eligible for cart or order
bot_gwp_threshold_gap: how much is missing for the gift
bot_gwp_exclusion_why: why is the cart not eligible
bot_gwp_gift_info: what gift is offered conditions
bot_gwp_stack_promo: combining GWP with promo code
bot_gwp_trigger_product: product triggering gift Y
bot_gwp_missing_handoff: gift missing → handoff #553
bot_gwp_oos_handoff: gift out of stock → handoff #553
Tier 1 auto: eligibility, threshold_gap, exclusion_why, gift_info, stack_promo, trigger_product if cart or order + GWP-MAP.
bot_gwp_missing_handoff, oos_handoff → agents #553 with order payload campaign_id intent.
How to consume GWP-MAP #553?
The bot reads GWP-MAP #553: campaign_id, trigger_type, threshold_amount, gift_sku, exclusions, stack_rules, gift_stock, reship_policy.
Lookup grounded
Cart calc: eligible_total exclusions subtract map
Order verify: gift line item present fulfillment
GWP-MAP row: threshold gift exclusions stack
THRESHOLD-EXPLICIT: VAT Excl. Tax shipping always cited
NO-INVENT-THRESHOLD: map threshold only never guessed
MISSING-HANDOFF: reship → agents #553 only
Alignment anti-hallucination (#123): gift threshold = GWP-MAP or Shopify discount API only.
GWPBOT-SUP policy in six rules
Six safe GWP bot rules.
GWP-MAP-GROUNDED: threshold gift exclusions from map only
NO-INVENT-THRESHOLD: bot never guesses threshold amount
THRESHOLD-EXPLICIT-BOT: VAT, excl. tax, and shipping cited in each response
NO-RESHIP-BOT: bot does not initiate direct gift reshipment
NO-PROMISE-STACK-BOT: accumulation cites stack_rules map only
MISSING-HANDOFF: missing gift → agents #553 verify reship
GWPbot Flow GWPB-1 to GWPB-8
Flow eight steps free gift bot.
GWPB-1 Classify: bot_gwp_* intent detect
GWPB-2 Context: live cart or order verify collect
GWPB-3 Campaign lookup: campaign_id active GWP-MAP
GWPB-4 Eligibility calc: threshold exclusions eligible_total
GWPB-5 Guardrail: NO-INVENT NO-RESHIP NO-PROMISE-STACK
GWPB-6 Respond: TPL-GWPbot grounded
GWPB-7 Handoff: missing oos reship → #553 payload
GWPB-8 Log: intent campaign_id tag gwp_bot
Example TPL-GWPbot-ELIG
“Campaign [campaign_name]: [gift_product] free starting from [threshold_amount] € [TTC/HT, shipping included/excluded]. Exclusions: [exclusions summary]. Your eligible cart [eligible_total] €: [eligible / lacking [gap] €].”
TPL-GWPbot and touchpoint templates
Four essential templates.
TPL-GWPbot-ELIG
Campaign [campaign_name]. Gift: [gift_product]. Threshold [threshold_amount] € [inclusive/exclusive of tax and shipping rules]. Status: [eligible / gap of X €]. Exclusions: [exclusions].
TPL-GWPbot-GIFT-INFO
Free gift: [gift_product] SKU [gift_sku]. Condition: [trigger_type summary]. Inventory: [gift_stock status]. Campaign ends: [end_date].
TPL-GWPbot-STACK
GWP and promo code [promo_code]: [stack_rules map]. [Combinable / non-combinable]. Checkout applies: [GWP or code].
TPL-GWPbot-HANDOFF
Request [missing / oos / reship] transferred to an agent. Order #[order_num]. Campaign [campaign_id]. Response time [handoff_sla].
Touchpoints
GWP homepage banner: bot_gwp_gift_info chip
Cart page: bot_gwp_threshold_gap dynamic bar
Checkout gift badge: bot_gwp_eligibility trigger
Help center promo FAQ: bot embed GWP-MAP RAG
Edge cases and reroutes
Five cases out of Tier 1 bot standard eligibility.
Missing gift reship: NO-RESHIP-BOT MISSING-HANDOFF #553
Gift OOS alternative: bot_gwp_oos_handoff #553 GWP-OOS-01
BOGO confusion: #197 reroute BOGO not GWP
Gift card threshold: gift card payment threshold map
Flash sale timezone: expired campaign handoff #553
Bot never modifies Shopify cart: auto gift addition = checkout app, not bot executed.
Essential GWP bot KPIs
Five GWPbot steering metrics.
gwp_bot_eligibility_success: % correct eligible audit calc
gwp_bot_threshold_invented: bot invented thresholds, target 0
gwp_bot_deflect: eligibility sessions without human ticket
gwp_bot_unauthorized_reship: bot promised reship, target 0
gwp_bot_missing_handoff: missing sessions → #553 agents
Monthly red team: 10 prompts "€50 threshold", "resend my gift now", "combine GWP and promised -30%". Invented threshold = NO-INVENT-THRESHOLD violation.
GWPbot anti-patterns
Six common mistakes.
Invented threshold : NO-INVENT-THRESHOLD
Direct reship bot : NO-RESHIP-BOT
Cumulation promised off-map : NO-PROMISE-STACK-BOT
Excluding/Including tax omitted : THRESHOLD-EXPLICIT-BOT
Missing without handoff : MISSING-HANDOFF #553
Ignored exclusions : GWP-MAP-GROUNDED
GWPbot with Qstomy
Qstomy on Shopify: detect bot_gwp intent, cart eligible_total calc, GWP-MAP RAG, NO-RESHIP guardrail, stack rules cite, missing handoff #553 payload.
Pipeline: bot tier 1 eligibility → #553 missing reship execute → AI governance #142 promo bot audit.
Explore AI support and request a demo.
Checklist, FAQ and going further
GWPbot Checklist (8 steps)
Sync GWP-MAP #553: RAG bot + cart API calc
Policy GWPBOT-SUP: 6 NO-RESHIP-BOT rules
8 intents bot_gwp_*: flow GWPB-1 to GWPB-8
4 templates TPL-GWPbot-*: ELIG GIFT-INFO STACK HANDOFF
Cart bar dynamic: bot_gwp_threshold_gap entry
Red team 10 prompts: invented threshold reship cumulative
Missing handoff workflow: payload #553
Dashboard KPI: gwp_bot_* section 9
FAQ
Difference #553?
#553 = agents missing reship OOS execute. #554 = bot tier 1 eligibility cite handoff.
Bot resends gift?
No. NO-RESHIP-BOT. MISSING-HANDOFF #553.
Cart threshold?
TPL-GWPbot-ELIG from GWP-MAP, incl. VAT excl. VAT shipping explicit.
Promo code accumulation?
TPL-GWPbot-STACK stack_rules map only.
Go further
p: BOGO (#197)
This week: sync GWP-MAP RAG bot, red team “€50 threshold resends gift”, measure gwp_bot_threshold_invented. Activate cart bar bot_gwp_threshold_gap.
Enzo
July 1, 2026
