# 用户输入插件

我们常常希望可以从用户的对话中，提取到有用的信息并存储下来，以便后续为用户提供更加智能的服务。（比如，用户在对话的过程中，曾经输入过自己的订单号码。如果我们能有效识别并存储下来，那么，用户再次询问订单详情时，就不需要再次输入订单号码了。）

***因此，我们提供了“用户输入”这一高级插件，来帮助您实现上述场景。***

## 主要功能

### 用户输入类型的识别

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCS_IBYXfzF6zDCR9R_%2F-LCSdfpjfJPVa7fYLmKc%2Fp3f1p201.jpg?alt=media\&token=2d60f75d-2318-4c2f-ad6e-7a78b5adb612)

我们提供了多种常用的输入类型识别，来帮助您提取出有效的用户信息。

#### 目前支持的类型如下：

* 邮件地址
* 电话号码
* 正则表达式：您可以按照自己的需求，自定义一组规则，比如订单号码。
* 数字格式
* 文本格式
* 任意格式

### 存储用户输入信息

为了方便后续的调用，您可以将当前成功提取出来的用户输入信息，存储下来。只需要在“存储为”这一栏下方，输入您想要存储的参数名称，即可在后续进行调用。

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCS_IBYXfzF6zDCR9R_%2F-LCSef4EgX9hkvPScZLH%2Fp3f1p203.jpg?alt=media\&token=a0411a49-32c1-46d3-8897-697c9dffbe39)

### 设置回复

当我们通过使用该插件，成功或未成功提取到用户的输入信息时，都需要给用户一定的反馈。因此，我们需要在用户输入的类型符合（成功提取）和类型不符合（未成功提取）时，各设置一个回复。

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCS_IBYXfzF6zDCR9R_%2F-LCSeqLegfvCv-A072w6%2Fp3f1p204.jpg?alt=media\&token=073337ff-c7a2-49a2-9d6c-727a5b58f6ba)

### 设置多组用户输入

实际场景中，经常会遇到用户多个不同类别的信息都可以产生相同的结果。比如订单查询时，用户可以输入订单号来查询，也可以输入邮箱来查询。\
因此，该插件允许我们添加多个用户输入组，每个组之间是“**或**”的关系。

{% hint style="success" %}
点击“添加”按钮，即可添加一组用户输入
{% endhint %}

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCS_IBYXfzF6zDCR9R_%2F-LCSnSVOoAUFCw7R2GMp%2Fp3f1p205.jpg?alt=media\&token=40f406bd-4e7e-4ca4-9c2c-f2fcd1af0430)

### 使用事例

假设我们希望提取用户的邮箱地址，那实际需要进行的配置就是如下：

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCS_IBYXfzF6zDCR9R_%2F-LCSnj0_J_CxKxLlVbBo%2Fp3f1p206.jpg?alt=media\&token=f471e78c-8b8a-43f4-ad4d-f26e0805b36c)

#### 设置流程：

1. 添加一张「文本卡片」，输入引导内容
2. 设置「用户输入类型」为 邮件地址
3. 填写一个「存储为」的参数
4. 设置「类型符合则回复」与「类型不符合则回复」
5. 点&#x51FB;**「保存」**&#x6309;钮

配置完成后，用户在 Messenger 上看到的对话流程如下:

* 用户输入了正确的邮箱地址时&#x20;

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCS_IBYXfzF6zDCR9R_%2F-LCSoCZ3UhPx445AgCkJ%2Fp3f1p207.png?alt=media\&token=748e26be-859d-422a-b895-e8ead6c0a834)

* 用户输入的邮箱地址有误时&#x20;

![](https://1455238913-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LBxiFMKIFEMsz8J7IuU%2F-LCS_IBYXfzF6zDCR9R_%2F-LCSoIlMNkLCCtvCAg6Y%2Fp3f1p208.png?alt=media\&token=399eb362-363d-410f-b679-c438c9a3d672)
