飞书自定义机器人使用教程

1、项目介绍

飞书自定义机器人（feishu-robot）是一个开源项目，旨在帮助开发者快速构建和部署飞书自定义机器人。通过该项目，开发者可以轻松地创建自定义的消息推送、交互式消息等功能，提升团队协作效率。

2、项目快速启动

环境准备

• 安装Go语言环境（建议版本1.16及以上）
• 安装Git

克隆项目

git clone https://github.com/liyinchigithub/feishu-robot.git
cd feishu-robot

配置环境变量

在项目根目录下创建一个.env文件，并添加以下内容：

WEBHOOK=your_webhook_url
SECRET=your_secret

运行示例代码

在main.go文件中，添加以下代码：

package main

import (
    "os"
    "github.com/liyinchigithub/feishu-robot/client"
    "github.com/liyinchigithub/feishu-robot/message"
)

func main() {
    text := message.NewTextMessage("新更新提醒", false)
    client := client.NewClient()
    client.Webhook = os.Getenv("WEBHOOK")
    client.Secret = os.Getenv("SECRET")
    rep, err := client.SendMessage(text)
    if err != nil {
        panic(err)
    }
    println(rep)
}

运行项目

go run main.go

3、应用案例和最佳实践

案例1：项目更新通知

通过飞书自定义机器人，可以实时推送项目更新通知，提升团队协作效率。

postMessage := message.NewPostMessage(
    message.NewZhCnLangPostItem(
        message.NewPostItems(
            "项目更新通知",
            message.NewPostTags(
                message.NewTextTag("项目有更新: "),
            ),
        ).AddContent(
            message.NewPostTags(
                message.NewATag("请查看", "http://www.example.com/"),
                message.NewAtAllAtTag(),
            ),
        ),
    ),
)
client.SendMessage(postMessage)

案例2：交互式消息推送

通过交互式消息，可以实现更丰富的用户交互体验。

interactiveMessage := message.NewInteractiveMessage()
interactiveMessage.SetConfig(
    message.NewCardConfig().SetWideScreenMode(true).SetEnableForward(true),
).AddElements(
    message.NewCardElement(
        message.NewCardText(message.Md, "**西湖** 位于浙江省杭州市西湖区龙井路1号，杭州市区西部，景区总面积49平方千米，汇水面积为21.22平方千米，湖面面积为6.38平方千米。"),
    ),
    message.NewCardAction(
        message.NewButtonActionElement(
            message.NewCardText(message.Md, "更多景点介绍 :玫瑰:"),
        ).SetUrl("https://www.example.com").SetType(message.DefaultType),
    ),
).SetHeader(
    message.NewCardHeader(message.NewCardTitle("今日旅游推荐", nil)),
)
client.SendMessage(interactiveMessage)

4、典型生态项目

飞书消息卡片

飞书消息卡片是一个轻量级的消息推送应用，可以通过各种组件（如按钮、图片等）构建。详细文档请参考：飞书消息卡片文档。

飞书机器人

飞书机器人是一种自动化的程序，可以自动推送消息或与用户进行简单的交互。详细文档请参考：飞书机器人文档。

通过以上模块的介绍和示例代码，您可以快速上手并使用飞书自定义机器人项目。