Thoughts, stories and ideas.

真的一分钟就可以完成一个二维码机器人?

我们团队在使用自己产品的时候,经常会有冒出一些很多小想法,比如:

  1. 在抽奖的时候能不能有个机器人帮助我们掷色子?
  2. 在选择困难的时候有一个机器人帮我决定中午吃啥?
  3. 我想把电脑上的一个页面用手机打开,能不能有个机器人帮我生成二维码?

相信你曾有过的小想法也会有很多,这些想法靠不靠谱先不要紧,先看看能不能快速实现出来~

这篇博客我介绍一个「如何建立一个二维码机器人」的完整示例,完成之后,在 BearyChat 发一个 $qr 某网址 的消息,你就可以获得一个对应的二维码图片。

我们需要利用到两个东西: Outgoing 机器人和 Webscript 脚本服务。

所谓 Outgoging 机器人 就是在 BearyChat 里,把所有以某触发词的开头的普通消息,发送到外部的某个指定服务的机器人。它更厉害的地方在于:可以把处理后的结果再转化成消息,发回给 BearyChat ,让你的机器人可以「一问一答」。

先去你团队所在 BearyChat 管理面板添加一个 Outgoing 机器人。

在手动模式这里我们我们填入了「触发词」 $qr ,由于 「POST 地址」暂时还没有,我们先不关闭这个页面,留着一会儿填写。

再介绍一个叫 Webscript 的服务,它的作用就是能在线编辑并且部署你的小脚本到一个 URL,快速完成一个简单的 API。

你需要先注册一下帐号,然后就可以创建自己的脚本了, 创建的时候你需要填写访问脚本对应的 URL。

在 Webscript 上编写脚本使用的是 Lua,虽然你可能并不熟悉 Lua 这门语言,但其实这里的使用是极为简单的。Webscript 自己也提供了不错的 技术文档 让你快速上手。

在这个脚本只做了很少的事情:

  1. 第一句我们通过 json.parse(request.body).text 得到了 BearyChat 发来消息的正文。
  2. 第二句 string.sub(text, string.find(text,"%s.+$")) 通过正则表达式 ,获取了触发词之后的内容,也就是我们生成二维码的地址。
  3. 最后我们通过 "https://api.qrserver.com/v1/create-qr-code/?size=200x200&data="..URL 得到一张动态的二维码码图片地址,返回给 attachments 里的 images 字段(这些都是 Outgoing 机器人消息标准的数据格式)。这里我们也要感谢 goqr.me 提供的动态二维码服务。

点击保存,这个小 API 就已经完成,可以被外部访问了,ps 需要复制请去看 完整代码 (实际代码可能会有更新)

最后我们再回到 BearyChat 的管理面板,把刚创建脚本的 URL 填入到 Outgoing 机器人的 「POST 地址」,保存。

这样我们的二维码机器人就完成了,可以在任何地方使用 $qr 某网址 来触发它: 当然如果你是第一次走这个流程,会多需要一些时间,但之后再次做类似的机器人一定就熟能生巧,以 1 分钟以内为目标吧~

还有一个小插曲,当时设计同学看到了我使用这个机器人,告诉我说这可帮了他大忙:平时他要提供设计素材的时候,都是先去搜索引擎,找一个在线二维码生成工具,下载图片,最后回到 BearyChat 把图传给工程师。这个过程很费时间不说,偶尔还会弄错,现在有了这个二维码机器人,不止方便,地址也写在上边,大家可以即及时发现错误。听到这个成就感爆棚啊。

最后预告,我们之后还会介绍更强大的 Hubot 机器人,敬请期待。

Email 机器人前来报到

一直都是“希望集成的机器人类型”投票第一位的 Email 机器人终于来了,让大家久等。其实,我们这段时间一直在不断测试内容显示的格式,也在解决各种邮箱服务差异细节问题上花费了一些时间,我们希望第一版的 Email 机器人可以帮助你的团队减少一些反复查看邮箱的时间。

Email 机器人具体的使用方式很简单,创建机器人后你会得到一个 xxxxxxxxxxx@mail.bearychat.com 的机器人邮箱。

