Marketplace Support — Systems
Lucyd marketplace customer support standard operating procedure (Wow24-7 + Lucyd CS team).
MARKETPLACE SUPPORT SYSTEMS
Lucyd Agentic Operating Division
Project Name: Customer Support — Marketplace Operations Owner: Alex Alexander Backup: TBD (Joaquin to confirm) Last Updated: May 2026
System Inventory
| System | Role in workflow | Primary user | Access provisioned by |
|---|---|---|---|
| Gorgias | Primary ticket platform (new) | All Wow24-7 agents | Alex / Bohdan during transition |
| Amazon Seller Central | Buyer-Seller Messaging, A-to-Z claims, scorecard | Wow24-7 agents (limited role) | Alex |
| Walmart Seller Center | Walmart customer messages, returns, Seller Standards | Wow24-7 agents (limited role) | Alex (provisioning during transition) |
| TikTok Shop Seller Center | TikTok messages, returns, orders | Wow24-7 agents | Alex (provisioning during transition) |
| Meta Business Suite | FB/IG DMs, page comments, Commerce Manager | Wow24-7 agents | Alex |
| Shopify (admin) | Order lookup only | Wow24-7 agents (read-only) | Alex |
| ShipStation | Warranty replacement fulfillment | Wow24-7 agents | Alex |
| Intercom (legacy) | Lucyd.co direct chat during transition | Wow24-7 agents | Existing access |
| Coda KB | Knowledge base reference | All | Read access |
| Slack | Internal escalation channel | All | Existing |
1. Gorgias (Primary Platform)
Purpose
Gorgias becomes the single pane of glass for all marketplace tickets. It integrates natively with Amazon, TikTok Shop, Meta, and Shopify — pulling messages from each into one queue.
Channels to configure during transition
| Channel | Integration type | Status |
|---|---|---|
| Amazon Buyer-Seller Messaging | Native Gorgias integration (via Amazon Seller Central credentials) | To be configured by Alex |
| Walmart Marketplace | Native if available in 2026, else email forwarding from @relay.walmart.com | To be configured by Alex |
| TikTok Shop | Native or via API; check Gorgias support docs | To be configured |
| Facebook Messenger | Native Gorgias integration via Meta Business Suite | To be configured |
| Instagram DM | Native via Meta Business Suite | To be configured |
| Shopify | Native (for order lookup) | To be configured |
| Email (info@lucyd.co) | SMTP/IMAP, forward existing | Existing |
Required Tags / Custom Fields
Every marketplace ticket must carry these tags. This is non-negotiable — it’s how we measure the program.
| Tag / Field | Values | Required |
|---|---|---|
Platform | Amazon / Walmart / TikTok / Meta-FB / Meta-IG / Shopify | Yes — set at intake |
Channel | Buyer-Seller-Msg / Walmart-Seller-Msg / Direct-Email / In-App-Msg / DM / Comment | Yes |
Issue | Warranty / Refund / Shipping / Rx / Product-Q / Spam / Other | Yes — set before close |
SKU | Free text — main SKU referenced | If applicable |
Wow24-7 Agent | Free text — agent name | Yes |
Escalated | Yes / No | Set if escalated |
Triage Rules (to be configured in Gorgias)
- Amazon Seller News auto-route — anything from
seller-notifications@amazon.com→ route to “Lucyd Ops” folder, do NOT show in Wow24-7 queue. - Order/refund confirmations auto-close — Amazon “Refund initiated” / “Order shipped” / “Buyer left feedback” → auto-close, archive.
- Phishing flag — any DM containing “policy violation” + “submit appeal” → flag as spam, do not engage.
- Creator pitch auto-respond — IG/FB DMs matching creator-pitch regex → auto-reply with template T-7, close.
- Macro library — load all templates from
TEMPLATES.mdas Gorgias macros, named with prefixMKT-(e.g.,MKT-Warranty-Intake).
Reporting Views
| View | Filter | Purpose |
|---|---|---|
| Marketplace Queue | Platform IN (Amazon, Walmart, TikTok, Meta-FB, Meta-IG) | Wow24-7’s primary view |
| Amazon Aging | Platform=Amazon + status=open + created_at < 20 hrs | Catch tickets approaching the 24-hr Amazon SLA |
| Walmart Aging | Platform=Walmart + status=open + created_at < 40 hrs | Catch tickets approaching the ~48-hr Walmart SLA (verify) |
| Hybrid Rx | Issue=Rx + Platform=Amazon | Internal review queue |
| Escalations | Escalated=Yes | Alex’s daily review |
Common Pitfalls
- Replying in Gorgias only for Amazon Buyer-Seller tickets — this is the #1 mistake. The reply must go through Seller Central; Gorgias gets the mirror as an internal note. Train agents in week 1 of cutover.
- Forgetting to set the Platform tag — without this, the entire reporting layer is blind. Make it a required field at the workflow level.
- Closing tickets without setting Issue category — kills our ability to measure category mix.
2. Amazon Seller Central
Purpose
Native channel for Buyer-Seller Messaging, A-to-Z claim management, FBA/MCF return tracking, and seller scorecard monitoring.
URL
https://sellercentral.amazon.com
Navigation Guide
| Task | Path |
|---|---|
| Reply to a buyer message | Messages → Buyer-Seller Messages → [select message] → Reply |
| View an order | Orders → Manage Orders → search by order ID 111-XXXXXXX-XXXXXXX |
| Issue a refund | Orders → [select order] → Refund order (only when policy allows) |
| Respond to A-to-Z claim | Performance → A-to-Z Guarantee Claims |
| Check scorecard | Performance → Account Health |
| FBA return status | Orders → Manage FBA Returns |
24-Hour Response SLA
Amazon expects sellers to respond to buyer messages within 24 hours. The clock starts when the message lands in Seller Central. Gorgias replies do not stop this clock — only Seller Central replies do.
A-to-Z Claim Handling
- Notification arrives via email and in Seller Central.
- Escalate to Alex within 4 hours. A-to-Z claims affect ODR.
- Gather: order ID, customer message, our prior responses, shipment tracking, any video provided.
- Respond in Seller Central with the full record — Amazon’s decision is based on documentation quality.
- Log the outcome in
DECISIONS.mdso we build institutional pattern-recognition.
FBA vs. Seller-Fulfilled Returns
| Order type | Return handling |
|---|---|
| FBA (Fulfilled by Amazon) | Amazon receives the return, processes refund automatically. Lucyd may never see the unit. Agent role: customer service only. |
| Seller-fulfilled (FBM) | Customer returns to Lucyd Miami warehouse. Lucyd processes refund. Agent role: provide return label, track inbound. |
| Amazon-fulfilled Rx hybrid | Frame returned to Amazon (if FBA), but lens defect handled separately by Lucyd. See PROCESSES.md §6. |
Common Pitfalls
- Treating an FBA return as if Lucyd is shipping the label (Amazon handles it — agent just confirms with customer).
- Missing the 24-hr SLA because the team replied in Gorgias only.
- Not documenting A-to-Z claim responses in our records (only lives in Seller Central — we should mirror to Gorgias).
2.5 Walmart Seller Center
Purpose
Native channel for Walmart Marketplace customer messages, returns, performance dashboards, and Seller Standards monitoring. Walmart was confirmed in scope on May 21, 2026 (DECISIONS.md D-9.5).
URL
Navigation Guide
| Task | Path |
|---|---|
| Reply to a customer message | Customer Service → Customer Cases or Messages |
| View an order | Orders → Manage Orders → search by purchase order ID |
| Issue a refund | Orders → [select order] → Issue Refund (only when policy allows) |
| Respond to a Marketplace Safety Claim | Performance → Customer Complaints / Marketplace Safety |
| Check scorecard | Performance → Seller Scorecard |
| Process a return | Orders → Returns (or Customer Service → Returns) |
~48-Hour Response SLA (verify currency)
Walmart’s published guidance is Customer Contact Response Rate within 48 hours. Verify against the current Seller Center dashboard before relying on this number — Walmart adjusts SLAs periodically. The clock starts when the message arrives in Seller Center, not when it lands in Gorgias.
Marketplace Safety Claim Handling
- Notification arrives via email and in Seller Center.
- Escalate to Alex within 4 hours (parallel to Amazon A-to-Z handling).
- Gather: purchase order ID, customer message, our prior responses, shipment tracking, any video provided.
- Respond in Seller Center with the full record — Walmart’s decision is documentation-driven.
- Log the outcome in
DECISIONS.mdso we build pattern recognition.
WFS vs. Seller-Fulfilled Returns
| Order type | Return handling |
|---|---|
| WFS (Walmart Fulfillment Services) | Walmart receives the return, processes refund. Agent role: customer service only. |
| Seller-fulfilled | Customer returns to Lucyd Miami warehouse. Lucyd processes refund. Agent role: provide return label, track inbound. |
Common Pitfalls
- Treating a WFS return as if Lucyd is shipping the label (Walmart handles it).
- Missing the 48-hr SLA because the team replied in Gorgias only.
- Not documenting Marketplace Safety Claim responses in our records (only lives in Seller Center — mirror to Gorgias).
Known unknowns (verify during transition)
- Exact 2026 Walmart return window (default assumption: 30 days)
- Whether Gorgias has a native Walmart Marketplace integration in 2026
- Whether the Customer Contact Response SLA is 48 hours or has been adjusted
3. TikTok Shop Seller Center
Purpose
Native messaging, order management, returns, and policy notices for TikTok Shop.
URL
Status
Provisioning in progress as part of the Wow24-7 transition. Until access is live, route all TikTok inquiries to Alex.
Navigation Guide (preliminary)
| Task | Path |
|---|---|
| Reply to customer message | Messages → Inbox |
| View an order | Orders → All Orders |
| Process return | Orders → After-sales / Returns |
| Check seller health | Seller Center → Performance |
Known Unknowns (research items)
The following need to be answered before the team handles the first TikTok ticket:
- What is TikTok Shop’s standard return window? (Default: ~14 days, but verify)
- Does TikTok process refunds, or does the seller?
- What are the policy strikes that affect seller rating?
- Does TikTok integrate with Gorgias natively, or via API?
- Are TikTok Shop orders syncing to Shopify, or living solely in Seller Center?
Owner: Alex to confirm during transition setup.
Common Pitfalls
- Applying Amazon’s policies to TikTok by default. They differ. When in doubt, escalate.
4. Meta Business Suite
Purpose
DMs from Facebook and Instagram (and IG story mentions), comments on Lucyd’s posts, and Meta Commerce Manager for any in-platform purchases.
URL
Navigation Guide
| Task | Path |
|---|---|
| Reply to FB/IG DMs | Inbox (left rail) → filter by Facebook or Instagram |
| View Commerce Manager (FB/IG Shop orders) | Commerce → Orders |
| Respond to post comments | Inbox → Comments |
| Check shop policy compliance | Commerce → Policies |
Integration with Gorgias
Gorgias pulls FB/IG DMs into the ticket queue. Agent replies in Gorgias post back to Meta. For comments on public posts, agent may need to reply directly in Meta Business Suite if Gorgias doesn’t surface comments.
Lucyd’s actual Meta order volume
Effectively zero in-platform Meta purchases historically — Meta checkout redirects to lucyd.co for most products. Tickets referencing “I bought on Instagram” almost always map to a Shopify order. Confirm by asking for the order # (#1XXXX).
Common Pitfalls
- Treating an IG story mention as a support ticket — it’s usually a thank-you. Acknowledge and close.
- Replying to a phishing DM (“policy violation, submit appeal”) — those are scams. Do not click links.
- Engaging with creator pitches as if they were customer issues — they’re Marketing’s problem.
5. Shopify (Read-Only)
Purpose
Order lookup for cross-channel verification, especially for the Rx hybrid case.
URL
https://admin.shopify.com/store/innovativeeyewear
What agents use it for
- Looking up
#1XXXXorders when customer references Meta or generic “I bought on your site” - Verifying Rx fulfillment status for Amazon-hybrid orders
- Checking customer email and shipping history
What agents do NOT do in Shopify
- Issue refunds (refunds for marketplace orders must happen on the originating platform)
- Cancel orders
- Modify customer records
Common Pitfalls
- Issuing a refund in Shopify for an Amazon order. Don’t. The money is held by Amazon. Shopify refund = double-counted accounting error.
6. ShipStation
Purpose
Generate shipping labels for warranty replacements going out from Lucyd Miami.
Access
Existing Wow24-7 access continues. Use existing warranty replacement workflow — no marketplace-specific change required for the shipping side.
Common Pitfalls
- Selecting the wrong return address for marketplace ships (use Lucyd Miami, NOT Amazon’s FBA warehouse).
- Forgetting to attach tracking back to the Gorgias ticket.
7. Intercom (Legacy — Transitional)
Purpose
Continues to handle Lucyd.co chat widget and direct emails during the transition. Marketplace tickets that incorrectly land in Intercom should be forwarded to Gorgias.
Cutover plan
Per Bohdan’s email, transition plan finalized by middle of next week. Until cutover is complete, Wow24-7 agents may need both tools open.
Common Pitfalls
- Duplicating responses across Intercom + Gorgias. Each ticket should live in exactly one system.
8. Knowledge Base — help.lucyd.co/internal
Purpose
Source-of-truth knowledge base for Lucyd CS. As of Phase 1 (May 2026), the KB has moved from Coda to help.lucyd.co/internal/* (Cloudflare Access-gated, allowed identities: @lucyd.co + Wow24-7 emails). Public customer-facing content lives at help.lucyd.co/.
URL
- Internal (this team): https://help.lucyd.co/internal
- Public (customers): https://help.lucyd.co
- Legacy (read-only fallback during 90-day transition): https://coda.io/d/Lucyd-Customer-Service-Knowledge-Base_doz6raLzwOv
Relevant pages for marketplace work (Phase 1 destinations — placeholders until rebuild completes)
| Topic | Internal page | Public page |
|---|---|---|
| Marketplace returns rules (no $15 fee) | /internal/decisions/d-2-no-restocking-on-marketplaces | /returns/marketplace-returns |
| Amazon support | /internal/sop/marketplace/PROCESSES#amazon | /marketplaces/amazon |
| Walmart support | /internal/sop/marketplace/PROCESSES#walmart | /marketplaces/walmart |
| TikTok Shop support | /internal/sop/marketplace/PROCESSES#tiktok | /marketplaces/tiktok-shop |
| Meta DM support | /internal/sop/marketplace/PROCESSES#meta | /marketplaces/meta-fb-ig |
| Warranty (1-year defects) | /internal/decisions/d-3-warranty-beyond-marketplace-window | /warranty |
| Rx / lens options | TBD (internal Rx playbook page) | /rx-prescription |
| Bluetooth troubleshooting | TBD | /troubleshooting |
Gap (now being addressed)
The legacy Coda KB does NOT contain pages for Walmart, TikTok Shop, or Meta — and the Return Policy article does NOT explicitly carve out marketplace orders (contradicts D-2). These gaps are being closed by the Workstream C rebuild. Until the new pages are live, agents must reference the SOP files (PROCESSES.md / DECISIONS.md) directly, NOT the legacy Coda articles.
9. Slack
Purpose
Internal escalation channel between Wow24-7 and Lucyd.
Channels
#cs-escalations— Alex tagged for all escalations#wow24-transition— Bohdan’s working channel during cutover#cs-amazon-claims— A-to-Z claim coordination (to be created)
Common Pitfalls
- Escalating in DM instead of the channel — breaks the audit trail.
System Access Matrix
| Agent role | Gorgias | Amazon Seller | Walmart Seller | TikTok Seller | Meta Biz Suite | Shopify | ShipStation | Intercom | KB (help.lucyd.co/internal) |
|---|---|---|---|---|---|---|---|---|---|
| Wow24-7 Agent (Tier 1) | Full | Limited (Buyer-Seller, view scorecard) | Limited (Messages, Orders, scorecard) | Limited (Inbox, Orders) | Full DM | Read-only | Full | Full | Read |
| Wow24-7 Lead | Full | Limited + A-to-Z view | Limited + Safety Claim view | Full | Full | Read-only | Full | Full | Read |
| Lucyd CS Manager (Alex) | Admin | Admin | Admin | Admin | Admin | Read-only | Admin | Admin | Edit (CODEOWNERS for public/) |
| Lucyd Ops (Alex) | Admin | Admin | Admin | Admin | Admin | Limited Edit | Admin | Admin | Edit (CODEOWNERS for public/) |
Documentation maintained by Alex Alexander Last updated: May 2026