使用Slacker框架轻松创建Slack机器人

Slacker是一个用于Go语言的Slack机器人框架，它简化了Slack机器人的开发过程。下面我将介绍如何使用Slacker框架创建自己的Slack机器人。

安装Slacker

首先，你需要安装Slacker包：

go get github.com/shomali11/slacker

基本用法

下面是一个简单的Slack机器人示例：

package main

import (
	"log"
	"os"

	"github.com/shomali11/slacker"
)

func main() {
	// 从环境变量获取Slack Bot Token
	botToken := os.Getenv("SLACK_BOT_TOKEN")
	appToken := os.Getenv("SLACK_APP_TOKEN")

	// 创建Slacker实例
	bot := slacker.NewClient(botToken, appToken)

	// 定义一个简单的命令
	bot.Command("hello", &slacker.CommandDefinition{
		Description: "打招呼",
		Handler: func(botCtx slacker.BotContext, request slacker.Request, response slacker.ResponseWriter) {
			response.Reply("你好! 很高兴见到你!")
		},
	})

	// 定义带参数的命令
	bot.Command("repeat <word> <count>", &slacker.CommandDefinition{
		Description: "重复单词指定次数",
		Examples:    []string{"repeat hello 3"},
		Handler: func(botCtx slacker.BotContext, request slacker.Request, response slacker.ResponseWriter) {
			word := request.StringParam("word", "")
			count := request.IntegerParam("count", 1)
			
			for i := 0; i < count; i++ {
				response.Reply(word)
			}
		},
	})

	// 处理错误
	bot.Err(func(err string) {
		log.Printf("错误: %s", err)
	})

	// 启动机器人
	ctx, cancel := context.WithCancel(context.Background())
	defer cancel()

	err := bot.Listen(ctx)
	if err != nil {
		log.Fatal(err)
	}
}

高级功能

1. 中间件支持

Slacker支持中间件，可以在命令执行前后添加逻辑：

// 添加日志中间件
bot.Command("ping", &slacker.CommandDefinition{
	Description: "Ping!",
	Middleware: []slacker.CommandMiddleware{
		func(next slacker.CommandHandler) slacker.CommandHandler {
			return func(botCtx slacker.BotContext, request slacker.Request, response slacker.ResponseWriter) {
				log.Println("收到ping命令")
				next(botCtx, request, response)
				log.Println("处理完ping命令")
			}
		},
	},
	Handler: func(botCtx slacker.BotContext, request slacker.Request, response slacker.ResponseWriter) {
		response.Reply("Pong!")
	},
})

2. 交互式组件

Slacker支持按钮、选择菜单等交互式组件：

bot.Command("menu", &slacker.CommandDefinition{
	Description: "显示交互式菜单",
	Handler: func(botCtx slacker.BotContext, request slacker.Request, response slacker.ResponseWriter) {
		blocks := []slack.Block{
			slack.NewSectionBlock(
				slack.NewTextBlockObject("mrkdwn", "请选择一个选项:", false, false),
				nil,
				slack.NewAccessory(
					slack.NewOptionsSelectBlockElement(
						slack.OptTypeStatic,
						slack.NewTextBlockObject("plain_text", "选择...", false, false),
						"selection",
						slack.NewOptionBlockObject("option1", slack.NewTextBlockObject("plain_text", "选项1", false, false)),
						slack.NewOptionBlockObject("option2", slack.NewTextBlockObject("plain_text", "选项2", false, false)),
					),
				),
			),
		}
		
		response.Reply("", slacker.WithBlocks(blocks))
	},
})

3. 定时任务

Slacker支持定时发送消息：

bot.Init(func() {
	// 每天上午9点发送消息
	bot.Schedule("0 9 * * *", func() {
		bot.PostMessage("general", "早上好! 今天是"+time.Now().Weekday().String())
	})
})

部署注意事项

1. 确保你的Slack应用已正确配置：

   • 启用Socket Mode
   • 添加正确的Bot Token作用域
   • 添加事件订阅（如果需要）

2. 环境变量设置：

   • SLACK_BOT_TOKEN: 你的Bot用户OAuth令牌
   • SLACK_APP_TOKEN: 你的应用级令牌（以xapp-开头）

3. 权限范围通常需要包括：

   • app_mentions:read
   • channels:history
   • chat:write
   • commands

总结

Slacker框架提供了简单直观的API来构建Slack机器人，支持命令处理、交互式组件、中间件等高级功能。通过上述示例，你可以快速开始构建自己的Slack机器人应用。根据你的需求，可以进一步探索Slacker的更多功能，如文件上传、线程回复等。

记得在生产环境中添加适当的错误处理和日志记录，以确保机器人的稳定运行。