E-commerce
July 1, 2026
Sales launched at 8 a.m. At 10 a.m., the bot still replies "no promotions". At 2 p.m., twelve promomis_bot_unknown tickets.
An AI e-commerce promo sync chatbot indexes Shopify offers in near real-time, displays exclusion dates and codes, purges expired promos, and responds directly from the catalog source, not a static KB.
This guide #886 covers intents bot_promo_sync_*, flow PROMOSYNCbot PSB-1 to PSB-8, and KPI promo_sync_bot. Companion bot of the PROMOMIS playbook (#885). Usecase: promo freshness on the widget side.
Summary
Why synchronize promotions to the bot?
Without sync, promo RAG dates back to the last manual indexing. SHOPIFY-SOURCE-BOT and PROMO-FRESHNESS-BOT reduce tickets #885 and promo contradictions #883.
What promo sync solves
Missing offer: active campaign invisible to the bot
Unknown code: Shopify discount not indexed
Incomplete conditions: date exclusions omitted
Expired promo served: index not purged
Launch delay: hours between go-live and bot live
DTC retail example
DTC fashion, sales sync webhook. promo_sync_bot_freshness_hours < 2 h, promomis_ tickets -38% in 4 weeks.
PROMOSYNCbot #886 vs PROMOMIS #885, VERSION #884, STACK #808 and CONTRA #883
Five promo bot contents, five distinct roles.
Quick Matrix
#886 PROMOSYNCbot: sync indexer serve purge Shopify promo bot
PROMOMIS #885: agents manage missing promo tickets PM-5
VERSION #884: versioning policies KB distinct promo catalog
STACK #808: rules stackable discounts distinct sync offer
CONTRA #883: contradiction bot distinct missing promo
PROMO support: promotional offers general agents
Pipeline: Shopify go-live → #886 webhook sync → drop promomis_ #885.
Which bot_promo_sync_* intents should be configured?
Eight promotional freshness intents mapped PROMOMIS-MAP #885.
Eight bot_promo_sync intents
bot_promo_sync_active_list: active promos list map
bot_promo_sync_code_lookup: discount code lookup map
bot_promo_sync_conditions: channel minimum exclusions dates map
bot_promo_sync_webhook_trigger: reindex on create update Shopify map
bot_promo_sync_stale_purge: expired promos purge index map
bot_promo_sync_launch_notice: new campaign sync message map
bot_promo_sync_apply_hint: cart code application guide map
bot_promo_sync_promomis_feed: consume LOG #885 prioritize sync map
Each promo response logs promo_id synced_at for freshness audit.
How do I consume PROMOMIS-MAP #885?
The bot reads PROMOMIS-MAP #885 + sync fields: promo_index_source shopify, sync_sla_hours, webhook_discount_events, promomis_feed_priority, conditions_required_fields.
Promotion sync guardrails
SHOPIFY-SOURCE-BOT: promo responses from active discount API
PROMO-FRESHNESS-BOT: reject response if synced_at > sync_sla
NO-EXPIRED-PROMO-BOT: stale_purge before serving code
CONDITIONS-COMPLETE-BOT: mandatory minimum channel exclusion end dates
SYNC-SLA-BOT: webhook trigger launched under sync_sla_hours
PROMOMIS-FEED-LOOP-BOT: promomis_feed prioritizes unknown campaign code
STACK-REROUTE-BOT: stack discounts → #808 STACK
PROMOSYNCBOT-SUP policy in six rules
Six rules sync responsible promotion.
SHOPIFY-SOURCE-BOT: single source catalog discount promo bot
SYNC-SLA-BOT: reindex under sync_sla_hours after go-live
CONDITIONS-COMPLETE-BOT: always date exclusions minimum
NO-EXPIRED-PROMO-BOT: auto purge promos ended_at past
PROMOMIS-FEED-LOOP-BOT: each LOG #885 review sync under 24 h
NO-FAKE-PROMO-BOT: do not invent offer outside of Shopify index
PROMOSYNCbot Flow PSB-1 to PSB-8
Eight-step flow: Shopify event index client query response log purge.
PSB-1 Webhook ingest: discount create update delete Shopify
PSB-2 Index build: promo_id code dates exclusions channel
PSB-3 Stale purge: NO-EXPIRED-PROMO ended_at past
PSB-4 Client query: intent promo code active offer
PSB-5 Freshness gate: PROMO-FRESHNESS synced_at OK
PSB-6 Respond: active_list code_lookup conditions apply_hint
PSB-7 Promomis feed: LOG #885 triggers priority re-sync
PSB-8 Log: promo_id synced_at promomis_deflect code_hit
Example TPL-PROMOSYNCbot-OFFER
“[offer_name map]: [discount map]. Valid until [end_date map]. [conditions map.]”
TPL-PROMOSYNCbot and touchpoints templates
Four short promo sync embed templates.
TPL-PROMOSYNCbot-OFFER
[offer_copy map.] [conditions_copy map.] SHOPIFY-SOURCE-BOT.
TPL-PROMOSYNCbot-CODE
[code_copy map.] [apply_hint_copy map.] CONDITIONS-COMPLETE-BOT.
TPL-PROMOSYNCbot-NONE
[no_promo_copy map.] Do not invent offer. NO-FAKE-PROMO-BOT.
TPL-PROMOSYNCbot-SYNC-PENDING
[sync_pending_copy map.] Campaign currently syncing. SYNC-SLA-BOT.
Touchpoints
Ongoing promo question: active_list freshness gate
Customer code entered: code_lookup + apply_hint
Campaign go-live: webhook_trigger + launch_notice
LOG PROMOMIS #885: promomis_feed priority re-sync
Edge cases and reroutes
Five cases outside the standard flow.
Automatic discount without code: offer_copy strikethrough price PDP no code_lookup
Shopify promo not yet webhooked: sync_pending_copy + honest SLA
Two codes combined: reroute #808 stackable
Bot said two amounts: #883 CONTRA + purge stale
Influencer code outside Shopify: handoff PROMOMIS #885 agent lookup
Essential promo_sync_bot KPIs
Five PROMOSYNCbot steering metrics and correlation #885.
promo_sync_bot_freshness_hours: go-live delay → ready bot index
promo_sync_bot_promomis_deflect: promo questions resolved without a promomis_ ticket
promo_sync_bot_code_hit_rate: % of recognized codes in active index
promo_sync_bot_expired_served: expired promos still cited target 0
promo_sync_bot_conditions_complete_rate: % of answers with exclusion dates
Target: freshness under sync_sla and promomis_deflect increasing after active webhook.
PROMOSYNCbot anti-patterns
Five common promo sync errors.
Static promo KB: SHOPIFY-SOURCE webhook mandatory
Weekly manual sync: SYNC-SLA hours not days on sales
Response without conditions: CONDITIONS-COMPLETE minimum date exclusions
Ignore feed #885: PROMOMIS-FEED-LOOP prioritize re-sync
Inventing offer: NO-FAKE-PROMO if index is empty
PROMOSYNCbot with Qstomy
Qstomy on Shopify: webhook discount sync, real-time promo index, PROMOMIS-MAP feed #885, CONDITIONS-COMPLETE templates, KPI promo_sync_bot dashboard.
Scenario: retail sales Day 0, webhook 90 min. promo_sync_bot_freshness 1.5 h, promomis_ tickets -38% in 4 weeks.
Explore AI support and request a demo.
Checklist, FAQ and going further
PROMOSYNCbot Checklist (8 steps)
Sync PROMOMIS-MAP #885: feed promomis_new_campaign code_not_recognized
Policy PROMOSYNCBOT-SUP: 6 rules SHOPIFY-SOURCE SYNC-SLA CONDITIONS
8 intents bot_promo_sync_*: flow PSB-1 to PSB-8
4 templates TPL-PROMOSYNCbot-*: OFFER CODE NONE SYNC-PENDING
Webhook Shopify discounts: create update delete
stale_purge cron: daily NO-EXPIRED-PROMO
Red team launch: go-live without SLA test sync
Dashboard KPI: promo_sync_bot_* section 9 + delta promomis_
FAQ
Difference #885?
#885 = agents process missing promo tickets. #886 = bot sync and serve Shopify offers.
Difference #884?
#886 = dynamic promo catalog. #884 = static KB policies versioning.
What is the sale sync SLA?
sync_sla_hours registry #885. Typical target is 2 to 6 hours on day D.
Automatic promo without code?
active_list + PDP offer_copy. No forced code_lookup.
Going further
This week: activate Shopify discount webhook, configure sync_sla 4 h, test sales code_lookup, measure promo_sync_bot_promomis_deflect.
Enzo
July 1, 2026
