如何运用Python建立你的第一个Slack聊天机器人？

聊天机器人(Bot) 是一种像 Slack 一样的实用的互动聊天服务方式。如果你之前从来没有建立过聊天机器人，那么这篇文章提供了一个简单的入门指南，告诉你如何用 Python 结合 Slack API 建立你第一个聊天机器人。

我们通过搭建你的开发环境, 获得一个 Slack API 的聊天机器人令牌，并用 Pyhon 开发一个简单聊天机器人。

我们所需的工具

我们的聊天机器人我们将它称作为“StarterBot”，它需要 Python 和 Slack API。要运行我们的 Python 代码，我们需要：

  • Python 2 或者 Python 3
  • pip 和 virtualenv 来处理 Python 应用程序依赖关系
  • 一个可以访问 API 的免费 Slack 账号，或者你可以注册一个 Slack Developer Hangout team。
  • 通过 Slack 团队建立的官方 Python Slack 客户端代码库
  • Slack API 测试令牌

当你在本教程中进行构建时，Slack API 文档 是很有用的。

本教程中所有的代码都放在 slack-starterbot 公共库里，并以 MIT 许可证开源。

搭建我们的环境

我们现在已经知道我们的项目需要什么样的工具，因此让我们来搭建我们所的开发环境吧。首先到终端上(或者 Windows
上的命令提示符)并且切换到你想要存储这个项目的目录。在那个目录里，创建一个新的 virtualenv 以便和其他的 Python
项目相隔离我们的应用程序依赖关系。



    

  1. virtualenv starterbot 
    2. 



激活 virtualenv：




    

  1. source starterbot/bin/activate 
    2. 



你的提示符现在应该看起来如截图：




已经激活的 starterbot 的 virtualenv的命令提示符这个官方的 slack 客户端 API 帮助库是由 Slack 建立的，它可以通过  Slack 通道发送和接收消息。通过这个pip 命令安装 slackclient 库：




    

  1. pip install slackclient 
    2. 



当 pip 命令完成时，你应该看到类似这样的输出，并返回提示符。




在已经激活的 virtualenv 用 pip 安装 slackclient 的输出我们也需要为我们的 Slack  项目获得一个访问令牌，以便我们的聊天机器人可以用它来连接到 Slack API。


Slack 实时消息传递(RTM)API


Slack 允许程序通过一个 Web API 来访问他们的消息传递通道。去这个 Slack Web API 页面 注册建立你自己的 Slack  项目。你也可以登录一个你拥有管理权限的已有账号。




使用 Web API页面的右上角登录按钮登录后你会到达 聊天机器人用户页面。




定制聊天机器人用户页面给你的聊天机器人起名为“starterbot”然后点击 “Add bot integration” 按钮。




添加一个bot integration  并起名为“starterbot”这个页面将重新加载，你将看到一个新生成的访问令牌。你还可以将标志改成你自己设计的。例如我给的这个“Full Stack  Python”标志。




为你的新 Slack 聊天机器人复制和粘贴访问令牌在页面底部点击“Save Integration”按钮。你的聊天机器人现在已经准备好连接 Slack  API。


Python 开发人员的一个常见的做法是以环境变量输出秘密令牌。输出的 Slack 令牌名字为SLACK_BOT_TOKEN：




    

  1. export SLACK_BOT_TOKEN='你的 slack 令牌粘帖在这里' 
    2. 



好了，我们现在得到了将这个 Slack API 用作聊天机器人的授权。


我们建立聊天机器人还需要更多信息：我们的聊天机器人的 ID。接下来我们将会写一个简短的脚本，从 Slack API 获得该 ID。


获得我们聊天机器人的 ID


这是最后写一些 Python 代码的时候了! 我们编写一个简短的 Python 脚本获得 StarterBot 的 ID 来热身一下。这个 ID 基于  Slack 项目而不同。


我们需要该 ID，当解析从 Slack RTM 上发给 StarterBot 的消息时，它用于对我们的应用验明正身。我们的脚本也会测试我们  SLACK_BOT_TOKEN 环境变量是否设置正确。


