Skip to main content

​
适用场景

Phone Number QR 码会打开设备的拨号盘，并预先填好号码，因此扫描它就是致电某个企业、支持热线或联系人的一键式方式。它是一种 Quick Code——一种没有落地页的直接动作型 QR。
在应用中，此类型的卡片和页面标题写的是 “Phone Call”，而不是 “Phone Number”——但底层类别（以及本页）仍称其为 Phone Number，这与 /qr/category/ API 端点为该类别返回的 name 一致。
Phone Number 仅支持 Static——此类型没有 Dynamic 选项。一旦发布，编码后的号码将无法编辑或追踪；如需更改，请创建一个新的 QR 码。

​
创建一个 Phone Number QR 码

1

打开 Create QR Code 并选择 Quick Code

在侧边栏中，进入 QR Codes，然后点击 Create QR Code（或前往 /qr/create）。点击 Quick Code 卡片。
2

选择 Phone Call

在 Quick Code 类型网格中，点击 Static Only 分区下 Phone Call 下方的 Configure——那里的描述是 “Open the dialer pre-filled with your number.”（打开拨号盘，预先填好您的号码）。这会打开 /qr/quick/phone 处的表单。
3

输入电话号码

在唯一的 Phone number 字段中输入号码（占位符：+1 415 555 0100）。这是表单上唯一的字段，也是发布所必需的。该字段会在失焦时进行校验：它接受数字、空格、括号、连字符，以及可选的前导 +，总位数需在 6 到 15 位之间（与 E.164 的最大长度一致）。像 123 这样的输入会触发错误 “Please enter a valid phone number.”（请输入有效的电话号码）。
Phone Call Quick Code 表单，电话号码字段的值为 123，被高亮标红，下方显示错误信息 Please enter a valid phone number

一个无效电话号码，展示内联校验错误

Phone Call Quick Code 表单，电话号码字段填写了 +1 415 555 0142，右侧展示实时 QR 预览

已填写有效号码的 Phone Call Quick Code 表单

4

发布

点击 Publish。会弹出一个面板，用于确认或重命名 QR 码（默认使用 “Call <number>”）、分配文件夹或标签，并在确认前调整 QR 码设计。

​
通过 API 创建

若要通过 API 而非界面创建 Phone Number QR 码，请使用类别 ID 4（标记为 Phone Number，allowed_qr_types: "st"——qr_type 只能取 "st"），其 info 负载结构如下：
后端会接受 number 字段的任意字符串（服务端不进行格式校验）——上文描述的电话格式校验只在客户端进行，目的是确保扫描设备能够真正拨打出结果号码。完整的请求结构请参见 Create QR Code。
Category List 参考表目前尚未列出 Phone Number（以及本页其他仅限 Quick Code 的类别）——上述 ID 是直接对照实际的 /qr/category/ 端点确认得到的。

​
相关内容