Slack 粵語語音 Bot：由指令到出聲嘅完整建置指南

一句答你： Slack 粵語語音 Bot 嘅基本架構只有四步——接收指令、提交生成任務、輪詢攞音檔、上載返頻道；API 係非同步設計，單段文字上限 500 字符（約兩分鐘語音），加埋穩陣嘅錯誤處理同隊列設計，一個中型團隊共用嘅語音 Bot 幾日就建得起。

Key Takeaways

• Bot 骨架四步：收指令 → 提交任務 → 輪詢下載 → 上載頻道。
• API 非同步：提交攞任務編號，完成先有下載連結，Bot 要識等。
• 單段 1 至 500 字符，約等於兩分鐘旁白，公告類內容啱啱好。
• 五個必撞錯誤：缺參數、Key 無效、權限不足、限流、在途任務滿。
• 在途任務上限按方案 3 至 20 個，Bot 要自己排隊。
• 用沙盒 Key 起步（免費同入門每日 20 個請求），驗完先上正式。

Slack 入面嘅粵語語音 Bot 可以做咩

Slack 係好多香港團隊嘅指揮中心，但頻道入面嘅訊息有個盲點：重要嘢好易畀訊息洪流沖走，而且對住螢幕先睇到。語音 Bot 就係補呢個位——將重要內容變成廣東話音檔直接出喺頻道，成員行路、搭車、食晏都聽到，重要公告仲可以隔日重聽。

以下呢啲場景即刻用得着：行政助理將朝早公告變成語音廣播；項目負責人將每週進度摘要變成三分鐘語音；HR 將新政策用一把穩定嘅聲線讀出嚟，唔使每次親自錄；培訓同事將客戶服務對白練習變成頻道入面嘅情景劇。語音 Bot 嘅價值在於「零門檻」——同事唔使離開 Slack、唔使登入任何新平台，喺頻道入面撳一下就聽到。如果你想先了解粵語語音 API 嘅全貌，可以先睇廣東話 TTS 完全指南打底。

五個即刻用得嘅場景

每日公告廣播。 朝早九點，Bot 將當日公告——會議安排、截止提示——自動變成一分鐘語音出喺大頻道，遲啲先上線嘅同事都聽得到。

每週進度摘要。 星期五下晝，將各組進度彙總成三分鐘語音摘要，週末或者下週一聽返都仲得。

HR 政策宣讀。 新假期政策、報銷新流程，用同一把聲線宣讀，比文字公函有溫度，亦都方便唔鍾意睇長文嘅同事。

培訓情景劇。 將客戶服務標準對白寫成兩角色劇本，Bot 出聲喺頻道度，新同事跟住練。客服場景嘅完整應用可以睇客服系統粵語語音應用。

慶祝同氛圍位。 生日祝福、里程碑達成，Bot 即場生成一段有聲祝賀——呢啲小位數係團隊覺得「個 Bot 幾好玩」嘅關鍵。

Bot 嘅基本架構：四步流程

第一步：接收指令

Slack 側嘅入口有幾種做法：斜線指令（例如輸入一個指定嘅指令帶起動作）、訊息關鍵字觸發、或者喺訊息加表情符號觸發。無論邊種，Bot 後端要收到嘅核心資訊都係一樣：邊個頻道、邊個用戶、想讀咩文字。

呢一步要做嘅第一件事係驗證同清理輸入：文字有冇、會唔會超過 API 嘅 500 字符上限、有冇唔合適嘅內容。超上限嘅處理辦法唔係截斷，而係提示用戶切段，或者自動按段落拆做幾條語音。

第二步：提交生成任務

攞到乾淨嘅文字之後，後端向語音 API 提交生成任務。要理解嘅核心特性係：呢個 API 係非同步嘅——提交之後即刻攞到一個任務編號，唔係即場攞到音檔。提交嗰陣要帶嘅主要嘢係文字本身同揀定嘅聲線；Bot 可以預設一條「官方聲線」，亦都可以畀用戶喺幾條預選聲線度揀。

API 嘅提交同輪詢細節、參數格式，可以照住粵語 TTS API 快速上手一步一步行，呢度唔重複。

第三步：輪詢同下載

提交咗任務，Bot 要定期查詢任務狀態，直到完成先攞得到下載連結。幾個實務位：

• 輪詢頻率唔使急：幾秒一次已經好夠，查得太密只會白耗請求。
• 下載連結有時效：新鮮生成嘅連結有效期七日，Bot 收到之後應該即刻下載音檔存好，唔好長期擺住條連結。
• 失敗要重試：偶爾會有任務失敗，Bot 自動重試一次，再唔得就喺頻道講聲抱歉，唔好靜靜地吞咗個任務。