只要给这个邮箱发邮件,机器人就会帮你把邮件摘要发送到指定的目标。

除了直接发邮件外,还有更多的使用方式,比如你想让大家都及时的收到任何会议记录的邮件,你可以把标题带有“会议记录”的邮件都发给机器人,这是怎么做到的呢?

下面是分别针对 QQ 邮箱和 Gmail 设置转发过滤器的操作指南,使用其他邮箱的用户如果设置出现问题可以反馈或发邮件联系我们 support@bearyinnovative.com。

Gmail 设置方式

  1. 进入自己邮箱的设置界面

  2. 邮箱添加转发邮件地址

    将机器人的邮箱地址添加到转发列表里,为了安全起见,Gmail 设置了验证步骤,添加后会自动发一个验证链接给机器人,去消息界面点击即可。

  3. 设置转发规则

    通过过滤器/规则,将邮件标题带有“会议记录”做为匹配条件,转发地址里填写/选择机器人的邮件地址。

  4. 设置成功

    以后“会议记录”的邮件机器人都会帮你发到讨论组里啦,赶紧去试试吧。

QQ 邮箱设置方式

  1. 进入自己邮箱的设置界面

  2. 设置转发规则

    通过过滤器/规则,将邮件标题带有“会议记录”做为匹配条件,转发地址里填写/选择机器人的邮件地址。

    由于 QQ 邮箱设置了安全步骤,你这时会在 BearyChat 的消息界面里收到验证地址,点击之后过滤器设置就生效了。

  3. 设置成功

    以后“会议记录”的邮件机器人都会帮你发到讨论组里啦,赶紧去试试吧。

分享你的 Evernote 笔记(是 Evernote 不是印象笔记哦)

每个 BearyChat 用户都可以给还没有集成的服务投票, 这一段时间的投票结果里,排名第二的就是 Evernote (第一名是 Email)。

说实话我一开始并没有想到 Evernote 在中国用户基础有那么好,但是我们立即提高了集成 Evernote 的优先级,而现在,你已经可以在 BearyChat 里方便的分享 Evernote 里的笔记了。

Evernote 和其他需要建立机器人的服务不同,是做为文件分享来源出现的,具体使用方法很简单。

  1. 输入框上方多了一个云彩的按钮,点击后就出现 Evernote 选项。

  2. 因为需要通过授权,才可以访问你在 Evernote 的笔记列表,所以这里需要去 Evernote 获取授权。

    在这里你可以设置授权有效期和清楚看到授权的具体内容。

  3. 之后你就可以自由的选择你的笔记分享给你的团队了。

    分享成功!

    这里我稍微多说一下文件的可见性,文件的可见性其实和消息是一样的,是根据文件被分享到哪里决定的,也就是说如果你只把文件分享在两人对话或者私密讨论组,其他成员是看不到这个文件的(除非文件本身又被分享到公开的普通讨论组)。

好了就这么简单, 我们之后还会增加更多的外部服务集成,方便大家把内容分享给你的团队。

预告一下: 投票排名靠前的 Email 机器人和微博机器人也马上要来了哦,很快就会一起和大家见面。

注: 关于 Evernote 的中国区版本印象笔记,因为使用的策略不同,暂时还无法集成,我们会关注最新的进展,如果条件允许就会立即集成进来。

如何玩转 BearyChat

BearyChat(倍洽) 是以团队为中心的消息汇总处理工具,如果使用得当,团队工作效率会有很明显的提升。希望这篇小攻略会为你带来一些帮助 :)

为了让团队真正把 BearyChat 用起来,创建者在建立团队后还需要做 3 件事:

  1. 邀请其他团队成员,好不好用要大家一起试试才知道
  2. 建立更多讨论组,让讨论变的井井有条,避免干扰
  3. 添加机器人,让外部通知及时有效,还能自己 DIY 定制化的功能

让我们看图说话:

