# 通过链接自动填写表单（prefill URL）

> 在付款表单链接中加入产品、数量和顾客资料，让表单打开时已经填好这些内容。
>
> Source: https://docs.bcl.my/zh/prefill-form-link/

预填链接就是在表单链接后面加上额外资料。表单打开时，这些资料已经填好。用它把顾客从你的网站、购物车或WhatsApp消息带到表单，顾客只需要付款。

例如，这个链接会选好2个某产品和1个另一产品，也会填好姓名、电话和电邮：

```
https://yourshop.bcl.my/form/your-form?qty_90=2&qty_91=1&name=Aisyah%20Rahman&phone=0123456789&email=aisyah@example.com
```

*(Screenshot: 通过预填链接打开的付款表单：House Blend 250g数量2，Sabah Single Origin 250g数量1，姓名、手机号码和电邮已填好)*

## 制作预填链接

1. 复制你的表单链接，例如`https://yourshop.bcl.my/form/your-form`。
2. 在链接后面输入`?`。
3. 以`name=value`的格式加入每项资料。两项资料之间加上`&`。
4. 在浏览器打开链接，检查表单。

空格写成`%20`，`@`写成`%40`。大部分浏览器和电子表格工具会自动转换。

## 可以填写的资料

| 参数 | 填写的内容 | 例子 |
|---|---|---|
| `qty_` + 产品ID | 产品数量 | `qty_90=2` |
| `name` | **Name** | `name=Aisyah%20Rahman` |
| `phone` | **Mobile Number** | `phone=0123456789` |
| `email` | **Email** | `email=aisyah%40example.com` |
| `address1`、`address2` | **Address Line 1**和**Address Line 2** | `address1=12%20Jalan%20Mawar` |
| `city`、`postcode` | **City**和**Postal Code** | `city=Shah%20Alam&postcode=40000` |
| `state` | **State** | `state=Selangor` |
| `country` | **Country**，使用2个字母的代码 | `country=MY` |
| `coupon` | 优惠券代码 | `coupon=RAYA10` |
| `amount` | 金额，适用于由顾客自行输入金额的表单 | `amount=50` |
| 自定义栏位的**Label ID** | 该自定义栏位 | `company_name=Kopi%20Kampung` |

地址资料只适用于开启了**Enable Address Field**的表单。顾客无法更改链接带来的金额。

## 找到产品ID

`qty_`参数需要产品ID。它只适用于**Multiple Items**表单，而且只适用于表单上有数量框的产品。要找到ID：

1. 打开表单，向下滚动到标签页下方的**List of Items**。
2. 点击产品的**More**。

   *(Screenshot: List of Items，第一个产品的More按钮已标示)*

3. 查看面板标题中`#`后面的数字，例如**House Blend 250g Settings (#87)**。这个产品就用`qty_87`。

   *(Screenshot: 产品面板标题显示产品ID 87)*

## 找到自定义栏位的Label ID

打开表单，点击**Custom Field Form**标签页。点击该栏位。**Label ID**显示在栏位标签下方，例如**Label ID: company_name**。把它用作参数名称。复选框栏位的多个选项之间用逗号隔开。

## 锁定链接填写的资料

按照以下步骤锁定链接填好的资料。锁定后，顾客无法更改这些资料：

1. 打开表单，点击**Form Configuration**标签页。
2. 在**Customer Information**下，开启**Lock Autofilled Fields**。

   *(Screenshot: Customer Information框，Lock Autofilled Fields开关已标示)*

3. 点击**Update Form**。

锁定适用于链接填写的顾客资料和自定义栏位。顾客仍然可以更改产品数量。

## 提示

- **分享前先测试每个链接。** 在浏览器的无痕窗口打开链接，检查产品和总额。
- **保护顾客资料。** 公开链接会向所有人显示里面的资料。

## 常见问题

### 表单可以自动选好顾客在我网站购物车里选的产品吗？

可以。为每个产品在表单链接加上qty_和产品ID，例如?qty_90=2&qty_91=1。表单打开时会选好2个产品90和1个产品91。要找到产品ID，打开表单，点击产品的More，查看面板标题中#后面的数字。

### BCL支持prefill URL参数吗？

支持。付款表单链接接受name、email、phone、地址、coupon、产品数量和你的自定义栏位。例如，?name=Aisyah%20Rahman&email=aisyah@example.com会填写姓名和电邮。

### 如何阻止顾客更改链接填好的资料？

打开表单，点击Form Configuration标签页。在Customer Information下，开启Lock Autofilled Fields，然后点击Update Form。之后，顾客就无法更改链接填好的资料。产品数量仍然可以更改。