建立一个命名为 printbotid.py 的新文件，并且填入下面的代码：




    

  1. import os 
    2. 

  2. from slackclient import SlackClient 
    3. 

  3. BOT_NAME = 'starterbot' 
    4. 

  4. slack_client = SlackClient(os.environ.get('SLACK_BOT_TOKEN')) 
    5. 

  5. if __name__ == "__main__": 
    6. 

  6.     api_call = slack_client.api_call("users.list") 
    7. 

  7.     if api_call.get('ok'): 
    8. 

  8.         # retrieve all users so we can find our bot 
    9. 

  9.         users = api_call.get('members') 
    10. 

  10.         for user in users: 
    11. 

  11.             if 'name' in user and user.get('name') == BOT_NAME: 
    12. 

  12.                 print("Bot ID for '" + user['name'] + "' is " + user.get('id')) 
    13. 

  13.     else: 
    14. 

  14.         print("could not find bot user with the name " + BOT_NAME) 
    15. 



我们的代码导入 SlackClient，并用我们设置的环境变量 SLACK_BOT_TOKEN 实例化它。 当该脚本通过 python

命令执行时，我们通过会访问 Slack API 列出所有的 Slack 用户并且获得匹配一个名字为“satrterbot”的 ID。


这个获得聊天机器人的 ID 的脚本我们仅需要运行一次。




    

  1. python print_bot_id.py 
    2. 



当它运行为我们提供了聊天机器人的 ID 时，脚本会打印出简单的一行输出。




在你的 Slack 项目中用 Python 脚本打印 Slack 聊天机器人的 ID复制这个脚本打印出的唯一 ID。并将该 ID 作为一个环境变量  BOT_ID 输出。




    

  1. (starterbot)$ export BOT_ID='bot id returned by script' 
    2. 



这个脚本仅仅需要运行一次来获得聊天机器人的 ID。 我们现在可以在我们的运行 StarterBot 的 Python应用程序中使用这个 ID 。


编码我们的 StarterBot


现在我们拥有了写我们的 StarterBot 代码所需的一切。 创建一个新文件命名为 starterbot.py ，它包括以下代码。




    

  1. import os 
    2. 

  2. import time 
    3. 

  3. from slackclient import SlackClient 
    4. 



对 os 和 SlackClient 的导入我们看起来很熟悉，因为我们已经在 theprintbotid.py 中用过它们了。


通过我们导入的依赖包，我们可以使用它们获得环境变量值，并实例化 Slack 客户端。




    

  1. # starterbot 的 ID 作为一个环境变量 
    2. 

  2. BOT_ID = os.environ.get("BOT_ID") 
    3. 

  3. # 常量 
    4. 

  4. AT_BOT = "<@" + BOT_ID + ">:" 
    5. 

  5. EXAMPLE_COMMAND = "do" 
    6. 

  6. # 实例化 Slack 和 Twilio 客户端 
    7. 

  7. slack_client = SlackClient(os.environ.get('SLACK_BOT_TOKEN')) 
    8. 



