以自訂連接器連線 Power Automate
透過 OpenAPI 檔案把 Marcomm AI 連接器匯入你的 Power Automate 環境,再以個人 API 金鑰在流程中執行 Marcomm AI 動作。
- 1在 Marcomm 中開啟設定 → 整合 → Power Automate,查看目前狀態與所需的值。

Power Automate 頁面顯示目前狀態、步驟、要複製的值,以及此工作區的 API 存取是否已核准。 - 2開啟設定 → API。如果工作區還沒有 API 存取權限,由擁有者或管理員填寫申請 API 存取權限並選擇送出申請。
- 3核准後開啟建立金鑰,選擇個人金鑰,勾選所需的範圍,再選擇建立金鑰。金鑰只顯示一次,請立即複製。
- 4在 Power Automate 中開啟 Custom connectors,依序選擇 New custom connector 與 Import an OpenAPI from URL,輸入
https://marcomm.works/api/v1/openapi.json。 - 5在 Security(安全性)步驟選擇 API Key,參數名稱設為
Authorization,位置設為 Header(標頭),然後建立連接器。 - 6流程要求連線時,依序輸入
Bearer、一個空格與金鑰。
發布與寄送步驟無法復原,請先用草稿測試。
此連接器不在 Microsoft 連接器清單中。你從 OpenAPI 檔案把它匯入自己的環境,因此它的動作與 API 一致:讀取新聞與核准,建立與更新新聞稿、部落格文章、媒體活動與 RSVP 邀請函,提出核准請求,核准或退回,以及發布與寄送。它只有動作,沒有觸發程序。
範圍決定金鑰能做什麼。內容(content)讀取新聞稿、部落格文章與媒體活動,撰寫內容(content:write)建立與編輯草稿,發布與寄送(distribution)發布並以電子郵件寄送,核准(approvals)處理核准步驟。後三項只能用於個人金鑰,因為操作會記錄在建立金鑰的人名下。工作區金鑰只能讀取,每把金鑰都依建立者的角色與權限執行。
發布與寄送無法復原。只有請求帶有 confirm: true 或 Idempotency-Key 標頭時,API 才會執行;如果仍需核准,或內容已排程發布、處於禁發期,API 不會發布並回傳 409。用同一個 Idempotency-Key 重送同一請求時,24 小時內不會再次執行,而是回傳第一次的結果。連接器中的這些動作有 confirm 欄位與 Idempotency-Key 欄位。
Team 方案以上可以使用 API。Marcomm AI 團隊會逐一審核申請,金鑰在核准後才能使用。金鑰只能包含工作區已核准的範圍,每人最多可建立 10 把金鑰。預設上限為每個工作區每分鐘 60 次、每天 10,000 次,超過後 API 會回傳 429 與 Retry-After 標頭。如需提高上限,請使用設定 → API中的需要更高的上限嗎?。要中斷 Power Automate,請選擇金鑰旁的撤銷,使用該金鑰的系統會立即失去存取權限。
常見問題
以
Authorization: Bearer加金鑰的標頭呼叫GET https://marcomm.works/api/v1/me。只要金鑰已核准,不論範圍都能使用,並回傳工作區、金鑰名稱與金鑰的範圍。金鑰不會記錄由哪個服務使用,因此 Marcomm 不會把 Power Automate 卡片標為已連接。每把金鑰的最後使用時間可在設定 → API中查看。
這個連接器做不到,因為它只有動作。請用排程等其他觸發程序啟動流程,再用清單動作讀取最新項目。