一言不合他就花2小时写了一个Slack的聊天机器人（猛戳下载源码）

  2016年作为人工智能元年，聊天机器人（Chatbot）在各大行业的应用方兴未艾。据统计，2016年有超过3万个聊天机器人品牌和6千个相关技能涌入市场。国外包括Facebook Messenger、Slack等均引入了聊天机器人，所以毋庸置疑，聊天机器人将成为我们未来生活中不可或缺的一部分。近日，IMGEEK开源社区热心开发者&朝阳区群众“晨星桑”一言不合他就花2小时写了一个Slack的聊天机器人，猛戳“阅读原文”下载GitHub源码。

 简介
什么是Slack

   Slack是一个团队沟通的平台，在这里你可以群聊、单聊、甚至打电话。还可以通过简单的拖动，进行文件分享。甚至可以跟Github、Travis、Twitter等等工具和网站进行集成。如果这还不能满足需求，也可以定制自己的APP。Slack也支持强大的搜索功能，所有的消息、通知、文件都可以搜索。

Slack App & Slack Bot

   Slack Apps是能提高工作效率的工具，这里已经有很多很好的工具，比如To-do bot，跟他聊天便可以轻松的定制计划任务，在指定的时间做你要求他做的事情。
当你添加To-do bot这个APP之后，你就可与To-do bot的机器人todobot聊天了，在左侧的DIRECT MESSAGES中找到todobot，如果没找到，点击加号，添加todobot，如下图


什么是环信移动客服

   环信移动客服是一款国内领先的全媒体智能SaaS客服产品，支持全媒体接入，包括网页在线客服、社交媒体客服(微博、微信)、APP内置客服和呼叫中心等多种渠道均可一键接入。

初始化你的Slack
什时候需要把Slack和客服集成？

   星巴克想在Slack上卖咖啡，而Slack的用户都是Team内部的，不可能在每个Team内都安插一个星巴克的服务员。这样就需要把Slack上用户发的消息转到一个集中地方处理，于是我就想到了环信移动客服，消息传递到移动客服，Slack用户可以跟某个客服聊天，并且通过一些定制开发能够看见Slack用户的基本信息（比如：昵称、电话、团队名称等），并且可以二维码支付。

创建你的APP

   打开 https://api.slack.com/apps 页面，点击 Create New App 按钮
填写你的 App Name 并选择开发者的Team，你就可以点击Create App按钮了，出现下面界面的时候，你的App就创建好啦


初始化设置你的App

   点击OAuth & Permissions页面，在下面会有Permission Scope，这里我们搜索bot，然后选择并 Save Changes
在上面的Redirect URLS中填写OAuth认证成功之后的回调地址，比如 https://xxx.xxx/oauth/callback，当然这会儿你可能也不知道你的地址是什么呢，记得之后会用得上

   点击Event Subscriptions，这是设置Slack 事件订阅的，有了它，我们就可以接收到用户在Slack上发的消息了。
进入页面后打开开关，在下面的Subscribe to Team Events中，我们搜索并添加message.channel和message.im，分别是群聊和单聊的消息事件订阅
当然，光订阅是不行的，我们还要设置订阅的地址，在上面的Request Url中设置好你的订阅地址就可以李，比如 https://xxx.xxx/events/callback

   创建Bot User，在BotUsers页面，创建一个BotUser

   然后你就可以在OAuth & Permissions页面，点击Install App to Team按钮，把App安装到你的Team了

Hello World
Step 1：事件订阅初始化

   在设置事件订阅地址的时候，Slack会尝试进行一次检查，需要你他们的请求中携带的challenge原封不动的返回给服务器

Slack进行事件订阅验证的请求体

{

    "type": "url_verification",

    "challenge": "xxxxxxxxxxxxxx",

    "token": "slack verify token"

}

Step 2: 处理消息的事件

   当我们想处理用户发来的消息的时候，我们需要处理消息的事件订阅。
最外层的type为event_callback，event为事件内容，根据event中的type能区分event的类型，channel为消息投递的channel id，user为发送人的id，text为消息的内容
要小心：如果是机器人发送的消息，event中会有bot_id，如果处理不当会导致消息循环发送（不要问我怎么知道的……）