该代码通过我们以输出的环境变量 SLACK_BOT_TOKEN 实例化SlackClient` 客户端。




    

  1. if __name__ == "__main__": 
    2. 

  2.     READ_WEBSOCKET_DELAY = 1 # 1 从 firehose 读取延迟 1 秒 
    3. 

  3.     if slack_client.rtm_connect(): 
    4. 

  4.         print("StarterBot connected and running!") 
    5. 

  5.         while True: 
    6. 

  6.             command, channel = parse_slack_output(slack_client.rtm_read()) 
    7. 

  7.             if command and channel: 
    8. 

  8.                 handle_command(command, channel) 
    9. 

  9.             time.sleep(READ_WEBSOCKET_DELAY) 
    10. 

  10.     else: 
    11. 

  11.         print("Connection failed. Invalid Slack token or bot ID?") 
    12. 



Slack 客户端会连接到 Slack RTM API WebSocket，然后当解析来自 firehose 的消息时会不断循环。如果有任何发给  StarterBot 的消息，那么一个被称作 handle_command 的函数会决定做什么。


接下来添加两个函数来解析 Slack 的输出并处理命令。




    

  1. def handle_command(command, channel): 
    2. 

  2.     """ 
    3. 

  3.         Receives commands directed at the bot and determines if they 
    4. 

  4.         are valid commands. If so, then acts on the commands. If not, 
    5. 

  5.         returns back what it needs for clarification. 
    6. 

  6.     """ 
    7. 

  7.     response = "Not sure what you mean. Use the *" + EXAMPLE_COMMAND + \ 
    8. 

  8.                "* command with numbers, delimited by spaces." 
    9. 

  9.     if command.startswith(EXAMPLE_COMMAND): 
    10. 

  10.         response = "Sure...write some more code then I can do that!" 
    11. 

  11.     slack_client.api_call("chat.postMessage", channel=channel, 
    12. 

  12.                           text=response, as_user=True) 
    13. 

  13. def parse_slack_output(slack_rtm_output): 
    14. 

  14.     """ 
    15. 

  15.         The Slack Real Time Messaging API is an events firehose. 
    16. 

  16.         this parsing function returns None unless a message is 
    17. 

  17.         directed at the Bot, based on its ID. 
    18. 

  18.     """ 
    19. 

  19.     output_list = slack_rtm_output 
    20. 

  20.     if output_list and len(output_list) > 0: 
    21. 

  21.         for output in output_list: 
    22. 

  22.             if output and 'text' in output and AT_BOT in output['text']: 
    23. 

  23.                 # 返回 @ 之后的文本，删除空格 
    24. 

  24.                 return output['text'].split(AT_BOT)[1].strip().lower(), \ 
    25. 

  25.                        output['channel'] 
    26. 

  26.     return None, None 
    27. 



parse_slack_output 函数从 Slack 接受信息，并且如果它们是发给我们的 StarterBot

时会作出判断。消息以一个给我们的聊天机器人 ID 的直接命令开始，然后交由我们的代码处理。目前只是通过 Slack

管道发布一个消息回去告诉用户去多写一些  Python 代码!


这是整个程序组合在一起的样子 (你也可以 在 GitHub 中查看该文件)：




    

  1. import os 
    2. 

  2. import time 
    3. 

  3. from slackclient import SlackClient 
    4. 

  4. # starterbot 的 ID 作为一个环境变量 
    5. 

  5. BOT_ID = os.environ.get("BOT_ID") 
    6. 

  6. # 常量 
    7. 

  7. AT_BOT = "<@" + BOT_ID + ">:" 
    8. 

  8. EXAMPLE_COMMAND = "do" 
    9. 

  9. # 实例化 Slack 和 Twilio 客户端 
    10. 

  10. slack_client = SlackClient(os.environ.get('SLACK_BOT_TOKEN')) 
    11. 

  11. def handle_command(command, channel): 
    12. 

  12.     """ 
    13. 

  13.         Receives commands directed at the bot and determines if they 
    14. 

  14.         are valid commands. If so, then acts on the commands. If not, 
    15. 

  15.         returns back what it needs for clarification. 
    16. 

  16.     """ 
    17. 

  17.     response = "Not sure what you mean. Use the *" + EXAMPLE_COMMAND + \ 
    18. 

  18.                "* command with numbers, delimited by spaces." 
    19. 

  19.     if command.startswith(EXAMPLE_COMMAND): 
    20. 

  20.         response = "Sure...write some more code then I can do that!" 
    21. 

  21.     slack_client.api_call("chat.postMessage", channel=channel, 
    22. 

  22.                           text=response, as_user=True) 
    23. 

  23. def parse_slack_output(slack_rtm_output): 
    24. 

  24.     """ 
    25. 

  25.         The Slack Real Time Messaging API is an events firehose. 
    26. 

  26.         this parsing function returns None unless a message is 
    27. 

  27.         directed at the Bot, based on its ID. 
    28. 

  28.     """ 
    29. 

  29.     output_list = slack_rtm_output 
    30. 

  30.     if output_list and len(output_list) > 0: 
    31. 

  31.         for output in output_list: 
    32. 

  32.             if output and 'text' in output and AT_BOT in output['text']: 
    33. 

  33.                 # 返回 @ 之后的文本，删除空格 
    34. 

  34.                 return output['text'].split(AT_BOT)[1].strip().lower(), \ 
    35. 

  35.                        output['channel'] 
    36. 

  36.     return None, None 
    37. 

  37. if __name__ == "__main__": 
    38. 

  38.     READ_WEBSOCKET_DELAY = 1 # 1 second delay between reading from firehose 
    39. 

  39.     if slack_client.rtm_connect(): 
    40. 

  40.         print("StarterBot connected and running!") 
    41. 

  41.         while True: 
    42. 

  42.             command, channel = parse_slack_output(slack_client.rtm_read()) 
    43. 

  43.             if command and channel: 
    44. 

  44.                 handle_command(command, channel) 
    45. 

  45.             time.sleep(READ_WEBSOCKET_DELAY) 
    46. 

  46.     else: 
    47. 

  47.         print("Connection failed. Invalid Slack token or bot ID?") 
    48. 



现在我们的代码已经有了，我们可以通过 python starterbot.py 来运行我们 StarterBot 的代码了。




当 StarterBot 开始运行而且连接到 API 的输出通道在 Slack 中创建新通道，并且把 StarterBot 邀请进来，或者把  StarterBot 邀请进一个已经存在的通道中。




在 Slack 界面创建一个新通道并且邀请 StarterBot现在在你的通道中给 StarterBot 发命令。




在你的 Slack 通道里给你的 StarterBot

发命令如果你从聊天机器人得到的响应中遇见问题，你可能需要做一个修改。正如上面所写的这个教程，其中一行AT_BOT = "<@" +

BOT_ID +  ">:"，在“@starter”(你给你自己的聊天机器人起的名字)后需要一个冒号。从 AT_BOT

字符串后面移除:。Slack 似乎需要在@  一个人名后加一个冒号，但这好像是有些不协调的。


结束


好吧，你现在已经获得一个简易的聊天机器人，你可以在代码中很多地方加入你想要创建的任何特性。


我们能够使用 Slack RTM API 和 Python 完成很多功能。看看通过这些文章你还可以学习到什么：


    

  • 附加一个持久的关系数据库 或者 NoSQL 后端 比如 PostgreSQL、MySQL 或者 SQLite ，来保存和检索用户数据
    • 

  • 添加另外一个与聊天机器人互动的通道，比如 短信 或者电话呼叫
    • 

  • 集成其它的 web API，比如 GitHub、Twilio 或者 api.ai
    • 



有问题? 通过 Twitter 联系我 @fullstackpython 或 @mattmakai。 我在 GitHub  上的用户名是mattmakai。


这篇文章感兴趣? Fork 这个 GitHub 上的页面吧。


作者：Matt Makai


来源：51CTO
				


				
时间： 2024-09-20 06:13:14

		
		


		


	

	
	

		


		
如何运用Python建立你的第一个Slack聊天机器人？的相关文章


								

		

			

                使用Python的Tornado框架实现一个一对一聊天的程序_python
			

		

		

									

				按思路来聊: 类似微信,点击用户可以进入一对一聊天页面:另有聊天框列表包含所有存在聊天记录的一对一聊天框,点击进入聊天页面.[数据结构] 因为双方都有聊天记录,所以每一个聊天实际上得储存两份,设计的数据结构如下: A : user_a = {"id":1,"name":"A"} B : user_b = {"id":2,"name":"B"} A的聊天记录: chat_a = { &qu			

		

	

				

		

			

                如何用 Python 和 Flask 建立部署一个 Facebook Messenger 机器人
			

		

		

									

				这是我建立一个简单的 Facebook Messenger 机器人的记录.功能很简单,它是一个回显机器人,只是打印回用户写了什么. 回显服务器类似于服务器的"Hello World"例子. 这个项目的目的不是建立最好的 Messenger 机器人,而是让你了解如何建立一个小型机器人和每个事物是如何整合起来的. 技术栈 使用到的技术栈: Heroku 做后端主机.免费级足够这个等级的教程.回显机器人不需要任何种类的数据持久,所以不需要数据库. Python 是我们选择的语言.版本选择 2			

		

	

				

		

			

                用python在mininet自定义了一个topo但得不到想要的结果
			

		

		

									

				问题描述 用python在mininet自定义了一个topo但得不到想要的结果 这是代码.做的是一个胖树结构, 我运行之后没有报错但是得不到任何的结果,就像什么都没建立起 from mininet.topo import Topo class FatTreeTopo( Topo ): CoreSwitchList = [] AggSwitchList = [] EdgeSwitchList = [] HostList = [] def __init__(self, k): "Create fat			

		

	

				

		

			

                Python实现保证只能运行一个脚本实例
			

		

		

									

				  这篇文章主要介绍了Python实现保证只能运行一个脚本实例,本文直接给出实现代码,需要的朋友可以参考下 保证只能运行一个脚本实例,方法是程序运行时监听一个特定端口,如果失败则说明已经有实例在跑. 使用装饰器实现,便于重用 代码如下: import functools def just_one_instance(func): ''' 装饰器 如果已经有实例在跑则退出 复制代码 代码如下: :return: ''' @functools.wraps(func) def f(*args,**kwa			

		

	

				

		

			

                python使用线程封装的一个简单定时器类实例
			

		

		

									

				  本文实例讲述了python使用线程封装的一个简单定时器类.分享给大家供大家参考.具体实现方法如下: ? 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 from threading import Timer class MyTimer: def __init__(self): self._timer= None self._tm = None self._fn = N			

		

	

				

		

			

                python-请问Python tk中怎样使一个按钮被点击一次之后就变为灰色无效？
			

		

		

									

				问题描述 请问Python tk中怎样使一个按钮被点击一次之后就变为灰色无效? 请问在Python tk中比如说我设置了这样一个按钮, Button(root,text=a,width=10,command=lambda:newExpression(a)).grid(row=1,column=0) 那么怎样使这个按钮被点击一次之后就变为灰色无效? 解决方案 没用过tk,帮你搜索了下,http://stackoverflow.com/questions/20596892/disabling-but			

		

	

				

		

			

                python-怎么自动做支持Python,中文aiml，小白一个
			

		

		

									

				问题描述 怎么自动做支持Python,中文aiml,小白一个			

		

	

				

		

			

                c++-我写的建立表达式二叉树的一个函数，delete[]p和B.pop(a1)出错，不明白为什么
			

		

		

									

				问题描述 我写的建立表达式二叉树的一个函数,delete[]p和B.pop(a1)出错,不明白为什么 BinaryTree::BinaryTree(string A){ arrStack B(NUM); BinaryTreeNode a1(" "), a2(" "); int i = 0; while (A[i] != '='){ char *p = new char[]; char *q = p; int j = 0; if ((int)A[i] >= 48			

		

	

				

		

			

                机器人系统设计与制作：Python语言实现3.1　什么是机器人仿真
			

		

		

									

				摘要 用ROS和Gazebo进行机器人仿真 在上一章中,我们了解了机器人的机械设计过程,并着手设计了机器人的2D和3D模型.在这一章中,将对我们设计的机器人进行模拟仿真.在进行仿真之前,要先来了解一下机器人仿真的作用,它存在的优缺点,以及各式各样的机器人仿真软件工具. 本章中我们还将讨论机器人的运动学和动力学参数,它会有助于您了解机器人的各项功能.在讨论了这些概念之后,将确定用于机器人仿真的软件平台.我们计划是在机器人操作系统(Robot Operating System,ROS)平台下,使用G