afrikyol/workyol

workyol 是做什麼的？

Workyol 是一套在使用者自己電腦上執行的程式。它與 Meta 的官方平台（WhatsApp Business Platform、Instagram、Messenger）、LinkedIn API 以及（在開放區域）YouTube API 協作。此技能說明如何使用其 MCP 工具。

使用時機

當使用者想要以下操作時使用此技能：

• 向已選擇加入的聯絡人清單發送 WhatsApp 範本行銷活動；
• 讀取未讀回覆（WhatsApp、Instagram、Messenger）並回覆；
• 新增關鍵字自動回覆，或留言轉私訊規則；
• 排程 Reels、照片或輪播（Instagram 和 Facebook）、LinkedIn 貼文或 YouTube 影片；
• 檢查其 Workyol 設定或號碼狀態。

請勿用於未同意被聯絡的使用者。

需求

1. Workyol 已安裝並在電腦上執行中（它在 localhost:4747 上啟動）。
2. Workyol 的 MCP 伺服器已連線至此助手（請參閱 README：在 Workyol 中，連線，AI 助手，點擊應用程式旁的連線）。

每次工作階段的第一步： 呼叫 check_setup（檢查設定中已完成/缺少的項目）和 get_overview（聯絡人、訊息、未讀回覆、等待中的貼文）。如果這些工具不存在或回應「Workyol 未執行」，請停止並告知使用者啟動 Workyol 並連線 MCP 伺服器。請勿自行猜測。

大多數工具接受一個可選的 account 參數（名稱、Facebook 粉絲專頁或 @instagram）；若未提供，則使用預設帳戶。當有多個品牌或客戶時，請先使用 list_accounts。

工具

概覽與設定

• list_accounts：列出帳戶（品牌/客戶）及其各自已連線的項目。
• get_overview：聯絡人、已傳送/已送達/已讀取訊息、未讀回覆、已連線的粉絲專頁/Instagram/WhatsApp、等待中的貼文。
• check_setup：檢查設定中已完成和缺少的項目（授權、正式模式、Meta 應用程式、WhatsApp、粉絲專頁 + Instagram、Webhook）。用來告知使用者下一步動作。
• quick_connect：透過使用者在 Graph API Explorer 中複製的權杖，一步將客戶的 Facebook 粉絲專頁（及其 Instagram）連線為 Workyol 帳戶。參數：token、name、business_type（general、dental、realestate、wholesale、restaurant、salon、school、none）、page_id、language（en、fr、tr、ar、es）、confirm。會自動新增已關閉狀態的預設自動化流程。

收件匣

• list_replies：列出使用者傳送的訊息，最新者優先，按人分組。參數：unread_only、limit。
• send_reply：在同一頻道上回覆一個人。參數：channel（whatsapp、instagram、messenger）、to（來自 list_replies 的值）、text、confirm。WhatsApp 僅允許在使用者最後一則訊息後的 24 小時內發送自由文字。

自動化

• list_automations：列出關鍵字自動回覆和留言轉私訊規則。
• add_automation：參數 type（auto_reply 或 comment_to_dm）、keywords、channel、reply（auto_reply）、file_link（可選的圖片、影片、音訊或 PDF 的 https 連結）、private_message 和 public_reply（comment_to_dm）、name、confirm。文字中的 {name} 會替換為使用者的名字。

WhatsApp 行銷活動

• list_contact_lists：列出同意接收訊息的聯絡人清單。
• list_templates：列出 Meta 已批准的 WhatsApp 範本（行銷活動僅能使用這些範本），以及其變數。
• list_campaigns：列出行銷活動及其已傳送/已送達/已讀取/失敗數。
• create_campaign：傳送或排程一個已批准的範本給已選擇加入的清單。參數：list_id、template_name、template_language、name、mapping、scheduled_at、confirm。不加 confirm 會返回預覽（多少人會收到、多少人被略過及原因）。

Instagram 和 Facebook 貼文

• list_posts：列出已排程和已發布的貼文（依 status 過濾：waiting、published、failed、all）。
• schedule_post：排程一個 Reel（video_path：垂直 MP4，9:16，最大 100 MB，可選 cover_path）或圖片（image_paths：1 張 = 照片，2 到 10 張 = 輪播；Instagram 僅接受 JPG）。另有 caption（最多 2200 字元）、at（含時區的 ISO 8601 格式）、platforms（instagram、facebook）、from_workyol_com、confirm。
• import_content_plan：從包含 CSV 試算表（欄位：日期、時間、說明文字、檔案、可選的頻道）和媒體檔案的資料夾中，排程整個計畫。不加 confirm 會列出每一列的狀態。同一列絕不會被排程兩次。
• delete_post：刪除已排程的貼文（已發布的貼文會留在線上）。

LinkedIn（使用者自己的個人檔案）

