使用 Python 實現一個飛書/微信記賬機器人，酷B了！

Python+飛書文檔+機器人

今天的主題是：使用Python聯動飛書文檔+機器人，實現一個專屬的記賬助手，這篇文章如果對你幫助極大，歡迎你分享給你的朋友、她、他，一起成長。

也歡迎大家留言，說說自己想看什么主題的Python文章，留言越具體，我寫的越快，比如留言：我想看Python 自動操作Excel 相關文章。

如果你有具體的需求想通過使用Python實現自動化，那將更好，歡迎私聊我微信，一起交流探討。

核心邏輯
實踐出真知
- 創建一個飛書應用
- 對接飛書Excel
- 記賬功能對接到飛書機器人

核心邏輯

1、通過關鍵詞觸發機器人記賬，比如/fs 支出微信 18 午飯，其中/fs 為觸發關鍵詞，后面的四項分別是：類型、支付渠道、金額、備注。

2、機器人識別到關鍵詞，調用飛書記賬功能函數，在該函數中對收到內容進行解析，并調用飛書文檔接口，將內容寫入飛書文檔。

3、機器人判斷飛書文檔寫入結果，寫入成功則返回記錄成功+文檔地址；寫入失敗則返回記錄失敗+錯誤信息。

微信效果：

飛書效果：

實踐出真知

首先你需要登錄飛書APP創建一個企業，這個過程很簡單，手機下載飛書APP即可，我這里就不貼圖了。

創建一個飛書應用

前提：你已經有了一個飛書帳號，并創建了一個個人企業。

飛書開放平臺地址：open.feishu.cn/app/

訪問飛書開放平臺，點擊創建企業自建應用，輸入應用相關信息即可。

創建成功后，在憑證與基礎信息中可以看到應用的 App ID 和 App Secret，后面有用。

點擊左側的添加應用能力，點擊添加機器人功能。

沒添加這個后面調用會出現如下錯誤：

點擊左側的權限管理，搜索電子表格，將相關的兩個權限勾選開通。

再搜索消息，開通發送接收消息權限，如下圖：

再搜索獲取用戶 user ID，開通獲取用戶 user_id 權限，如下圖：

點擊確定并前往創建應用版本。

在版本創建頁面點擊創建版本，然后根據提示輸入版本號、更新說明、申請理由即可。

應用管理后臺：xxxxx.feishu.cn/admin/appCe…
xxxxx 改成自己的飛書主頁域名前綴

訪問上面應用管理后臺地址，審核通過即可。

對接飛書Excel

首先在飛書文檔里創建一個 Excel，獲取到Excel 鏈接，格式如下：

https://xxxxxx.feishu.cn/sheets/PQV*****************Uh?sheet=k****Y

其中PQV*****************Uh是spreadsheetToken，k****Y表格名稱，用于鎖定具體工作表。

本案例我們使用飛書追加數據接口：open.feishu.cn/document/se…

其中請求參數中 Authorization 獲取方法如下：

import requests
import jsondef get_access_token():url= "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal/" # 應用憑證里的 app id 和 app secret  post_data = {"app_id": "cli_xxxxxxxx", "app_secret": "8xxxxxxxxxxxxxxxxxxk"}r = requests.post(url, data=post_data)access_token = r.json()["tenant_access_token"] return access_tokenheader = {"Content-Type": "application/json; charset=utf-8", "Authorization": f"Bearer {get_access_token()}"}

請求測試

# 記得換成自己的信息
spreadsheetToken = "Pxxxxxxxxxxxxh"
sheetId = "lxxxxV"
data_raw = {"valueRange": {"range": f"{sheetId}!A1:E3","values": [["2023/12/25","收入","微信","100","帳號 老表max"],["2023/12/25","支出","支付寶","10","買東西 老表max"],["2023/12/26","支出","支付寶","19.9","買東西 老表max"],]}
}
url = f"https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/{spreadsheetToken}/values_append"    r2 = requests.post(url, data=json.dumps(data_raw), headers=header)  #請求寫入
print( r2.json()["msg"])  #輸出來判斷寫入是否成功

結果：

記賬功能對接到飛書機器人

開通消息事件，接收消息

如果你想對接到飛書，得有一個云服務器用來接收用戶發給飛書機器人的消息，并返回處理后的結果給飛書用戶。

或者本地部署，然后內網穿透方法也行（不是長久之計）。

開通消息事件之前，需要先在服務器部署一個簡單 web 服務用于接收消息，如下圖，沒啥特別要求，用 flask 快速寫一個簡單的代碼，如下，

from flask import Flask, request, jsonifyapp = Flask(__name__)@app.route('/func', methods=['POST'])
def all_func():try:data = request.json  # 解析收到的 JSON 數據print(data)if data:# 原樣返回數據return jsonify(data)else:return "Missing data", 400except Exception as e:return str(e), 500if __name__ == '__main__':app.run(debug=True, port=8003, host="0.0.0.0")

將上面代碼寫入服務器的 feishu.py 文件，然后運行python feishu.py 即可，

默認配置鏈接為：http://你的服務器公網IP:8003/func

然后在飛書管理后臺，事件與回調頁面配置驗證接口是否OK，沒問題點保存即可。

然后點擊添加事件，搜索接收消息，添加對應事件。

點擊開啟獲取用戶發給機器人的單聊消息和獲取用戶在群組中@機器人的消息權限。

然后發布一個新版本。

這時我們從飛書發送消息給機器人，我們就可以在服務器獲取到對應消息了。

飛書：

服務器：

飛書主動回復用戶實現

在前面實踐部分，我們已經開通過了接收消息權限，這里直接上請求代碼。

'''
發送消息
doc-link https://open.feishu.cn/document/server-docs/im-v1/message/create
接口限制：1000 次/分鐘、50 次/秒receive_id_type值：
- 私聊 user_id 
- 群聊 chat_idmsg_type: 
doc-link https://open.feishu.cn/document/server-docs/im-v1/message-content-description/create_json'''
def fs_send_msg(headers, post_data, receive_id_type):url= f"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type={receive_id_type}"  r = requests.post(url, headers=headers, data=json.dumps(post_data))result = r.json()return result

測試請求：

# 這里 user_id 可以怎么獲取？
# 在前面`消息事件`返回結果里面有，可以從里面獲取
receive_id_type = "user_id"
receive_id = "xxxxx"
msg_type = "text"
content = "{\"text\": \"你好\"}"post_data = {"receive_id": receive_id,"msg_type": msg_type,"content": content,# "uuid": "選填，每次調用前請更換，如a0d69e20-1dd1-458b-k525-dfeca4015204"}
result = fs_send_msg(headers, post_data, receive_id_type)

結果：飛書：