什么是机器人

​ 机器人是一种运行于潮信内的第三方服务,用户可通过向机器人发送消息,或在输入框输入指令等方法与机器人交互。

机器人可以做什么?

提供定制的提醒和信息

​ 机器人可以在第一时间发送提醒,或定制的信息给用户。 例如及时向运维人员发送监控信息等

充分利用其它服务的资源

​ 机器人可以利用外部丰富的媒介资源,来充实聊天内容。例如第三方图片、视频、股票等等

创建自定义工具

​ 机器人可以提供投票、天气预报、翻译等各种工具

提供LBS服务

​ 机器人能为用户提供丰富多彩的本地化LBS服务

机器人和普通用户的区别是什么?

​机器人是一种不需要手机号码的特殊潮信账号。同普通联系人一样,机器人可以被用户添加为联系人。用户亦可将机器人添加至某个群组,从而为群组提供服务。 机器人无法主动向用户发起私聊会话。用户需先给机器人发送一个消息或指令,或将机器人加入某个群组后,机器人才会向用户发送消息。

​ 当机器人被加入一个群组后,机器人仅会接收@它的信息

机器人是如何运作的?

一个典型的潮信客户端–潮信服务器–潮信机器人的工作流程如下图所示:

潮信机器人工作流程示意图

如何创建一个机器人?

您需通过潮信机器人官方页面来创建您的机器人并获取API-key。之后,可参考机器人API来开发您的潮信机器人。

机器人的交互模式

目前,潮信机器人支持以下交互模式

输入框指令模式

想快速使用机器人?用户可在任意聊天会话中输入

@机器人用户名 查询内容关键词

来和机器人交互,以图片机器人为例:

@pic 安全

机器人收到查询请求后,会返回相应结果的待选列表。用户点击其中某项之后,此项目就被发送到当前聊天室中

输入框指令模式图1

输入框指令模式图2

当一个机器人支持指令模式且被添加为联系人,则用户在任意聊天室输入@时,待选列表中会出现此机器人,以便被快捷调用。

此外,潮信机器人的输入框指令模式,亦支持多级分步返回。例如:输入@某机器人+空格,返回一个分类的待选列表,点击任意分类,继而返回所选分类的次一级待选列表。

消息模式

用户可以通过发送消息给机器人的方式,获得机器人的直接反馈。例如:

在与股票机器人的私聊里输入

300002

股票机器人即会返回用户此股票相关信息

特别地,消息模式中,潮信机器人会解析以“/”开头的字符串。“/”开头的字符串被称之为命令。格式如下:

/命令 [选项][参数]

命令必须以“/”开头,且不能超过20个字符(中文为10个)。命令仅可使用中英文、数字和_。 例:

/获取状态/setalarm 10 响铃/set@stock

用户可以通过如下方式,向机器人发送命令:

  1. 在输入框手动输入符合命令格式的字符串

  2. 用户在潮信APP中输入“/”时,会弹出一个待选命令列表。

  3. 当一个聊天室里有支持命令模式的机器人存在时,输入框的右侧会出现一个“/”按钮,点击此按钮亦会弹出待选命令列表。

在上述2或3的情况下,点击待选列表中的任意项目,相关命令即发送至机器人

群组内的机器人仅会接收@它的命令,故调用时需带上@相应机器人昵称,例:

/set@股票

消息模式

默认命令

每个机器人都拥有2个默认命令 /开启 — 开启此机器人的运行。发送“/开启”后,机器人可在私聊中主动发送消息给用户。例如一段欢迎信息 当用户首次打开与机器人的会话时,用户会看到开始按钮。 /关闭 — 关闭此机器人的运行。发送“/关闭”后,机器人无法在私聊中主动发送消息给用户。

默认命令不会出现在群聊中

键盘模式

用户使用机器人时,有时需要一些更易用、精准的交互方式,此种情况下键盘模式就非常合适。

向机器人发送一条消息后,机器人会返回一个附带若干预定义按钮的特殊键盘样式,客户端收到后将之呈现于用户。此时用户即可通过图形化的按钮界面更方便的与机器人进行交互 。点击任意按钮,均会向机器人发送相应命令。如此,极大的简化了用户与机器人的交互过程。

键盘模式

现在我们支持在按钮中显示文本和表情。

特别地,点击键盘模式里的按钮,相应命令也会自动出现在输入框中

位置和手机号码

某些机器人需要用户额外的信息才能带来最佳的用户体验。 例如,基于LBS的服务需要知道用户的位置;客服服务需要获知用户的电话号码。

机器人可利用按钮方式请求用户的位置或电话号码。请注意,位置或电话号码请求按钮只可能出现在私聊中。

位置和号码

您可继续参考机器人API进行开发