Dify接入社交平台（飞书、钉钉机器人）指南

简介

本方案依赖LangBot作为社交平台和Dify的中间桥梁，完成消息传递与交互。LangBot 是一个开源的大语言模型原生即时通信机器人开发平台，旨在提供开箱即用的 IM 机器人开发体验，具有 Agent、RAG、MCP 等多种 LLM 应用功能，适配全球主流即时通信平台，并提供丰富的 API 接口，支持自定义开发。

部署

安装Docker 和 Docker Compose：

curl -fsSL https://get.docker.com | sh

使用Docker Compose部署（请确保您的服务器能访问github和dockerhub）：

git clone https://github.com/langbot-app/LangBot

cd LangBot

docker compose up -d

开始使用

LangBot使用5300作为服务器端口，确保服务器端口允许访问后，前往浏览器访问http://{server-ip}:5300，即可开始使用。

配置LangBot对接Dify

1.      在LangBot页面选择“流水线”>"+" 新建一条流水线，在弹窗中填写名称和描述，此处可用与Dify的应用对应，选择提交。

2.      在"AI能力页签"，运行器选择“Dify 服务 API”, “基础 URL” 和“API秘钥”配置为从Dify上获取的聊天助手的访问API,和API秘钥，应用类型这里选择“聊天（包括ChatFlow）”，选择“保存”。

3.      调整工作流开始节点的变量。当使用工作流时，LangBot 调用Dify服务API会显式传入以下参数，需要再 Dify 工作流的开始节点中添加下面的输入变量，：

a)       user_message_text：用户消息的纯文本

b)       session_id：用户会话id，私聊为 person_<id>，群聊为 group_<id>

c)        conversation_id：字符串，用户会话id，由 LangBot 生成。用户重置会话后，会重新生成

d)       msg_create_time：数字类型，收到此消息的时间戳（秒）

配置飞书机器人。

1.      创建企业自建应用，填写应用名称和应用描述。

2.      为应用添加机器人能力。

3.      申请发送、接受消息权限

4.      在LangBot页面配置对接飞书机器人：在LangBot页面>"机器人">"+"，新建一个机器人，“是否启用”选择启用，“绑定流水线”选择上面步骤创建的流水线，“机器人名称”“机器人描述”自定义，平台选择“飞书”，“应用ID”、“应用秘钥”从  从飞书开发者平台的应用页面中的“凭证与基础信息”页面获取，下面的“机器人名称”填写与飞书开发者明天的机器人名称保持一致，否则无法再群内正常接收信息，其余配置保持默认，选择“保存”。

5.      在飞书开发者平台配置事件订阅，在飞书开发者平台“事件与回调”>"事件配置"配置订阅方式为“长连接”，选择“添加事件”在弹窗中搜索“接收消息”勾选后选择“确认添加”。

6.      发布飞书机器人，在飞书开发者平台应用页面中选择“版本管理与发布”>"创建版本",填写版本号信息，点击下方保存。

7.      在飞书群中添加机器人，在飞书群“设置”>"群机器人">"添加机器人"，查找到并添加上面创建的的机器人即可使用，私聊也可以直接使用。

配置钉钉机器人

1.      在“钉钉开放平台”>"应用开发">"创建应用"，填写应用名称及描述。

2.      选择上一步创建的应用，进入应用后台，点击“添加应用能力”>"机器人"> 进入机器人配置页面，自定义机器人名称、描述等信息，下面的“消息接收模式”选择Stream模式，点击“发布”。

3.      在应用后台"版本管理与发布"页面，填写版本相关信息，选择“保存”>"直接发布"（只有将应用发布上面的相关配置才能生效）

4.      在LangBot配置页面选择“机器人”>"+" 添加一个机器人，自定义“机器人名称”、“机器人描述”，平台选择“钉钉”，"客户端ID"“客户端秘钥”填写为钉钉应用后台“凭证与基础信息”的Client ID 和Client Secret，“机器人代码”从钉钉应用后台“机器人”页面的“复制 RobotCode”获取，提交后打卡“是否启用开关”，绑定工作流选择步骤2.2创建的对接Dify的工作流，选择保存。

5.      在钉钉客户端群“设置”>"机器人">"添加机器人" 中查找创建的机器人并添加，即可通过@机器人使用，私聊也可使用。