---
description: 学习如何在多种用例中使用自定义 Dialogflow 参数。
title: 对话流: 参数
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[新的🔥 抢先尝试 WhatsApp Business Calling API（开放测试版）！![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](/zh/whatsapp-business-calling-api)

帮助我... ⌘ 

1. [All Collections >](/zh/help)
2. [ 集成 >](/zh/help/integrations)
3. [ 对话流 >](/zh/help/dialogflow)
4. 对话流: 参数

# 对话流: 参数

![Avatar](https://assets2-proxy.respond.io/ph8r57dk1q9w/4IHLTWbmWN0uXBc5x4jthC/59252fcdb357304ce07be76043047b7a/Susan_Swier_Avatar.svg)

Susan Swier

· 04 Apr 2025

11 分钟

Respond.io 使用自定义 Dialogflow 参数来增强应用程序的功能，以满足多种使用情况。

在对话框中，参数通常用于在用户对实体的响应中连接单词和短语。 因此，如果有人说 "我的生日是 3 月 13 日，" 那么短语 "3 月 13 日" 将被自动检测并视为日期实体。 您可以在 [Dialogflow 的文档页面](https://cloud.google.com/dialogflow/es/docs/intents-actions-parameters)上阅读有关其中参数的更多信息。

通过回复.io平台，您可以使用参数来覆盖更多的情况。 您可以使用它们来保存和收集您的联系人提供的信息 例如： [分配动态标签](https://respond.io/zh/help/dialogflow/dialogflow-parameters#tagging), [设置自定义字段](https://respond.io/zh/help/dialogflow/dialogflow-parameters#contact%5Ffields%5Fand%5Fvalues)。 当联系人需要帮助时，您甚至可以 [通知支持代表](https://respond.io/zh/help/dialogflow/dialogflow-parameters#sending%5Fcustom%5Fnotifications) 。 您还可以使用 respond.io 平台 [存储并轻松管理您的意图响应](https://respond.io/zh/help/dialogflow/dialogflow-parameters#snippets)。

当您使用响应.io平台和对话流意向参数时，可以实现很多目标。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/aHN2vduQKM2TMwAHSNpmc/b30534d10f14cacc767598b21c2a8244/dialogflow-parameters-overview.png?fm=avif&w=1000) 

## 参数引用

您可以在对话流程中使用的参数列表与回复.io平台进行通信。

| 参数名称                 | 值                 | 描述                                                             |
| -------------------- | ----------------- | -------------------------------------------------------------- |
| RB\_ADDTAGS          | 标签1, \[标签2, ...\] | 在回复.io平台上将指定的标签添加到联系人资料                                        |
| ​RB\_REMOVETAGS​     | 标签1, \[标签2, ...\] | 从回复.io平台上的联系人配置文件中删除指定的标签                                      |
| ​RB\_BOTSTATUS​      | false             | 关闭指定联系人的机器人。 在你想要把对话从机器人传递给一个人的情况下，这是有用的。                      |
| ​RB\_MARKDONE​       | true/false        | 打开或关闭联系人的会话。 这对于支持工作非常有帮助。 为仍在等待某事的联系人打开会话，而关闭会话则意味着已经参加过的联系人。 |
| RB\_NOTIFY           | 消息通知              | 在回复.io平台上向人类发送通知，并附上通知信息                                       |
| RB\_SUBSCRBER        | true/false        | 订阅或取消订阅联系人。 取消订阅的联系人将不会收到广播消息。                                 |
| RB\_FIELD\_FIRSTNAME | 值                 | 填写联系人配置文件的名字字段指定值                                              |
| RB\_FIELD\_LASTNAME  | 值                 | 填写联系人配置文件的姓氏字段的指定值                                             |
| RB\_FIELD\_FULNAME   | 值                 | 填写联系人配置文件全名字段的指定值                                              |
| RB\_FIELD\_EMAIL     | 值                 | 填写联系人配置文件的电子邮件地址字段的指定值                                         |
| RB\_FIELD\_PHONE     | 值                 | 填充联系人配置文件中的电话号码字段的指定值                                          |
| RB\_FIELD\_LANGUAGE  | 值                 | 填充联系人配置文件中的语言字段指定的值，例如 en-us                                   |
| RB\_FIELD\_\[NAME\]  | 值                 | 将自定义字段添加到联系人配置文件中，并指定值。 这最好用于非动态信息，例如电子邮件、生日等。                 |
| RB\_REMOVEFIELDS     | 字段1, \[字段2, ...\] | 从平台上的联系人中删除指定的自定义字段                                            |
| RB\_USER\_ASSIGN     | 值                 | 将联系人分配给您团队中的一个用户                                               |
| RB\_SNIPTE           | 代码片段ID            | 将指定的代码片段发送给联系人                                                 |
| RB\_FILE             | 文件ID              | 将存储在平台上的指定文件发送给联系人                                             |

## 标签

联系人的信息可以以标签形式存储。 标签可以在 [联系人模块](https://respond.io/zh/help/contacts) 或 [收件箱模块](https://respond.io/zh/help/messages) 中手动添加/删除，使用 [工作流](https://respond.io/zh/help/workflows/workflows-overview) 程序添加/删除，并在 Dialogflow 意图中通过参数添加/删除。

> **重要：** 标签用于广播中的听众分割。 当使用对话框流意图添加/删除标签时，请记住这一点。

### 使用标签参数

#### 添加标签

使用 `RB_ADDTAGS` 参数，您可以为联系人分配标签。 标签将根据参数值添加到联系人中。 您可以通过用逗号分隔多个标签来添加标签。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/6wmaw5CI93y8AS7QAd8fyc/71ec2f1fc55a749fa60d3c0712cf6b1f/dialogflow-parameters-tags-1.png?fm=avif&w=1000) 

> 注意标签名称不能包含空格。 你可能想要使用下划线。

### 移除标签

使用 `RB_REMOVETAGS` 参数，您可以从联系人中删除一个标签。 标签将根据参数值添加到联系人中。 您可以通过用逗号分隔多个标签来删除标签。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/WDxk85FXIcgTQyUJyhIUL/6906265f060013253ae7ca840f0e6e60/dialogflow-parameters-tags-2.png?fm=avif&w=1000) 

### 最佳做法

在创建新标签时，最好定义简短但含义明确的名称，以便于识别。 理想的情况是，您希望其他人能够理解与用户相关联的标签。

使用实体填充栏位，您可以选择动态创建新标签。 然而，没有人建议这样做，因为它将很快导致标签污染。

减少标签污染， 试着不要过于具体或过于宽松的标签，以便将标签数量保持在最低水平。

当使用标签跟踪用户的主题兴趣时，您可以在多个意图中使用同一个标签，它们具有相同的主题。 这可以帮助识别用户的特定兴趣或关切，并减少标签污染。

## 关闭Bot

Dialogflow Bot 可以从 [收件箱模块](https://respond.io/zh/help/messages/messages-overview#how%5Fdo%5Fi%5Fturn%5Foff%5Fthe%5Fdialogflow%5Fbot) 手动打开/关闭，也可以使用 [工作流](https://respond.io/zh/help/workflows/workflows-overview#how%5Fdo%5Fi%5Fturn%5Foff%5Fthe%5Fdialogflow%5Fbot)自动打开/关闭。 除此之外，还可以使用对话流意图中的参数关闭机器人。

使用 Dialogflow 意图关闭联系人 Bot 状态可用于在您的工作流中创建人工转接。

当联系人禁用机器人时，没有消息传递到对话流。 禁用 Bot 的联系人将出现在平台的[仪表板](https://respond.io/zh/help/dashboard-reporting/dashboard#contacts)的未分配部分下。

### 使用Bot状态参数

使用 `RB_BOTSTATUS`，您可以通过将值设置为 `false`来关闭特定用户的机器人。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2GqHIHyIRqXg7FWQm0yuwB/052c6b0eee667ae39aea6728660ff2e8/dialogflow-parameters-turning-the-bot-off.png?fm=avif&w=1000) 

### 最佳做法

《回退意图》不包括添加参数的地方。 当关闭对话框中的机器人时， 您应该在您的 Fallback 意向中创建一个快速回复，询问联系人是否想要与一个人交谈。 如果联系人以 _是_ 快速回复做出回应，则应将他们带到带有 `RB_BOTSTATUS` 参数的意图。

当使用此参数禁用机器人时， 您也可能想要更新平台上的用户状态使用 `RB_MARKDONE` 并在平台上发送一个通知，并在单一的意图中发送一个 `RB_NOTIFY` 参数。

## 关闭对话

[分配和关闭一个对话系统](https://respond.io/zh/help/messages/assignment-and-closing-a-conversation) 打开一个新的对话框，所有新的联系人和所有联系人都有新的消息。 这将确保所有需要援助的联系人都会出现在 [未分配列表](https://respond.io/zh/help/messages/messages-overview#contact%5Flist) 中。

> 默认情况下，平台将为所有发送新消息的新联系人和联系人打开新的会话。

可以在 [联系人模块](https://respond.io/zh/help/contacts/contacts-overview) 或 [收件箱模块](https://respond.io/zh/help/messages/messages-overview)中手动为联系人打开或关闭对话，使用 [工作流](https://respond.io/zh/help/workflows/workflows-overview)以编程方式打开或关闭对话，并使用 Dialogflow 意图中的参数关闭对话。

要结束 Dialogflow 中联系人会话，请在您的 Dialogflow 意图中使用 `RB_MARKDONE` 参数。

### 使用标记完成参数

关闭联系人的对话， 在您的对话流意图中使用 `RB_MARKDONE` 参数，并将值设置为 `true`。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/5Mg3H7ELptqg8kKJaPDxzJ/3c072b8dec2e5aada2365c3cfd1fbf84/dialogflow-parameters-closing-conversatio.png?fm=avif&w=1000) 

任何使用 `RB_MARKDONE` 参数并将值设为 `true` 的联系人，其对话将会在 respond.io 平台中结束。

### 最佳做法

默认情况下，所有带有新消息的新联系人和联系人将打开一个新的对话。 对于不需要人工代理的意图，您需要将 `RB_MARKDONE` 设置为 `true`。

您可能需要将此意图与 [RB\_NOTIFY](https://respond.io/zh/help/dialogflow/dialogflow-parameters#using%5Fthe%5Fnotification%5Fparameter) 同时使用，以便在为联系人打开对话时触发通知。 通知消息可以用来传递特定联系人需要做些什么的信息。

## 正在分配

要从对话流中分配一个联系人，请在您的对话流提示中使用 `RB_USER_ASSIGN` 参数。

### 使用分配参数

指派联系人给用户， 在您的对话流意图中使用 `RB_USER_ASSIGN` 参数，并将此值设置为您想要分配的平台用户的电子邮件。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2TgVjwGPU0bEXP26FbDTrv/10dda392c8b79d06458ade475363ba8b/dialogflow-parameters-assigni.png?fm=avif&w=1000) 

任何触发意图并使用 `RB_USER_ASSIGN` 参数的联系人，其值为有效用户电子邮件的联系人将被分配到该用户。

## 发送自定义通知

默认情况下，当联系人发送新消息时， [通知系统](https://respond.io/zh/help/user-account/notifications) 将向平台用户发送通知。 可以使用对话流Intents中的参数创建和发送更多的通知。

要向平台用户发送通知，请使用 Dialogflow Intent 中的 `RB_NOTIFY` 参数。

### 使用通知参数

通知可以使用 `RB_NOTIFY` 作为参数名称发送到平台。 参数的值将作为通知发送。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/727vIY3X9OYTHLvFm2THby/2395d2217e3a301411f351bd31825129/dialogflow-parameters-sending-notifications.png?fm=avif&w=1000) 

> **提示：** 您可以通过输入 $dynamic.variable 在参数值中使用 [动态变量](https://respond.io/zh/help/dynamic-variables/dynamic-variables)。

### 最佳做法

使用 $contact.name 动态变量以便让平台用户知道哪个联系人需要关注。

使用 `RB_NOTIFY` 和 [RB\_BOTSTATUS](https://respond.io/zh/help/dialogflow/dialogflow-parameters#using%5Fthe%5Fbot%5Fstatus%5Fparameter) 和 [RB\_MARKDONE](https://respond.io/zh/help/dialogflow/dialogflow-parameters#using%5Fthe%5Fmarked%5Fdone%5Fparameter) 确保联系人得到他们需要的注意。

> **提示：** 在此处了解有关 [平台上通知如何运作的更多信息](https://respond.io/zh/help/user-account/notifications)。

## 取消订阅

时不时地，你会收到一条联系短信，内容是 "STOP"。 这可能是因为他们不再想要接收 [广播](https://respond.io/zh/help/broadcasts/broadcasts-overview)。 在 Dialogflow 中将 `RB_SUBSCRIBE` 设置为 `false` 将取消所有未来广播的订阅。

> 机器人响应和直接消息不会受到影响。

### 使用订阅参数

使用 `RB_SUBSCRIBE` 参数，您可以通过将值分别设置为 `true` 或 `false` 来订阅或取消订阅联系人。 取消订阅的联系人被排除在未来的平台广播之外。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3x9538Te6Ov4UNcrdbBzra/aa10f8dbac56921a4cde1be03b43bf4c/dialogflow-parameters-unsubscribe.png?fm=avif&w=1000) 

### 最佳做法

如果您正在使用 `RB_SUBSCRIBE` 参数来管理广播权限，您应该在 respond.io 中创建一个自定义字段，以显示联系人的订阅状态。 这可以通过使用 [RB\_FIELD\_\[NAME\]](https://respond.io/zh/help/dialogflow/dialogflow-parameters#using%5Ffield%5Fparameters) 参数和 `RB_SUBSCRIBE` 来完成。

## 联系人字段和值

联系人的信息可以以值的形式存储在联系人字段中。

除了默认字段外，您还可以在设置模块中添加和删除[自定义字段](https://respond.io/zh/help/workspace-settings/contact-fields#adding%5Fa%5Fnew%5Fcustom%5Ffield)。 还可以从对话框创建新的自定义字段。

> 如果您在 Dialogflow 中使用字段参数，而相应的自定义字段在平台上不存在，将会创建一个新的自定义字段。

联系人字段值可以在[联系人模块](https://respond.io/zh/help/contacts/contacts-overview)或[收件箱模块](https://respond.io/zh/help/messages/messages-overview)中手动更改，也可以通过[工作流](https://respond.io/zh/help/workflows/workflows-overview)进行程序更改，或使用在 Dialogflow 意图中的参数进行更改。

### 使用字段参数

#### 设置字段值

您可以使用 `RB_FIELD_[FIELD_ID]` 来编辑联系人的自定义字段值，其中“\[FIELD\_ID\]”需替换为自定义字段的 ID。 自定义字段 ID 是在 SNAKE\_CASING 中生成的自定义字段名称。 自定义字段的值将设置为参数中的值。 例如，如果您正在收集联系人的血型，并且某个联系人的血型为 AB 阳性，您将发送带有 AB+ 值的参数 `RB_FIELD_BLOODTYPE`。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2kykWvzw6M2ie4GlQlAi2c/ec23adb05ff455a2765db814a430a408/dialogflow-parameters-custom-fields-1.png?fm=avif&w=1000) 

> **提示：** 您可以使用自定义字段值为 [动态变量](https://respond.io/zh/help/dynamic-variables/dynamic-variables)。

**默认字段**

任何默认的联系人字段都可以做到这一点。 例如，参数 `RB_FIELD_PHONE` 可用于更新联系人的电话号码值。

默认情况下，回复.io上的联系人有以下联系人字段：

| 字段名称   | ID       | 描述            |
| ------ | -------- | ------------- |
| 名字     | 名字       | 联系人名字         |
| 名字     | 名称       | 联系人姓名         |
| 全名     | FULLNAME | 联系人的全名，即名 + 名 |
| 电子邮件地址 | 电子邮件地址   | 联系人的电子邮件地址    |
| 电话号码   | 电话号码     | 联系人的电话号码      |
| 语言     | 名称       | 联系人的语言        |

> 当联系人首次创建时，这些默认字段将使用频道提供的可用信息自动填充。

### 清除字段

要清除联系人的字段值，您可以使用参数 `RB_REMOVEFIELDS` 值将是您想要删除的字段的名称。 您可以通过用逗号分隔几个字段来同时清理这些字段。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/5F6uqSvtrERinNnVwUX0F7/ca979bc658810de07a4a1f0314c165e3/dialogflow-parameters-custom-fields-2.png?fm=avif&w=1000) 

## 片段

[代码片段](https://respond.io/zh/help/workspace-settings/snippets) 系统用于在回复.io平台上存储常用响应的内容。

代码片段可以在 [收件箱模块](https://respond.io/zh/help/messages/messages-overview) 手动发送，以减少输入或使用对话框插件中的参数发送。

通过在您的对话流代理中发送代码片段，您能够在响应中存储您的意向响应内容。 o 可以轻松管理和编辑的平台。

多重意图也可以使用相同的代码片段。 在这种情况下，编辑代码片段会更新所有Intents的响应内容。

若要使用对话流信息发送代码片段，请使用 `RB_SNIPPET` 参数。 触发意图将以代码片段内容作出响应。

### 使用代码片段参数

使用 `RB_SNIPPET`，您可以发送 Snippet 作为响应。 将参数值设置为您想要发送的 [代码片段 ID](https://respond.io/zh/help/workspace-settings/snippets#snippet%5Fname%5Fand%5Fid)。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/eDCvMR1TH6emnwPLHUmGA/234828f3f695a6c08d087aecc0a30bb2/dialogflow-parameters-snippets.png?fm=avif&w=1000) 

> 更新或更改代码片段的名称或内容将保留现有代码片段 ID。

## 正在发送文件

文件可以在 [收件箱模块](https://respond.io/zh/help/messages/messages-overview) 中手动发送，或使用对话流意图中的参数发送。

使用 `RB_FILE` 参数，您可以将存储在 [文件管理器](https://respond.io/zh/help/workspace-settings/files) 中的文件发送到触发对话流内部的联系人。

### 使用文件参数

在您可以发送文件之前，必须将文件上传到 respond.io [文件管理器](https://respond.io/zh/help/workspace-settings/files)。 然后使用 `RB_FILE` 参数和 [文件 ID](https://respond.io/zh/help/workspace-settings/files#file%5Fname%5Fand%5Fid) 作为值将文件发送给联系人。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/xWSBJI7vBo6rrVLHUwNNh/4172fae0b60af4d856820edf245a0db0/dialogflow-parameters-sending-files.png?fm=avif&w=1000) 

> 只有上传到空间并连接到对话流的文件才会发送。 上传到其他空间的文件不会发送给联系人。

号

分享这篇文章

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/dialogflow/dialogflow-parameters)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/dialogflow/dialogflow-parameters)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/dialogflow/dialogflow-parameters)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/dialogflow/dialogflow-parameters)

## 

相关文章 :woman\_technologist：

* [Dialogflow：履行 Webhook 请求学习如何使用发货Webhook请求将数据从respond.io传递到Dialogflow。 ](/zh/help/dialogflow/dialogflow-fulfillment-webhook-requests)
* [Dialogflow：自定义载荷了解 respond.io 上支持的自定义载荷。 ](/zh/help/dialogflow/dialogflow-custom-payloads)
* [对话流程：响应模板学习如何使用响应模板向联系人发送回复。 ](/zh/help/dialogflow/dialogflow-response-templates)
* [对话流: 事件学习如何使用事件触发对话流意图。 ](/zh/help/dialogflow/dialogflow-events)
* [对话流：管理意图通过配置意图来个性化聊天机器人反应。 ](/zh/help/dialogflow/dialogflow-managing-intents)

找不到您正在寻找的东西？ 🔎

[联系客服支持](/zh/contact-us)

2025-12-05T04:06:11.192Z

help

```json
[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"学习如何在多种用例中使用自定义 Dialogflow 参数。","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4IHLTWbmWN0uXBc5x4jthC/59252fcdb357304ce07be76043047b7a/Susan_Swier_Avatar.svg","name":"Susan Swier","url":"https://respond.io/zh/author/susan-swier"},"dateCreated":"2024-08-29T09:44:50.000Z","dateModified":"2025-04-04T09:55:39.109Z","datePublished":"2024-08-29T09:44:50.000Z","headline":"对话流: 参数","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/aHN2vduQKM2TMwAHSNpmc/b30534d10f14cacc767598b21c2a8244/dialogflow-parameters-overview.png","mainEntityOfPage":"https://respond.io/zh/help/dialogflow","publisher":{"@type":"Organization","logo":"https://respond.io/favicon/favicon.svg","name":"respondio"},"thumbnailUrl":"https://assets2-proxy.respond.io/ph8r57dk1q9w/aHN2vduQKM2TMwAHSNpmc/b30534d10f14cacc767598b21c2a8244/dialogflow-parameters-overview.png","url":"https://respond.io/zh/help/dialogflow/dialogflow-parameters"},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Help","item":"https://respond.io/zh/help","position":1},{"@type":"ListItem","name":"集成","item":"https://respond.io/zh/help/integrations","position":2},{"@type":"ListItem","name":"对话流","item":"https://respond.io/zh/help/dialogflow","position":3},{"@type":"ListItem","name":"对话流: 参数","item":"https://respond.io/zh/help/dialogflow/dialogflow-parameters","position":4}]}]
```