第四步：上載返頻道

攞到音檔之後，將佢上載返去原本嘅頻道，配一句簡單說明——邊個要求、文字重點係咩。音檔出咗頻道，成員喺 Slack 度撳開就聽。呢一步仲有一個加分位：將「指令—音檔—文字稿」嘅對應記錄低，日後有人想對稿或者重新生成，都有據可查。

錯誤處理：五個一定會撞嘅狀況

Bot 係長期運行嘅系統，呢五個 API 錯誤一定會撞到，每個都要有對應策略：

特別講講最後兩個。請求限流係按每分鐘計，回應會話你知幾時可以再試，Bot 照做就得；在途任務上限就係方案級嘅並行配額——免費方案 3 個、入門 5 個、專業 10 個、工作室 20 個——團隊一多人用，Bot 就要自己做個小隊列，有空位先交新任務。呢兩個錯誤處理得好，Bot 先算係「生性」。各個錯誤碼嘅完整對照同處理範例，可以睇TTS API 錯誤碼對照。

隊列設計：多團隊共用一個 Bot

一個 Bot 服務成間公司嗰陣，最常見嘅問題唔係技術，係公平：某個部門一口氣提交二十段嘢，成個配額即刻畀佢佔晒。幾個簡單規則就可以防亂：

每人每次一段起、幾段止。 指令層面限制單次提交段數，大量內容畀佢分幾次入，自然形成節流。

先到先得，同一隊列。 全部任務入同一條 FIFO 隊列，按方案嘅在途上限放任務出去，唔畀任何人插隊。

長內容降級處理。 超過幾段的長稿，提示用戶行批量流程或者搵管理員，唔好佔住 Bot 嘅即時通道——Bot 嘅定位係「快而短」，唔係成套教材生產線。真係要大量生成，批量功能（專業或以上方案，一次最多 25 個任務）先係正路。

用量透明。 每週喺頻道出一次用量摘要，邊個組用咗幾多，一目了然，等大家都克制啲。

呢套規則唔使寫幾多代碼，但係決定咗 Bot 係「全公司鍾意嘅工具」定係「三個星期後冇人敢用嘅嘢」。

聲線策略：Bot 用邊把聲

Bot 嘅聲線係公司內部嘅「門面」，揀嗰陣有幾個原則：

一條主聲，兩三條副聲。 主聲做所有預設廣播——公告、摘要、政策宣讀——令大家一聽到就知道係「正式廣播時間」。副聲一至兩條，做培訓情景劇角色同慶祝場面，夠玩味但唔會搶走主聲嘅地位。

主聲要「耐聽」。 Bot 出嘅語音係日日聽嘅，太有性格嘅聲線聽耐會攰。揀清晰、中速、語氣平穩嘅聲線做主聲，特別場合先玩嘢。揀嗰陣用真實公告稿試聽，唔好用示範句——你嘅行業詞彙、同事名讀出嚟順唔順耳，一試就知。

語氣跟場合，唔使換聲。 平台嘅演繹風格設定可以喺同一條聲線上調語氣：政策宣讀用正式啲，慶祝場合用輕快啲。同一把聲唔同語氣，聽感新鮮但身份一致。

聲線設定寫入 Bot 配置。 主聲副聲嘅編號、語氣設定，全部寫入配置檔唔好 hardcode 喺代碼度。之後換聲線、調語氣，改配置就得，唔使掣肘代碼。

由零到上線：四個星期嘅務實節奏

Bot 唔使一口氣起晒，照住呢個節奏行，每個星期都有可以交付嘅嘢：

第一星期：行通四步。 用沙盒 Key 將「收指令—提交—輪詢—上載」行通，一條指令、一條主聲、出一段音檔已經算贏。呢個階段唔好諗錯誤處理同隊列，先證明條路係通嘅。

第二星期：錯誤處理同防守。 將五個必撞錯誤嘅對應策略逐一寫入去，加埋輸入清理同長度限制。呢個星期完結，Bot 已經可以畀幾個同事試用而唔怕佢撞爆。

第三星期：細組試運行。 開放畀一個細組用，每兩三日睇一次記錄——咩內容用得多、啲指令點寫錯、聲線有咩意見——快速調整。呢個階段攞到嘅反饋，好過你坐喺度諗十次。

