---
title: "快捷回复变量"
description: "快捷回复可以携带的每一个变量：需要写出的确切令牌、它会被什么内容替换，以及当 AFP 无法解析出这个值的时候会发生什么情况。"
canonical: https://docs.afp.monster/zh-cn/reference/quick-reply-variables
updated: 2026-08-19
pageType: reference
---

一共有七个变量，分为三组。当快捷回复被套用到一个会话上时，它们会被替换，使用的是该会话的联系人、该会话的主页，以及套用它的那个人。找不到值的变量会被替换为空字符串，只有下面提到的一个例外。任何情况下都不会抛出错误。变量区分大小写，必须完全按所示书写。

## 概览

| 变量 | 组 | 替换为 |
|---|---|---|
| `#{FULL_NAME}` | Customer | 联系人的全名 |
| `#{FIRST_NAME}` | Customer | 联系人的名 |
| `#{LAST_NAME}` | Customer | 联系人的姓 |
| `#{PAGE_NAME}` | Connection | 该会话所属主页的名称 |
| `#{STAFF_NAME}` | User | 套用该快捷回复的人的全名 |
| `#{STAFF_FIRST_NAME}` | User | 他的名 |
| `#{STAFF_LAST_NAME}` | User | 他的姓 |

## `#{FULL_NAME}`

- **组：** Customer
- **替换为：** 联系人的全名
- **未知时：** 空

```text
Hi #{FULL_NAME}, thanks for getting in touch.
```

## `#{FIRST_NAME}`

- **组：** Customer
- **替换为：** 联系人的名
- **未知时：** 空

## `#{LAST_NAME}`

- **组：** Customer
- **替换为：** 联系人的姓
- **未知时：** 空

## `#{PAGE_NAME}`

- **组：** Connection
- **替换为：** 该会话所属主页的名称
- **未知时：** 变量按原样保留

```text
Thanks for messaging #{PAGE_NAME}. We reply within one business day.
```

## `#{STAFF_NAME}`

- **组：** User
- **替换为：** 套用该快捷回复的人的全名
- **未知时：** 空

对于用电子邮件登录、未附加任何 Facebook 社交账号的账户，使用该账户自己的全名。

## `#{STAFF_FIRST_NAME}`

- **组：** User
- **替换为：** 套用该快捷回复的人的名
- **未知时：** 空

对于仅用邮箱的账户，使用该账户全名的第一个词。

## `#{STAFF_LAST_NAME}`

- **组：** User
- **替换为：** 套用该快捷回复的人的姓
- **未知时：** 空

对于仅用邮箱的账户，使用该账户全名第一个词之后的全部内容。

## 备注

- 替换发生在快捷回复被套用时，而不是保存时，所以同一段已保存的文本在每个会话里个性化的结果都不同。
- 一条消息中某个变量的每一处出现都会被替换，而不只是第一处。
- 解析某个值时出错不会让整条回复失败。编辑框会填入截至那一刻已替换好的内容，所以草稿里出现未被替换的令牌，说明有一次查找没有完成。
- 快捷回复表单中的变量选择器会显示一个 **Choose time** 组。它不包含任何变量。
- **性别变量即将推出。** AFP 目前还不记录联系人的性别，所以随性别变化的短语暂时不是快捷回复能做到的事。
- 这些变量在其他任何地方都不可用。活动的消息节点有自己的配置；参见 [节点类型](/zh-cn/reference/node-types)。

## 相关

- [保存并重复使用回复](/zh-cn/guides/quick-replies) — 创建和使用快捷回复。
- [联系人字段](/zh-cn/reference/contact-fields) — 客户姓名和性别来自哪里。
- [在收件箱中处理会话](/zh-cn/guides/inbox) — 套用它们的编辑框。