邀请成员

  • 团队刚刚建立还空空如也,联系人里只有 bearybot(BearyChat小助手),它是每个团队都有的小助手,暂时是用来发布新功能通知的,先不要调戏它。


  • 点击左侧第二栏顶端团队名称右侧的下拉菜单,或点击左侧「联系列表」都可以找到「邀请新成员」选项。(邀请成员需要团队管理员权限) 通过手机号或邮箱邀请团队成员很方便,也可以使用邀请链接,很快就可以把整个团队召集起来。
值得说明的是,如团队内需加入受限成员,则可将他们邀请为访客。有关访客更多可查看日志 BearyChat 新功能:开启访客模式

  • 小伙伴们都到齐了,引导大家去聊聊今天的工作内容吧。


创建讨论组

  • 人到齐了,就要做好组织工作。通过讨论组,让大家去不同的地方讨论不同的内容,避免上下文混乱的情况。讨论组可以轻松的创建和加入,为了临时小任务建立独立讨论组也毫不麻烦。 点击左侧上方团队头像,菜单展开后从上到下图标依次为「消息」、「联系列表」、「文件」、「收藏」、「提到我的消息」、「搜索」和「下载列表」。如需要更多帮助,左侧栏下方个人头像上的两个图标分别为「帮助」及「快捷键查看」。在「帮助」菜单中,你可以查阅更多帮助文档,或提出反馈帮助我们继续改进产品。 在「联系列表」中即可找到「创建新讨论组」选项。


  • 有些内容对保密性要求比较高,这时候应该使用只有邀请才能加入的私密讨论组,分享文件等内容在这里也会对外保密。


  • 如何划分讨论组颇有技巧,但更重要的是要符合你团队的情况,下面的图给出一个简单的例子。


有了讨论组之后,尽量不要跑题说不相关的内容,如果谁没有做到就提醒他一下。注意细节其实也是提高工作效率的秘诀。

添加机器人

机器人在 BearyChat 里,能帮助你完成一些神奇的任务。点击团队名称右侧的菜单,在「管理面板」中可以找到「机器人」管理选项。

  • 机器人的种类和功能都是多种多样,或许你能在这里看见一些熟悉的 Logo ,你可以快速将它们集成进来。点击「查看所有机器人」图标,进入全部机器人列表中去看看。无论你在团队中的角色是运营、PM、市场还是研发,在这里都能找到帮助解决具体工作问题的好工具。


  • 具体案例:我们添加一个 Trello 机器人,并通过授权模式进行设置,将 BearyChat 工作组的内容发送到「项目进度」讨论组 (Trello 本身是一个项目管理工具,最大特色是灵活易用的卡片式管理)


  • 这样设置之后,再有 Trello 里的操作,就会立即把提醒发到「项目进度」讨论组,让大家对项目的动态有实时的了解,而免去反复查收 Trello 邮件提醒的麻烦。


最有意思的是动手能力很强的你还可以自己开发机器人, 通过 Incoming / Outgoing 机器人,已经有用户实现了「掷色子」,「中午吃什么?」,「汇率转换」等很多只有想不到没有做不到的创意。这里有个 机器人小卖部 收集了一些现成的代码,欢迎取用。有关 Incoming / Outgoing 机器人的使用配置,则可查看帮助文档 自定义机器人

此外我们还特别提供一个可塑性极强的 hubot 机器人供你二次开发,hubot 是实现 ChatOps 式工作方式 的得力助手之一,利用 hubot 也可以直接在 BearyChat 中与各种具体服务完成交互。有关 hubot 可以查看 这里

总结

经过这三步,你的团队已经有了一批靠谱的成员,丰富的讨论组,和辛勤的机器人。 去体验一下在 BearyChat 中汇总统一处理工作消息的感觉,专心的进入工作状态吧。如需要更多详细拆解使用介绍,可以查阅 BearyChat 帮助文档

之后我们还会在我们的 官方博客 陆续发布 BearyChat 的一些使用技巧及功能更新,敬请继续关注。

如果你现在仍有兴趣阅读更多,可以点击以下链接可以查看我们为你准备的 BearyChat 部分功能介绍BearyChat 部分已集成机器人介绍BearyChat 使用案例