多IM企業選AI助手,90%的人踩過這3個坑
飛書 / 企業微信 / 釘釘 / WhatsApp / QQ 真實落地(含限頻、簽名、過期答案)
2026-07-14 · Leo · 踩坑實錄 · 閱讀約 12 分鐘
TL;DR — 公司想"一套 AI 在所有 IM 裡都能問"?下面是飛書/企微/釘釘/WhatsApp/QQ 五個平臺上線半年內**幾乎都會踩**的 8 個坑。文末給一個 SOP,能讓你少掉一半頭髮。
1. 飛書機器人:單租戶 100 QPS 上限,沒人會告訴你
坑:業務高峰期全員提問 → 飛書返回 429,整個機器人直接罷工半小時
飛書官方文件的限頻是按單租戶算的,不是按機器人算。200 人公司開大會同步答疑,瞬時超過 100 QPS 是常事。報錯碼 230020,但運維群裡看到的就是"AI 不回了"。
✅ 修法:在 AI 服務前置一個令牌桶 / 滑動視窗(按租戶或按機器人),削峰到 80 QPS;並在飛書側配非同步訊息回執,使用者問題先收下、答不上時再補"稍等我查一下"——避免機器人看起來像宕機。
2. 企業微信:回撥 URL 要"先驗證再儲存",簽名串錯就 0 線索
坑:配置企業微信回撥時一直返回 "校驗失敗",文件沒說哪裡錯
企業微信驗證回撥時,sHA1(msg_signature=...×tamp=...&nonce=...&echostr=...) 的拼接順序錯了,或者 token / EncodingAESKey 不一致,只返回空字串,錯誤日誌只能靠自己打。最常見的是空格、% 轉義、回車不一樣。
✅ 修法:先把廠商提供的官方 Demo整段跑通(PHP/Java/Python 都有),再替換成你的服務。我已踩過四次。下次新加企業微信應用,我會先跑 Demo 再寫業務程式碼。
3. 釘釘機器人:群訊息 & 機器人訊息走兩條不同 API
坑:用 ChatAPI 發到群,以為通了;用機器人接收,沒反應
釘釘裡"群機器人"(Webhook)和"機器人應用"(具備傳送/接收許可權)是兩個東西。開發者很容易混,開發完才發現在自己被踢出/移除許可權時機器人靜默失效。
✅ 修法:公司內統一用機器人應用(企業內部應用 / 工作通知),留有 webhook 兜底給純通知類場景(比如巡檢日報)。兩者鑑權、限頻、撤回規則全不一樣。
4. WhatsApp Business API:on-call 24h 視窗外的訊息要付費模板
坑:海外客戶問問題等不到 24 小時,AI 回覆失敗
WhatsApp Business Policy:使用者主動發起對話後 24h 內,可以自由回覆;超過 24h 必須用預先稽核透過的模板("template message"),且模板要花錢。多數 AI 助手的通用做法會"掛掉"這類回覆,讓客戶感受"AI 在睡覺"。
✅ 修法:把"已過期"狀態顯式告訴客戶——"我暫時不能繼續會話,請回復'繼續'讓我重開視窗",並觸發業務側跟進。如果你正經做外貿,預先準備 5-10 個模板能省你幾倍溝通成本。
5. QQ 開放平臺 Bot:個人賬號、企業主體、不支援"群機器人"
坑:以為 QQ 群機器人跟微信一樣簡單,實則三條路
QQ 群裡跑機器人要:① QQ 開放平臺 → 建立機器人 → 選"頻道機器人"或"群機器人";② 不同主體(個人 / 個體工商戶 / 企業)稽核要求和資源配額不同;③ 群機器人目前仍有限號。開發者文件稀薄,徒手接入要走三步。
✅ 修法:如果你已經在用 Discord/Telegram/微信機器人,歡迎直接對接那套,把 QQ 視為增強項而非必選項——大多數客戶的 QQ 服務能用群訊息轉發到飛書/企微,已經夠了。
6. AI 給"過期答案":知識庫滯後最常見的隱性災難
坑:客戶問返修流程,AI 答的是兩年前的政策
一種常見場景:銷售問"續約優惠現在還能拿到多少",AI 返回的是三年前的折扣表。原因:知識庫裡有舊版 PDF 沒下架,新版上線後舊的索引沒失效。
✅ 修法:① 知識庫按版本管理(v1/v2/v3);② 每個回答都帶"文件出處 + 最近一次更新時間";③ 讓 AI 引用時必須 cite 文件和段落,找不到時直接說"未找到相關內容",不能編。
7. 資料散落五個後臺:老闆問"AI 昨天回了啥",答案永遠是不知道
坑:每個 IM 平臺各自一段對話記錄,合規審計拼不起來
飛書有飛書的 IM 後臺、企微有企微的會話存檔、釘釘走自家 store、WhatsApp 走 Meta business manager、QQ 又是獨立開放平臺。當 HR、法務、客戶問"昨天某員工問了 AI 什麼",IT 真答不出來。
✅ 修法:① 會話一定先映象到公司自己的儲存(哪怕只是非結構化日誌),IM 平臺只作"傳輸層";② 接入合規/審計時,由你家的儲存統一匯出;③ 跨 IM 平臺的使用者身份要做對映表(手機號、姓名、企微 userid 不能直接打通)。
8. 多平臺許可權割裂:研發能 run shell,行政也能 run shell
坑:AI 在飛書裡能跑命令,結果全公司都能跑
飛書的"機器人在群裡收到訊息"和"機器人能用什麼工具"是兩個獨立開關。最常見的翻車:AI 預設啥也沒禁用,導致行政人員問"怎麼重置 WiFi",AI 順手就去 ping 伺服器了。
✅ 修法:按部門 × 按工具做二維授權表。研發能"跑命令",行政只能"查文件"。這事情聽上去樸素,做過的人知道第一次清空資料的感覺。
SOP:少走彎路的 5 步預演
- 定一站:先把一個 IM 平臺跑通到底,再擴。常見組合:飛書 + 企微(覆蓋 90% 中國企業)。
- 限頻回扣:每個平臺的 QPS 上限和失敗重試策略打成 SOP,老闆問"為什麼不回"時只需查表。
- 知識庫版本化:v1/v2/v3,所有回答帶出處帶時間。
- 資料映象:會話前先落庫,先合規再聊天。
- 許可權兩張表:部門 × 工具,不要讓 AI 擁有"啥都能幹"的"超級員工"許可權。