WorkBuddy 接入飞书的技术实现

WorkBuddy 作为一款高效的团队协作工具，接入飞书可以进一步提升团队沟通与管理效率。以下将详细介绍如何通过飞书开放平台的 API 实现 WorkBuddy 与飞书的深度集成，并提供具体的代码示例。

准备工作

在开始接入之前，需要确保已经完成飞书开发者账号的注册，并创建了对应的应用。获取应用的 App ID 和 App Secret 是后续调用 API 的关键凭证。

飞书开发者后台提供了完善的应用管理功能，可以在后台找到应用的凭证信息。同时，需要配置应用的回调地址和权限，确保 WorkBuddy 能够正确处理飞书的事件通知。

获取访问令牌

飞书的 API 调用需要有效的访问令牌（access_token）。以下是通过 App ID 和 App Secret 获取访问令牌的示例代码：

import requests

def get_feishu_access_token(app_id, app_secret):
    url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
    headers = {
        "Content-Type": "application/json"
    }
    payload = {
        "app_id": app_id,
        "app_secret": app_secret
    }
    response = requests.post(url, headers=headers, json=payload)
    if response.status_code == 200:
        return response.json().get("tenant_access_token")
    else:
        raise Exception("Failed to get access token")

发送消息到飞书

通过飞书的消息 API，可以将 WorkBuddy 的通知或任务动态推送到飞书群聊或个人。以下是发送消息到群聊的代码示例：

def send_feishu_message(access_token, chat_id, content):
    url = f"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Content-Type": "application/json"
    }
    payload = {
        "receive_id": chat_id,
        "msg_type": "text",
        "content": json.dumps({"text": content})
    }
    response = requests.post(url, headers=headers, json=payload)
    if response.status_code == 200:
        return response.json()
    else:
        raise Exception("Failed to send message")

处理飞书事件回调

飞书可以通过事件订阅机制将用户操作通知到 WorkBuddy。例如，当用户在飞书中点击按钮或发送消息时，WorkBuddy 可以实时响应。以下是处理飞书事件回调的示例代码：

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/feishu/callback", methods=["POST"])
def handle_feishu_callback():
    data = request.json
    if data.get("type") == "url_verification":
        return jsonify({"challenge": data.get("challenge")})
    
    event = data.get("event")
    if event.get("type") == "message":
        handle_message_event(event)
    
    return jsonify({"status": "success"})

def handle_message_event(event):
    message = event.get("message")
    sender = event.get("sender")
    print(f"Received message from {sender.get('sender_id')}: {message.get('content')}")

实现飞书单点登录

通过飞书的单点登录（SSO）功能，用户可以直接使用飞书账号登录 WorkBuddy。以下是实现飞书 SSO 的代码示例：

def feishu_sso_login(code, app_id, app_secret):
    url = "https://open.feishu.cn/open-apis/authen/v1/access_token"
    headers = {
        "Content-Type": "application/json"
    }
    payload = {
        "grant_type": "authorization_code",
        "code": code,
        "app_id": app_id,
        "app_secret": app_secret
    }
    response = requests.post(url, headers=headers, json=payload)
    if response.status_code == 200:
        user_info = response.json().get("data")
        return user_info
    else:
        raise Exception("Failed to login with Feishu")

同步飞书通讯录

将飞书的组织架构和用户信息同步到 WorkBuddy 可以实现统一的成员管理。以下是获取飞书部门列表的代码示例：

def get_feishu_departments(access_token, parent_department_id=None):
    url = "https://open.feishu.cn/open-apis/contact/v3/departments"
    headers = {
        "Authorization": f"Bearer {access_token}"
    }
    params = {
        "parent_department_id": parent_department_id
    } if parent_department_id else {}
    response = requests.get(url, headers=headers, params=params)
    if response.status_code == 200:
        return response.json().get("data").get("items")
    else:
        raise Exception("Failed to get departments")

总结

通过以上步骤，可以实现 WorkBuddy 与飞书的高效集成，涵盖消息推送、事件处理、单点登录和通讯录同步等功能。飞书开放平台提供了丰富的 API 和文档支持，开发者可以根据实际需求进一步扩展功能。