POS集成
连接Square或Clover,让AI将电话订单直接发送到您的POS系统。
概览
POS集成允许AI将电话订单直接发送到您的POS系统。订单出现在Square或Clover中,就像前台下的单一样,您的厨房或员工可以立即准备。
在此访问:ai.i118.com/app/pos
POS集成是可选的。如果您不使用POS或手动处理订单,可以跳过此页面。AI仍然可以接单并通过您配置的通知发送,无需POS连接。
POS集成并非适用于所有组织类型。如果您的组织类型不支持POS,您将看到警告横幅而非连接选项。如果您认为您的子组织应该有POS访问权限,请联系支持。
POS集成通常免费连接。例外:Clover需要Essentials或更高级别的订阅计划。
哪些组织类型支持POS?
POS页面仅适用于 Restaurant 和 Retail 组织类型:
| 组织类型 | POS页面 | 预约页面 | 预约设置位置 |
|---|---|---|---|
| Restaurant | 是 | 否 | 商业信息与指令 + POS页面(连接后) |
| Retail | 是 | 否 | 商业信息与指令 + POS页面(连接后) |
| Contractor | 否 | 是 | 仅预约集成页面 |
| Personal Assistant | 否 | 是 | 仅预约集成页面 |
| Information | 否 | 否 | 不支持预约 |
如果您是Contractor或Personal Assistant类型的子组织,您的侧边栏中不会显示POS页面。您的预约/预订设置在预约集成页面,您可以在那里连接日历提供商(Google Calendar、Outlook或Calendly)。
连接POS提供商
在POS集成页面,您将看到每个支持的提供商的按钮。一次只能连接一个提供商——连接后,另一个提供商的按钮将被禁用。
Restaurant和Retail的预约设置在哪里?
对于Restaurant和Retail子组织,预约/预订设置分布在两个页面:
-
商业信息与指令页面 — 核心开关在这里:
- 允许预订(Restaurant)或允许预约(Retail)
- 收取押金
- 最短提前时间和最大预订窗口 — 这些仅在没有连接支持预约功能的POS提供商时显示在此处
-
POS集成页面(本页面) — 连接POS提供商后:
- 允许预订/允许预约和收取押金开关也会显示在这里
- 如果您的POS提供商支持预约(例如,Square配合Square Appointments),将显示额外的提供商特定设置:服务、团队成员、不限容量和高级设置
- 当Square管理预约(已选择服务+团队成员时),提前时间和预订窗口在此变为只读 — 它们在您的Square商业设置中管理
- 使用Clover或不支持预约功能的Square时,提前时间和预订窗口在此页面仍然可编辑
如果您连接了支持Appointments功能的Square并同时选择了服务和团队成员,最短提前时间和最大预订窗口字段将从商业信息与指令页面消失。它们变为由Square管理的只读值。要更改它们,请前往您的Square商业设置。
连接Square
YouTube 播放质量可能默认较低。必要时点击 ⚙️,手动将清晰度调到 1080p。要切换字幕,请点击 🇨🇨。
点击连接Square
在POS集成页面,点击连接Square按钮。
授权连接
您将被重定向到Square授权页面。登录Square账户并授予访问目录和创建订单的权限。
选择位置
如果您的Square账户有多个位置,将出现下拉菜单让您选择此子组织使用的位置。如果只有一个位置,则自动选择。
同步目录
验证并测试
前往测试,开启启用POS,进行测试下单。检查订单是否出现在Square面板中。
已连接状态
连接成功后,您将看到:
- 绿色已连接到Square横幅
- 重新认证按钮——用于在Square授权过期或需要重新授权时刷新OAuth连接
- 断开连接按钮——完全移除Square连接
如果发生连接错误,将显示描述问题的红色横幅。
关联商店详情
连接后,面板显示您的关联商店信息:
| 字段 | 描述 |
|---|---|
| 提供商 | Square |
| 商户ID | 您的Square商户标识符 |
| 位置ID | 已连接的Square位置。如果有多个位置,下拉菜单允许您切换——切换会触发目录自动重新同步 |
| 名称 | Square账户中的商家名称 |
| 电话 | 注册的电话号码 |
| 地址 | 注册的商家地址 |
| 预约功能 | 显示当前连接位置的是或否。功能按位置而非商户判断——每个位置独立检查。如果显示为否,请在Square预约渠道设置中启用预约渠道。 |
| 货币 | 已连接Square位置的货币代码(例如USD) |
目录同步
AI读取您的Square目录来了解可用商品、价格和修改项。当您更改Square目录(添加商品、更改价格等)时:
- 回到POS集成页面
- 点击同步目录获取最新更改
页面显示上次成功同步的日期和时间。
目录同步不是自动的。每次在Square更新商品后必须手动点击同步目录。如果AI报了旧价格,说明自上次更改以来目录未同步。
连接Square后,您会看到一条提示,提醒您在Square中做出更改后同步目录。同步进行中时请勿关闭或刷新页面。
Square预约设置
如果您的Square计划包含Square Appointments(由预约功能字段指示),并且启用了允许预约选项(餐厅子组织为允许预订),将出现额外的预约配置。
Square Bookings写入操作需要付费的Appointments计划。在当前Square计划中,请使用Square Plus或更高级别并开启高级预订功能。在旧版计划中,请使用Square Appointments Plus或更高级别。
允许预约/允许预订和收取定金选项在连接Square或Clover时出现在POS页面上。餐厅子组织看到"预订"文本;其他组织类型看到"预约"。
服务
选择AI在安排预约时应使用的Square服务。此下拉菜单从您的Square目录(特别是"服务"类型的项目)中填充。
- 如果没有显示服务,请在Square服务面板中创建预约服务。服务必须设置时长、启用在线预订且为免费(POS预约流程不支持收费服务)才能显示。
- 在Square中创建或更新服务后,点击此页面上的刷新获取最新数据
如果之前选择的服务已从Square中删除,将出现警告。如果服务版本已过时(例如您在Square中更改了服务详情),将显示版本警告。点击刷新解决这些警告。
团队成员
选择AI应将预约分配给哪个团队成员。此下拉菜单从您的Square团队中填充。
- 如果没有显示团队成员,请在Square团队面板中添加,并为每个团队成员启用预约权限。
- 在Square中添加成员后,点击此页面上的刷新
无限容量
此选项仅在同时选择了服务和团队成员时出现。启用后,AI不检查团队成员的日历——允许在任何时间段无限预约。
可用性
当选择了服务和团队成员时,预约可用性由Square日历管理。您可以在Square日历设置中配置可用性。
当服务或团队成员未配置时,可用性回退到您在面板中配置的营业时间。
高级设置
展开高级设置折叠面板进行配置:
| 设置 | 描述 |
|---|---|
| 最短提前时间 | 预约需要提前多久预订(例如2小时表示客户不能在未来2小时内预约) |
| 最长预订窗口 | AI可以预订到多远的未来(例如30天) |
当Square管理可用性(已选择服务+团队成员)时,这些值为只读,在Square商家设置中管理。面板显示当前值,但您必须在Square中更改。
当可用性回退到营业时间时,您可以直接在此页面编辑这些值。
连接Clover
Clover需要Essentials或更高级别的订阅计划才能使用此集成。
YouTube 播放质量可能默认较低。必要时点击 ⚙️,手动将清晰度调到 1080p。要切换字幕,请点击 🇨🇨。
点击连接Clover
在POS集成页面,点击连接Clover按钮。
授权连接
您将被重定向到Clover授权页面。登录并授予访问库存和创建订单的权限。
选择商户
如果您有多个Clover商户,选择此子组织的商户。
同步目录
点击同步目录导入您的商品、价格和修改项。
验证并测试
前往测试,开启启用POS,进行测试下单。检查是否出现在Clover设备上。
已连接状态
连接成功后,您将看到与Square相同的绿色横幅、重新认证和断开连接按钮。
关联商店详情
| 字段 | 描述 |
|---|---|
| 提供商 | Clover |
| 商户ID | 您的Clover商户标识符 |
| 名称 | Clover账户中的商家名称 |
| 电话 | 注册的电话号码 |
| 地址 | 注册的商家地址 |
| 预约功能 | 显示您的Clover设置是否支持预约 |
Clover不显示位置ID和货币字段——这些是Square特有的。
目录同步
与Square相同——AI读取您的Clover库存。当您在Clover中修改商品时:
- 回到POS集成页面
- 点击同步目录
目录同步不是自动的。每次Clover库存更改后请手动同步。
Clover预约/预订设置
连接Clover并启用允许预约(餐厅子组织为允许预订)后,AI使用您的营业时间来确定预约可用性——Clover没有自己的预约日历集成。
高级设置
展开高级设置折叠面板进行配置:
| 设置 | 描述 |
|---|---|
| 最短提前时间 | 预约需要提前多久预订 |
| 最长预订窗口 | AI可以预订到多远的未来 |
这些值始终可以在此页面编辑(不同于Square可能在外部管理)。
订单类型
Clover使用订单类型来分类订单(例如堂食、外带、外送)。面板显示您的Clover订单类型表格:
| 列 | 描述 |
|---|---|
| 名称 | 订单类型标签(例如"外带") |
| ID | Clover订单类型标识符 |
| 使用状态 | 显示已使用或未使用——表示此类型是否用于AI订单 |
您可以删除未使用的订单类型,但不能删除某个类别中最后一个正在使用的订单类型。
目录数据查看器
同步后,面板在四个标签页的查看器中显示您的目录数据:
商品
每个商品显示:
| 列 | 描述 |
|---|---|
| 名称 | 商品在POS中的名称 |
| 类型 | 商品(常规产品)或服务(用于Square Appointments) |
| 描述 | POS目录中的商品描述 |
| 分类 | 商品所属的分类 |
| 税费 | 应用于商品的税率 |
| 变体 | 每个变体及其名称和价格(例如"小份($3.50)"、"大份($5.00)") |
| 修改项 | 与商品关联的修改项组 |
选项组
修改项/选项组显示:
| 列 | 描述 |
|---|---|
| 名称 | 组名(例如"配料"、"尺寸") |
| 描述 | 可选的组描述 |
| 关联 | 此组关联到哪些商品 |
| 选项 | 带价格的各选项(例如"加芝士(+$1.50)") |
折扣
| 列 | 描述 |
|---|---|
| 名称 | 折扣名称 |
| 类型 | 折扣类型(百分比、固定金额等) |
| 值 | 折扣金额 |
| 规则 | 折扣生效的条件 |
| 修改税基 | 折扣是否调整应税金额 |
税费
| 列 | 描述 |
|---|---|
| 名称 | 税名称 |
| 税率% | 税率百分比 |
| 描述 | 税描述 |
POS订单工作流程
- 客户告诉AI想要什么
- AI将商品与POS目录匹配
- AI向客户确认订单(复述)
- 确认后,订单发送到Square或Clover
- 您收到包含订单摘要的通知
如果AI无法将商品与目录匹配(拼写错误、不在目录中等),仍会在通知中记录订单——但可能无法向POS发送完整的结构化订单。
常见问题
您的POS目录不同步。前往POS集成并点击同步目录获取最新价格。
- 检查POS集成页面上的连接状态
- 检查订单是否出现在订单中——如果在那里但不在POS中,可能是POS推送失败
- 点击重新认证刷新OAuth凭证,或断开后重新连接
- 如果订单持续无法到达POS,请联系支持
该商品在POS目录中的名称可能与客户使用的名称不同。在商家信息中添加常用替代名称,或在POS中重命名商品以匹配客户的常用叫法,然后同步目录。
同步后,检查POS目录是否正确将修改项组关联到了商品。AI只能提供同步目录中存在的修改项。
服务和团队成员必须先在Square面板中创建才会在此处显示。
- 在Square服务面板中创建服务
- 在Square团队面板中添加团队成员 添加后,点击POS集成页面上的刷新。
这意味着自上次同步以来,Square中的服务详情已更改。点击刷新获取最新的服务和团队成员数据。
您之前选择的服务已从Square中删除。请选择其他服务或在Square服务面板中重新创建,然后点击刷新。
更改Square位置会自动触发完整的目录重新同步。此过程中请勿关闭或刷新页面。
如果连接后出现红色错误横幅,请尝试点击重新认证刷新OAuth凭证。如果错误持续,请断开后重新连接。
Last updated 1 week ago
Built with Documentation.AI