跳到主要內容

以個人 API 金鑰連線 Zapier

使用 Zapier 的 Marcomm AI 應用程式,從新聞稿、部落格文章與媒體活動啟動 Zap,並建立、發布與寄送它們。此應用程式僅限受邀使用。

  1. 1
    在 Marcomm 中開啟設定 → 整合 → Zapier,查看目前狀態與所需的值。
    設定、整合、Zapier 頁面,顯示狀態、連線步驟、需勾選的範圍與 API 存取狀態
    Zapier 頁面顯示目前狀態、步驟、要複製的值,以及此工作區的 API 存取是否已核准。
  2. 2
    開啟設定 → API。如果工作區還沒有 API 存取權限,由擁有者或管理員填寫申請 API 存取權限並選擇送出申請。
  3. 3
    核准後開啟建立金鑰,選擇個人金鑰,勾選所需的範圍,再選擇建立金鑰。金鑰只顯示一次,請立即複製。
  4. 4
    開啟 Marcomm AI 寄來的邀請連結,把 Marcomm AI 應用程式加入你的 Zapier 帳號。
  5. 5
    建立 Zap,選擇 Marcomm AI 作為觸發條件或動作,Zapier 要求連線時,把金鑰貼到 API Key(API 金鑰)。

發布與寄送步驟無法復原,請先用草稿測試。

此應用程式尚未進入 Zapier 公開目錄,需要 Marcomm AI 的邀請連結。它有七個觸發條件:New Press Release、Press Release Approval Requested、Press Release Published、New Blog Post、Blog Post Published、New Press Event 與 RSVP Invite Updated。動作可以建立、更新新聞稿、提出核准請求、發布與寄送新聞稿,建立並發布部落格文章,建立媒體活動,以及建立 RSVP 邀請函、加入收件人與寄送。兩個搜尋可找出新聞稿或部落格文章。

範圍決定金鑰能做什麼。內容(content)讀取新聞稿、部落格文章與媒體活動,撰寫內容(content:write)建立與編輯草稿,發布與寄送(distribution)發布並以電子郵件寄送,核准(approvals)處理核准步驟。後三項只能用於個人金鑰,因為操作會記錄在建立金鑰的人名下。工作區金鑰只能讀取,每把金鑰都依建立者的角色與權限執行。

發布與寄送無法復原。只有請求帶有 confirm: true 或 Idempotency-Key 標頭時,API 才會執行;如果仍需核准,或內容已排程發布、處於禁發期,API 不會發布並回傳 409。用同一個 Idempotency-Key 重送同一請求時,24 小時內不會再次執行,而是回傳第一次的結果。每個寫入步驟都會送出由 Zap 與輸入值產生的冪等金鑰。如果要在 24 小時內刻意重複完全相同的步驟,請在 Repeat Key 填入每次執行都不同的值。

Team 方案以上可以使用 API。Marcomm AI 團隊會逐一審核申請,金鑰在核准後才能使用。金鑰只能包含工作區已核准的範圍,每人最多可建立 10 把金鑰。預設上限為每個工作區每分鐘 60 次、每天 10,000 次,超過後 API 會回傳 429 與 Retry-After 標頭。如需提高上限,請使用設定 → API中的需要更高的上限嗎?。要中斷 Zapier,請選擇金鑰旁的撤銷,使用該金鑰的系統會立即失去存取權限。

常見問題

以 Authorization: Bearer 加金鑰的標頭呼叫 GET https://marcomm.works/api/v1/me。只要金鑰已核准,不論範圍都能使用,並回傳工作區、金鑰名稱與金鑰的範圍。

金鑰不會記錄由哪個服務使用,因此 Marcomm 不會把 Zapier 卡片標為已連接。每把金鑰的最後使用時間可在設定 → API中查看。

不行。Zapier 應用程式可以提出核准請求,由核准者在 Marcomm 中決定。透過 API,可以用帶有核准範圍的個人金鑰核准或退回。

整合