第四星期：開放同定規矩。 轉正式 Key、開放全公司、公佈使用約定（單次段數上限、適用頻道、用量透明），同時將每週用量摘要啟動。規矩一早講明，之後就少拗撬。

四個星期聽落長，其實每星期真正投入嘅時間可能得一兩日；慢係慢喺攞反饋，唔係慢喺寫代碼。

用沙盒 Key 由細做起

Bot 由構思到上線，唔建議一開始就用正式配額亂試。正路係咁行：

1. 沙盒 Key 起步：免費同入門方案都可以開沙盒 Key，每日 20 個生成請求——淨係計提交，輪詢同下載唔計——驗證四步流程啱啱好。
2. 先過流程再過細節：第一個版本收指令、出音檔就得；錯誤處理、隊列、用量統計，第二步先加。
3. 細範圍試運行：搵一個細組做白老鼠一兩星期，攞真實反饋——聲線啱唔啱口、幾時用得多——再調整。
4. 升正式 Key 開放全公司：流程跑順、反饋消化晒，先轉正式 Key 開放。升級方案之後，原有 Key 嘅模式會跟方案即時生效，唔使重新開過。

另外一個思路係將 Bot 同 AI Agent 工具鏈打通，令 Agent 都可以經 MCP 調用語音能力，Bot 只係其中一個介面——呢個做法適合已經有 Agent 生態嘅團隊，詳細可以睇MCP 接入粵語 TTS 教學。

成本同方案：Bot 運行要幾多配額

用每分鐘約 240 字符換算，Bot 嘅典型用量係咁：一段 500 字符公告約兩分鐘語音；每日一段公告加每週一段三分鐘摘要，一個月大約 25,000 至 30,000 字符——入門方案每個帳單週期 200,000 字符，養起幾個部門嘅 Bot 都有突。換個講法，成個部門一個月嘅語音廣播量，成本仲平過開一個下午茶會議。

真正要升級嘅訊號係並行量：同事開始輪住等在途任務位、或者要行批量流程，就係時候升專業方案（在途 10 個、批量 25 個任務）。平台冇超額收費，配額用完就完，Bot 撞到配額上限嗰陣照實同用戶講，唔會有意外帳單。API 同網頁介面共用配額，所以 Bot 嘅用量記得一同事入全公司嗰盤數度計。

常見問題 FAQ

唔識寫程式，可以整 Slack 語音 Bot 嗎？

Bot 核心確實要少少程式——收指令、調 API、上載檔案三段邏輯。不過要求好入門：任何可以發 HTTP 請求嘅語言都得，照住快速上手教學行，有程式底嘅同事半日就砌到第一版。完全冇程式資源嘅團隊，可以用「人手流程」代替：喺語音平台生成、下載、手動放上 Slack，冇 Bot 咁順，但即刻用得。

一段語音最長可以去到幾長？

單次請求上限 500 字符，以每分鐘約 240 字符計，約等於兩分鐘旁白。要長啲，就按段落切段逐段生成，喺頻道度一段段排——Slack 度多段音檔順序排好，聽落就似一集節目。

員工會唔會亂用 Bot 生成不當內容？

指令層面可以做基本把關：限制長度、保留提交紀錄、指定邊個頻道先出聲。再加埋每週用量透明化，一般已經夠。真係要收緊，可以將 Bot 設做只接受指定名單嘅用戶指令。

任務提交咗之後，要等幾耐？

平台係非同步處理：提交之後排隊，完成先有下載連結，唔同時段排隊深度有起伏。Bot 嘅正確做法係輪詢任務狀態、完成先攞檔，並且喺頻道話畀用戶知「搞緊，一陣出聲」，體驗就已經好好。

可以畀用戶自己揀聲線嗎？

可以。Bot 提交任務嗰陣帶聲線選擇就得，最順嘅做法係預選兩三條——例如一把正式、一把輕鬆——用戶用參數揀，唔好開成個聲線目錄佢揀，選擇太多反而拖慢使用。聲線目錄同試聽可以喺平台介面度慢慢試定。

Bot 撞到錯誤，點樣最快定位？

首先分清楚係 API 側定 Slack 側嘅事：API 回應嘅錯誤碼會話你知係缺參數、限流定配額滿，照對照表處理；Slack 側就多數係權限或者格式問題。建議 Bot 將兩邊嘅錯誤分開記錄，出事睇 log 一眼就分到。完整錯誤碼語義可以睇TTS API 錯誤碼對照。

[!CTA]

想令你嘅 Slack 頻道開得聲？

免費開戶即有體驗額度，貼一段你嘅公告稿入 playground，即刻試聽效果。