> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Phone Number QR Code
> 创建一个可拨打电话号码的 QR 码。
## 适用场景
Phone Number QR 码会打开设备的拨号盘，并预先填好号码，因此扫描它就是致电某个企业、支持热线或联系人的一键式方式。它是一种 **Quick Code**——一种没有落地页的直接动作型 QR。
在应用中，此类型的卡片和页面标题写的是 **"Phone Call"**，而不是 "Phone Number"——但底层类别（以及本页）仍称其为 Phone Number，这与 `/qr/category/` API 端点为该类别返回的 `name` 一致。
Phone Number **仅支持 Static**——此类型没有 Dynamic 选项。一旦发布，编码后的号码将无法编辑或追踪；如需更改，请创建一个新的 QR 码。
## 创建一个 Phone Number QR 码
在侧边栏中，进入 **QR Codes**，然后点击 **Create QR Code**（或前往 `/qr/create`）。点击 **Quick Code** 卡片。
在 **Quick Code** 类型网格中，点击 **Static Only** 分区下 **Phone Call** 下方的 **Configure**——那里的描述是 "Open the dialer pre-filled with your number."（打开拨号盘，预先填好您的号码）。这会打开 `/qr/quick/phone` 处的表单。
在唯一的 **Phone number** 字段中输入号码（占位符：`+1 415 555 0100`）。这是表单上唯一的字段，也是发布所必需的。
该字段会在失焦时进行校验：它接受数字、空格、括号、连字符，以及可选的前导 `+`，总位数需在 6 到 15 位之间（与 E.164 的最大长度一致）。像 `123` 这样的输入会触发错误 **"Please enter a valid phone number."**（请输入有效的电话号码）。
点击 **Publish**。会弹出一个面板，用于确认或重命名 QR 码（默认使用 "Call \"）、分配文件夹或标签，并在确认前调整 QR 码设计。
## 通过 API 创建
若要通过 API 而非界面创建 Phone Number QR 码，请使用类别 ID `4`（标记为 **Phone Number**，`allowed_qr_types: "st"`——`qr_type` 只能取 `"st"`），其 `info` 负载结构如下：
```json theme={null}
{
"type": "phoneNumber",
"data": {
"number": "+14155550142"
}
}
```
后端会接受 `number` 字段的任意字符串（服务端不进行格式校验）——上文描述的电话格式校验只在客户端进行，目的是确保扫描设备能够真正拨打出结果号码。完整的请求结构请参见 [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)。
[Category List](/v1/api-reference/references/category-list) 参考表目前尚未列出 Phone Number（以及本页其他仅限 Quick Code 的类别）——上述 ID 是直接对照实际的 `/qr/category/` 端点确认得到的。
## 相关内容
* [Text Message QR Code](/zh/qr-codes/create/text-message) —— 使用相同的电话号码校验逻辑，预填的是短信而非通话。
* [创建您的第一个 QR 码](/zh/getting-started/first-qr-code) —— 完整介绍此类型所属的 Quick Code 流程。
* [文件夹、标签与批量操作](/zh/qr-codes/manage/folders-tags-bulk-operations) —— 发布后整理该 QR 码。