Step 3: 把消息发送到移动客服
Step 3.1: 获取发消息的Token

方法：POST

地址：https://a1.easemob.com/{org}/{app}/token


请求体:

{

  "client_id": "client_id",

  "client_secret": "client_secret",

  "grant_type": "client_credentials"

}

响应体：

{

    "accessToken": "ABCDEFG"

}

Step 3.2:发送文本消息

from为发送消息的人，目前以slackTeamId_slackUserId_slackChannelId为格式

方法：POST

地址：https://a1.easemob.com/{org}/{app}/messages

请求头：

Authorization: Bearer accessToken

请求体：

{

    "from": "teamId_userid_channelId",

    "targetType": "users",

    "target": ["imServiceNumber"],

    "msg": {

        "msg": "你好",

        "type": "txt"

    },

    "ext": {

        "weichat": {

            "visitor": {

                "userNickname": "这里可以填写昵称，也可为空",

                "companyName": "这里填写公司名称，也可以为空"

            }

        }

    }

}

Step 4: 让Slack App接收移动客服消息

   如果你想使用移动客服回调的方式接收消息，你需要跟你的移动客服客户经理申请开通；当然你也可以使用环信即时通讯云的SDK开发，使用长连接接收消息。
以下以回调模式举例，简单的集成只需要关心如下几个字段

• 
  
• eventType应该为chat
  
• from 消息的发送人，应该就是imServiceNumber，要跟集成移动客服的保持一致
  
• payload是消息的内容，简单的可以先支持txt类型的
  
• to是接收消息的人，目前以slackTeamId_slackUserId_slackChannelId为格式
  

消息回调的body

{

"callId": "xxxxxxxx#xxxxxx_305833766880810084",

"chat_type": "chat",

"eventType": "chat",

"from": "im-channel",

"msg_id": "305833766880810084",

"payload": {

  "bodies": [

    {

      "msg": "啊啊啊",

      "type": "txt"

    }

  ],

  "ext": {

    "weichat": {

      "ack_for_msg_id": null,

      "agent": {

        "avatar": "",

        "userNickname": "Admin"

      }

    }

  }

},

"security": "xxxxxxxxxxxxxxxxx",

"timestamp": 1488772272814,

"to": "teamId_userid_channelId"

}

Step 5: 处理OAuth回调

OAuth回调的时候，slack会传给我们一个code，这个code相当于一个临时令牌，来换取accessToken等信息，下面的API就是如何使用code来获取这些信息

方法：POST

地址：https://slack.com/api/oauth.access

请求参数：

client_id

client_secret

code

响应体：

{

  "access_token": "xoxp-139740849892-139751631381-146013991078-XXXXXXXXXXXXXXXXXXXXXXX",

  "bot": {

    "bot_access_token": "xoxb-144002817952-XXXXXXXXXXXXXXXXXXXXXXX",

    "bot_user_id": "UXXXXXXXXX"

  },

  "ok": true,

  "scope": "identify,bot",

  "team_id": "TXXXXXXX",

  "team_name": "91chenxing",

  "user_id": "UXXXXXXX"

}

Step 6: 把收到的消息发给Slack 用户

   发消息需要以SlackBot的身份发送，需要根据teamId获取到SlackBot，获取bot的accessToken。什么时候能获取到SlackBot信息呢？在Slack用户安装App的时候，进行完OAuth认证，Slack Bot信息就会通过 OAuth 回调传给我们了

方法：GET

地址：https://slack.com/api/chat.postMessage

请求参数：

token botAccessToken

channel 填写用户名中的channelId

text 消息内容

as_user 设置为true，就会以bot身份显示，而不是app

至此你就可以在移动客服中和Slack中的用户聊天啦
如果还需要获取User、Team的信息，可以使用Slack Api获取
如果需要的Api权限不够，则需要用户在授权的时候给予更多的权限

注意

• 
  
• 一定要注意消息收发，一不小心会导致消息循环发送，形成死循环
  
• Slack的中Channel可以分为3中：Public Channel、Direct Message Channel、Private Channel，可以根据channel的第一个字母进行区分，C开头的是Public Channel，D开头的是Direct MessageChannel、G开头的是Private Channel
  

 
项目源码：https://github.com/sheepstarli/slack2easemobkefu