---
dimensions:
  type:
    primary: reference
    detail: examples
  level: intermediate
standard_title: Develop A Slack Bot Plugin
language: zh
title: 开发 Slack Bot 插件
description: 本文档提供了完整的Slack Bot插件开发指南，包括遍历项目初始化、编辑配置表单、实现功能代码、插件调试、设置Endpoint、效果验证到打包发布的完整流程。需要使用Dify插件脚手架工具和已创建的Slack
  App以实现在Slack平台上搞建由AI驱动的聊天机器人。
---

**本文将帮助你：**

深入掌握 Slack Bot 的搭建方法，创建由 AI 驱动的 Slack 聊天机器人，在 Slack 平台上智能回答用户的问题。如果你还没有开发插件的经验，建议先阅读[插件开发入门指南](/plugin-dev-zh/0211-getting-started-dify-tool)。

### 项目背景

Dify 插件生态致力于支持更简单、更易用的接入方式。本文将以 Slack 为例，详细介绍如何开发一个 Slack Bot 插件，便于团队中的成员直接在 Slack 平台内与 LLM 对话，提升 AI 服务的使用效率。

Dify 插件生态旨在提供更简单、更便捷的接入方式。本文将以 Slack 为例，详细讲解如何开发一个 Slack Bot 插件，帮助团队成员直接在 Slack 平台使用 AI 应用，提升办公效率。

Slack 是一个自由开放的实时办公通信平台，拥有丰富的 API。其中，基于事件机制的 Webhook 功能易于上手开发。我们将利用该机制创建 Slack Bot 插件，其原理如下图所示：