• linkedin_status：檢查是否已連線、剩餘存取天數（60 天，之後使用者需點擊重新連線）、等待中的貼文。
• linkedin_schedule_posts：排程一則或多則貼文。每則：text（最多 3000 字元，純文字，允許 Hashtag）、at、可選 media_path（JPG/PNG 圖片或 MP4）、可選 lang。每次呼叫最多 60 則貼文。
• linkedin_list_posts：列出已排程、已發布和失敗的貼文。
• linkedin_delete_post：刪除已排程的貼文（已發布的貼文會留在 LinkedIn 上）。

YouTube（僅限此授權開放 YouTube 時；撰寫此文時尚未對客戶開放，相關工具會回應「YouTube 尚未開放」）

• youtube_status、youtube_playlists、youtube_list、youtube_schedule（MP4/MOV，最大 2 GB；標題、說明、標籤、publish_at、privacy、thumbnail_path、playlist、first_comment；每個頻道每天 3 個上傳，額外影片會排入隔天）、youtube_delete。

工作流程

準備 WhatsApp 行銷活動

1. 呼叫 check_setup，然後 list_contact_lists 和 list_templates。
2. 與使用者一起選擇清單和一個已批准的範本。僅顯示已選擇加入的清單。
3. 呼叫 create_campaign 不加 confirm。顯示預覽：誰會收到、誰被略過及原因。
4. 只有在使用者同意的情況下，才再次呼叫並加上 confirm: true。如果他們想要稍後時間，可以提供 scheduled_at。
5. 稍後：使用 list_campaigns 報告已傳送/已送達/已讀取/失敗。

回覆未讀訊息

1. 使用 unread_only: true 呼叫 list_replies。
2. 按人員和頻道摘要。為每個人草擬回覆。
3. 顯示每個草稿。只有在使用者批准後，才使用 send_reply 和 confirm: true 發送每個回覆。
4. 在 WhatsApp 上，如果最後一則訊息已超過 24 小時，自由文字將會失敗：告知使用者需要使用範本。

新增關鍵字自動回覆或留言轉私訊

1. 呼叫 list_automations 以避免重複。
2. 以表格形式顯示規則（關鍵字、頻道、回覆內容）。
3. 在獲得同意後，使用 confirm: true 呼叫 add_automation。

排程一週的 Reels

1. 詢問影片檔案、說明文字和時間（含時區）。
2. 呼叫 list_posts 查看哪些正在等待。
3. 顯示完整的排程。在獲得同意後，為每個貼文呼叫 schedule_post 並加上 confirm: true。或者，對於包含 CSV 試算表的資料夾，使用 import_content_plan（先預覽）。

排程一個月的 LinkedIn 貼文

1. linkedin_status：如果未連線，或剩餘天數太少，告知使用者在 Workyol 中進行連線或重新連線。
2. 以純文字格式（無標記語言或粗體）撰寫貼文。將所有貼文及其日期顯示給使用者。
3. 在獲得同意後，使用 confirm: true 呼叫 linkedin_schedule_posts。

安全規則（務必遵守）

• 在使用者同意之前，絕不發送、發布或更改任何內容。 先在不加 confirm 的情況下呼叫工具，顯示摘要，並僅在該特定動作獲得明確同意後才傳遞 confirm: true。
• 僅限已選擇加入的清單。 行銷活動僅能發送給在 Workyol 中匯入時勾選了選擇加入方塊的聯絡人清單。沒有任何工具可以新增電話號碼。絕不向未要求的使用者發送訊息。
• 禁止垃圾郵件，禁止向陌生人發送大量訊息。尊重停止要求：回覆 STOP 的使用者將被 Workyol 略過。
• 你永遠不會看到存取權杖、應用程式密碼或授權金鑰。請勿要求取得它們。
• Workyol 自身的規則仍適用：WhatsApp 24 小時窗口、選擇退出機制、已批准的範本、授權限制，以及 Meta 的每日限制。
• Meta 僅允許企業回覆那些先在 Instagram 和 Messenger 上發送訊息的使用者。這些頻道上沒有行銷活動。
• 請勿承諾「不會被封號」等結果。僅說明 Workyol 使用官方 API。

範例提示

• 「檢查我的 Workyol 設定，告訴我少了什麼。」
• 「我有多少未讀回覆？摘要它們並草擬回覆。」
• 「準備一個 WhatsApp 行銷活動，使用已批准的範本 'order_ready'，目標是我的 'Customers 2026' 清單。先給我預覽。」
• 「新增一個自動回覆：當有人寫 CATALOG，用這段文字回答並發送我的 PDF。」
• 「當有人在貼文下留言 PRICE，傳送一則包含我們價格的私訊給他們。」
• 「將這 5 部影片排程為 Instagram 和 Facebook 的 Reels，每天一部在 18:00 發布。」
• 「從資料夾 C:\plans\november 匯入內容計畫並顯示預覽。」
• 「排程 12 篇關於牙科護理的 LinkedIn 貼文，每週兩篇，先讓我看過。