Shopify AI Support

Shopify AI Support 在你的店铺页面上放一个聊天框，用你发布给它的店铺信息回答顾客关于商品、运费、退换的问题。顾客侧不接触你的工作区。

建立一个助手

1. 在 Gatekeepers 页面开通 Shopify AI Support。
2. 打开侧栏 Apps 里的 AI Support，点 New assistant，填写：
   • Name：内部名称，顾客看不到；
   • Store name：助手对外称呼你的店铺时用的名字；
   • Support email：需要转人工时告诉顾客的邮箱；
   • Websites：允许嵌入聊天框的网址。只有这些网址能调用，精确匹配；
   • Daily message limit：每天的消息上限，超过后顾客会看到一句简短的提示。

发布店铺信息

助手只根据你发布的内容回答。在 Store information 里直接编辑，或者点旁边的按钮让智能体从你的网站整理一份草稿（这一步会走对话，智能体写回内容仍然需要你批准）。

写进去的内容建议包括：主营商品与卖点、运费与时效、退换政策、常见问题、联系方式。内容上限约 64 KB。

想让它保持最新，可以建一个定时任务，定期重新整理并发布。

可选：连接商品数据

填写 Shopify store domain 和 Storefront API access token（面向匿名顾客的只读公开令牌），助手就能回答“这个尺码还有货吗”这类问题：每条顾客消息发给模型之前，先按关键词查一次商品，把名称、价格、各规格库存和链接作为参考资料附上。

警告

只能填 Storefront API 的公开令牌。Admin API 的令牌会被拒绝。

开放给顾客

点 Open to shoppers，Gosper 会弹出确认框，写明：使用哪个模型、费用计入谁、每天上限多少、随时可以关闭。确认后才会签发密钥。

然后复制 Embed code，贴进你的店铺主题（或 Hydrogen 店面）：

<script src="https://service.gosper.ai/shopify-ai-support/v1/embed.js" data-key="sas_…" async></script>

这个 key 会出现在页面源码里，本来就是公开的：它只标识是哪个助手，不代表权限。调用还要通过网址白名单、限流和每日配额。

日常管理

• Messages per day：最近 14 天的消息量，以及今天已用多少、多少次落到了兜底回复；
• 替换 key：旧的 key 立即失效，记得同步更新页面上的嵌入代码；
• 停用：立刻停止服务，进行中的会话全部作废。

顾客体验

• 一次会话在 30 分钟无消息后结束，之后再说话会开一个新会话；
• 会话开始时锁定当时的配置和店铺信息，你中途修改不会让进行中的对话前后不一致；
• 遇到配额用尽、模型异常等情况，顾客只看到一句简短的兜底回复，不会看到技术细节。