![Slack Bot 原理图](https://assets-docs.dify.ai/2025/01/a0865d18f1ca4051601ca53fa6f92db2.png)

> 为了避免混乱，现对以下概念作出解释：
>
> * **Slack Bot** 是在 Slack 平台上的一个聊天机器人，可以被视为虚拟角色，你可以与它进行聊天互动
> * **Slack Bot 插件**指的是 Dify Marketplace上的一款插件，用于连接 Dify 应用与 Slack 平台。本文将主要围绕该插件开发展开。

**原理简介：**

1.  **向 Slack Bot 发送消息**

    当用户在 Slack 中向 Bot 机器人发出一条消息的时候，Slack Bot 会发出一个 Webhook 请求到 Dify 平台。
2.  **消息转发至 Slack Bot 插件**

    用户在与 Slack bot 对话时，需要将消息转发至 Dify 应用。好比邮件系统需要一位收件人的邮箱，此时可以通过 Slack 的 API 配置一个 Slack Webhook 的地址，并将其填入至 Slack Bot 插件并建立连接。
3.  **插件在接受到消息后，返回至某个 Dify 应用**

    Slack Bot 插件将处理 Slack 请求，发送至 Dify 中的应用。由 LLM 分析用户输入的内容并给出回应。
4.  **Dify 应用回应后，将消息返回至 Slack Bot 并回答用户**

    Slack Bot 获取 Dify 应用的回复后，通过插件将消息原路返回至 Slack Bot，使得用户能够在使用 Slack 时直接与 Dify 应用互动

### 前置准备

* Dify 插件脚手架工具，详细说明请参考[初始化开发工具](/plugin-dev-zh/0221-initialize-development-tools)。
* Python 环境，版本号 ≥ 3.12，详细说明请参考 [Python 安装教程](https://pythontest.com/python/installing-python-3-11/)，或询问 LLM 获取完整的安装教程。
* 创建 Slack App 并获取 OAuth Token

前往 [Slack API](https://api.slack.com/apps) 平台， 选择以 scratch 方式创建 Slack APP，并选择需部署应用的 Slack 空间。

![Slack API Token](https://assets-docs.dify.ai/2025/01/8217c23ee16c47c586a1387a442ea6f0.png)

开启 Webhooks 功能。

![开启 Webhooks 功能](https://assets-docs.dify.ai/2025/01/fc9d7797608422219a01248f7151fc81.png)

将 App 安装至 Slack 工作区内。

![安装到工作区内](https://assets-docs.dify.ai/2025/01/6ab7226078f88853fc7f4d3520245d63.png)

获取 OAuth Token，用于后续的插件开发。

![获取 OAuth Token](https://assets-docs.dify.ai/2025/01/f08052044c8c17eebbffacdc9b2558e6.png)

### 1. 开发插件

现在开始实际的插件编码工作。在开始之前，请确保你已经阅读过[开发 Extension 插件](/plugin-dev-zh/9231-extension-plugin)，或已动手开发过一次 Dify 插件。

#### 初始化项目

运行以下命令初始化插件开发项目：

```bash
dify plugin init
```

按照提示填写项目的基础信息，选择 `extension` 模板，并且授予 `Apps` 和 `Endpoints` 两个权限。

如需了解更多关于插件反向调用 Dify 平台能力，请参考[反向调用](/plugin-dev-zh/9241-reverse-invocation)。

![Plugins permission](https://assets-docs.dify.ai/2024/12/d89a6282c5584fc43a9cadeddf09c0de.png)

#### 1. 编辑配置表单

在这个插件中，需要指定使用哪个 Dify 的 App 进行回复，并且在回复的时候需要使用到 Slack 的 App token，因此需要在插件表单中加上这两个字段。

修改 group 路径下的 yaml 文件，例如 `group/slack.yaml。`表单配置文件的名称由创建插件时填写的基础信息决定，你可以修改对应的 yaml 文件。

**示例代码：**

`slack.yaml`

```yaml
settings:
  - name: bot_token
    type: secret-input
    required: true
    label:
      en_US: Bot Token
      zh_Hans: Bot Token
      pt_BR: Token do Bot
      ja_JP: Bot Token
    placeholder:
      en_US: Please input your Bot Token
      zh_Hans: 请输入你的 Bot Token
      pt_BR: Por favor, insira seu Token do Bot
      ja_JP: ボットトークンを入力してください
  - name: allow_retry
    type: boolean
    required: false
    label:
      en_US: Allow Retry
      zh_Hans: 允许重试
      pt_BR: Permitir Retentativas
      ja_JP: 再試行を許可
    default: false
  - name: app
    type: app-selector
    required: true
    label:
      en_US: App
      zh_Hans: 应用
      pt_BR: App
      ja_JP: アプリ
    placeholder:
      en_US: the app you want to use to answer Slack messages
      zh_Hans: 你想要用来回答 Slack 消息的应用
      pt_BR: o app que você deseja usar para responder mensagens do Slack
      ja_JP: あなたが Slack メッセージに回答するために使用するアプリ
endpoints:
  - endpoints/slack.yaml
```

代码数据结构说明：

```
  - name: app
    type: app-selector
    scope: chat
```

*   type 字段指定为 app-selector 字段

    用户在使用插件时可以访问某个 Dify 应用并进行消息转发。
*   scope 字段指定为 chat 字段

    只能使用 `agent` 、`chatbot` 、`chatflow` 等类型的 app。

最后修改 `endpoints/slack.yaml` 文件中的请求路径和请求方式，需要将 method 修改为 POST 方式。

**示例代码：**

`endpoints/slack.yaml`

```yaml
path: "/"
method: "POST"
extra:
  python:
    source: "endpoints/slack.py"
```

#### 2. 编辑功能代码

修改 `endpoints/slack.py`文件，并在其中添加下面的代码：

````python
import json
import traceback
from typing import Mapping
from werkzeug import Request, Response
from dify_plugin import Endpoint
from slack_sdk import WebClient
from slack_sdk.errors import SlackApiError


class SlackEndpoint(Endpoint):
    def _invoke(self, r: Request, values: Mapping, settings: Mapping) -> Response:
        """
        Invokes the endpoint with the given request.
        """
        retry_num = r.headers.get("X-Slack-Retry-Num")
        if (not settings.get("allow_retry") and (r.headers.get("X-Slack-Retry-Reason") == "http_timeout" or ((retry_num is not None and int(retry_num) > 0)))):
            return Response(status=200, response="ok")
        data = r.get_json()

        # Handle Slack URL verification challenge
        if data.get("type") == "url_verification":
            return Response(
                response=json.dumps({"challenge": data.get("challenge")}),
                status=200,
                content_type="application/json"
            )
        
        if (data.get("type") == "event_callback"):
            event = data.get("event")
            if (event.get("type") == "app_mention"):
                message = event.get("text", "")
                if message.startswith("<@"):
                    message = message.split("> ", 1)[1] if "> " in message else message
                    channel = event.get("channel", "")
                    blocks = event.get("blocks", [])
                    blocks[0]["elements"][0]["elements"] = blocks[0].get("elements")[0].get("elements")[1:]
                    token = settings.get("bot_token")
                    client = WebClient(token=token)
                    try: 
                        response = self.session.app.chat.invoke(
                            app_id=settings["app"]["app_id"],
                            query=message,
                            inputs={},
                            response_mode="blocking",
                        )
                        try:
                            blocks[0]["elements"][0]["elements"][0]["text"] = response.get("answer")
                            result = client.chat_postMessage(
                                channel=channel,
                                text=response.get("answer"),
                                blocks=blocks
                            )
                            return Response(
                                status=200,
                                response=json.dumps(result),
                                content_type="application/json"
                            )
                        except SlackApiError as e:
                            raise e
                    except Exception as e:
                        err = traceback.format_exc()
                        return Response(
                            status=200,
                            response="Sorry, I'm having trouble processing your request. Please try again later." + str(err),
                            content_type="text/plain",
                        )
                else:
                    return Response(status=200, response="ok")
            else:
                return Response(status=200, response="ok")
        else:
            return Response(status=200, response="ok")

```
````

为了便于测试，插件功能目前仅能重复用户输入的内容，暂不调用 Dify app。

### 2. 调试插件

前往 Dify 平台，获取 Dify 插件远程调试的连接地址和密钥。

![测试插件](https://assets-docs.dify.ai/2025/01/8d24006f0cabf5bf61640a9023c45db8.png)

回到插件项目，复制 `.env.example` 文件并重命名为 `.env`。

```bash
INSTALL_METHOD=remote
REMOTE_INSTALL_HOST=remote-url
REMOTE_INSTALL_PORT=5003
REMOTE_INSTALL_KEY=****-****-****-****-****
```

运行 `python -m main` 命令启动插件。在插件页即可看到该插件已被安装至 Workspace 内。其他团队成员也可以访问该插件。

```bash
python -m main
```

#### 设置插件 Endpoint

在 Dify 的插件管理页中找到自动安装的测试插件，新建一个 Endpoint，填写名称、Bot token、选择需要连接的 app。

![测试插件](https://assets-docs.dify.ai/2025/01/07f87e8a2786d6f5f05195961c5630c3.png)

保存后将生成一个 POST 请求地址。

![生成 POST 请求地址](https://assets-docs.dify.ai/2025/01/e6952a5798a7ae793b3fe7df6f76ea73.png)

接下来还需要完成 Slack App 的设置。

1. 启用 Event 订阅

![启用 Event 订阅](https://assets-docs.dify.ai/2025/01/1d33bb9cde78a1b5656ad6a0b8350195.png)

在其中粘贴上文中生成的插件 POST 请求地址。

![粘贴生成的插件 POST 请求地址](https://assets-docs.dify.ai/2025/01/65aa41f37c3800af49e944f9ff28e121.png)

勾选 Slack App 所需具备的权限。

![选择 Slack App 所需权限](https://assets-docs.dify.ai/2025/01/25c38a2cf10ec6c55ae54970d790f37e.png)

### 3. 验证插件效果

代码使用了 `self.session.app.chat.invoke` 调用 Dify 平台内的 App，并传递了 `app_id` 和 `query` 等信息，最后将 response 的内容返回至 Slack Bot。运行 `python -m main` 命令重启插件进行调试，确认 Slack Bot 是否能够正确输出 Dify App 的答复消息。

![验证插件效果](https://assets-docs.dify.ai/2025/01/6fc872d1343ce8503d63c5222f7f26f9.png)

### 4. 打包插件（可选）

确认插件能够正常运行后，可以通过以下命令行工具打包并命名插件。运行以后你可以在当前文件夹发现 `slack_bot.difypkg` 文件，该文件为最终的插件包。关于打包的详细步骤，请参考[打包为本地文件与分享](/plugin-dev-zh/0322-release-by-file)。

```bash
# Replace ./slack_bot with your actual plugin project path.

dify plugin package ./slack_bot
```

恭喜，你已完成一个插件的完整开发、测试打包过程！

### 5. 发布插件（可选）

现在可以将它上传至 [Dify Marketplace 仓库](https://github.com/langgenius/dify-plugins) 来发布你的插件了！不过在发布前，请确保你的插件遵循了[发布至 Dify Marketplace](/plugin-dev-zh/0322-release-to-dify-marketplace)中的规范。

## 相关资源

- [插件开发基本概念](/plugin-dev-zh/0111-getting-started-dify-plugin) - 全面了解Dify插件开发
- [插件开发入门指南](/plugin-dev-zh/0211-getting-started-dify-tool) - 从零开始开发插件
- [开发 Extension 插件](/plugin-dev-zh/9231-extension-plugin) - 了解扩展插件开发
- [反向调用 Dify 服务](/plugin-dev-zh/9241-reverse-invocation) - 了解如何调用 Dify 平台能力
- [反向调用 App](/plugin-dev-zh/9242-reverse-invocation-app) - 了解如何调用平台内的 App
- [发布插件](/plugin-dev-zh/0321-release-overview) - 学习发布流程
- [发布至 Dify Marketplace](/plugin-dev-zh/0322-release-to-dify-marketplace) - 市场发布指南
- [端点详细定义](/plugin-dev-zh/0432-endpoint) - Endpoint 详细定义

### 参考阅读

如果你想要查看完整 Dify 插件的项目代码，请前往 [GitHub 代码仓库](https://github.com/langgenius/dify-plugins)。除此之外，你可以看到其它插件的完整代码与具体细节。

如果想要了解更多插件，请参考以下内容。

**快速开始：**

* [开发 Extension 插件](/plugin-dev-zh/9231-extension-plugin)
* [开发 Model 插件](/plugin-dev-zh/0211-getting-started-new-model)
* [Bundle 类型插件：将多个插件打包](/plugin-dev-zh/9241-bundle)

**插件接口文档：**

* [通过清单文件定义插件信息](/plugin-dev-zh/0411-plugin-info-by-manifest) - Manifest 结构
* [端点](/plugin-dev-zh/0432-endpoint) - Endpoint 详细定义
* [反向调用](/plugin-dev-zh/9241-reverse-invocation) - 反向调用 Dify 能力
* [通用规范](/plugin-dev-zh/0411-general-specifications) - 工具规范
* [模型架构](/plugin-dev-zh/0412-model-schema) - 模型

{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}

---

[编辑此页面](https://github.com/langgenius/dify-docs/edit/main/plugin-dev-zh/0432-develop-a-slack-bot-plugin.mdx) | [提交问题](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)

