將 FastComments 連接至 Zapier

連接您的帳戶

1. 在 Zapier 中，將 FastComments 步驟加入 Zap,或在 Zapier App Directory 中開啟 FastComments 應用程式頁面。
2. 選擇 Sign in to FastComments。Zapier 會先詢問您的地區：除非您的帳戶是在歐盟地區(eu.fastcomments.com)建立的，否則請選擇 United States。
3. 會開啟一個 FastComments 視窗。如果您尚未登入，請先登入。
4. 檢視同意頁面。它會顯示 Zapier 應用程式、將被連接的帳戶，以及所請求的權限(讀取與寫入)。選擇 Approve。
5. Zapier 會儲存此連接，並以您的網站名稱與使用者名稱標記它。

此連接使用 OAuth。不會將任何 API 金鑰複製到 Zapier 中，且 Zapier 持有的權杖僅適用於您核准的帳戶。

誰可以連接

核准連接的人必須是 FastComments 帳戶上的 API admin。帳戶擁有者具備此權限；其他團隊成員可以在 Users 頁面上被授予此權限。沒有此權限的人會看到「您沒有權限」的頁面，而不是同意表單。

連接正確的網站

同意頁面會連接您目前登入的帳戶。如果您管理多個帳戶，請在核准前從帳戶切換器切換到正確的帳戶，或使用同意頁面上的 switch account 連結。Zapier 中的連接標籤會顯示網站名稱，因此錯誤的選擇很容易被發現。

檢視與撤銷存取權

每個連接都會顯示在 FastComments 儀表板的 Connected Apps 下方，並顯示其所持有的權限以及最後使用時間。在那裡撤銷連接會立即中斷 Zapier;任何使用該連接的 Zap 都會停止，直到重新連接為止。您也可以在 Zapier 端的 My Apps 下方移除該連接。

觸發條件

觸發條件會在 FastComments 中發生某些事情時啟動 Zap。這三個觸發條件都是即時的：事件一發生，FastComments 就會透過 webhook 將事件傳送給 Zapier。不會輪詢您的帳戶，也不會在等待時消耗任何 API 額度。

每個觸發條件都會傳回完整留言：id、頁面 URL 與 URL ID、留言者姓名與電子郵件、以 markdown 與 HTML 格式呈現的留言內容、投票數、核准與垃圾留言標記、語系設定、網域，以及任何提及。這些欄位與 Webhooks、Data Structures 文件中記載的 webhook 負載一致。

選項

網域。 每個觸發條件都有選用的網域篩選器，列出您帳戶上設定的網域。留空即可接收來自所有網域的事件。

包含未核准與垃圾留言。 僅適用於 New Comment 觸發條件。被留待審核或標記為垃圾的留言預設會被略過。當此類留言稍後被核准時，Updated Comment 觸發條件會為其觸發，因此若要對每則變為可見的留言做出反應的 Zap，應使用 Updated Comment 並對 approved 欄位設定篩選條件。

傳送機制說明

開啟 Zap 會在您的帳戶上建立一個 webhook 訂閱，可在 Webhooks 頁面上看到，來源為 API。關閉 Zap 則會移除該訂閱。Zapier 自身的限制適用於其每分鐘接受的事件數量；FastComments 會以遞增延遲重試失敗的傳送，並在訂閱持續失敗六天後將其停用。已停用的訂閱可以從 Webhooks 頁面重新啟用，或只需關閉再開啟 Zap 即可建立新的訂閱。

一個帳戶最多可容納 50 個 API 訂閱。每個使用 FastComments 觸發條件的 Zap 會佔用一個。

動作與搜尋

動作會在 FastComments 中建立資料；搜尋則會查找資料，以便後續步驟使用。每個動作都會呼叫 FastComments REST API，並消耗與您自行程式碼呼叫相同的 API 點數：每次呼叫消耗 1 點，除非另有說明。

建立評論

在頁面上發表評論。

建立或更新頁面

在任何評論出現之前先建立頁面記錄，讓它可以被列出與受限。需要提供 URL ID、標題、URL，並可選擇允許檢視的 SSO 群組 ID。若已存在相同 URL ID 的頁面，會以提供的欄位更新該頁面，讓 Zap 能對同一頁面重複執行。

建立或更新 SSO 使用者

建立單一登入（SSO）使用者。需要您自己的使用者 ID、使用者名稱與電子郵件，並可選擇顯示名稱、顯示標籤、頭像、網站、群組 ID，以及通知與隱私旗標。若該 ID 已存在，則改為更新。管理員角色無法透過 Zapier 授予。

建立 Feed 文章

從 HTML 內容在 FastComments Feed 中建立文章。必須提供作者使用者 ID（FastComments 或 SSO 使用者 ID）；標題、標籤與一個連結預覽為可選項目。

建立或更新雜湊標籤

建立評論者可使用的雜湊標籤，並可選擇其連結的 URL。若標籤已存在，則改為更新。

標記評論

將評論標記為需要審核。需要提供執行標記的使用者 ID；可使用「建立評論」回傳的作者 ID。

搜尋

找不到結果的搜尋不會使 Zap 失敗。Find SSO User 與 Find Page 提供 Zapier 的「若不存在則建立」選項，當找不到時會執行相對應的建立動作。

範例 Zaps

只需幾分鐘即可設定的工作流程。

取得新評論的通知。 新評論，接著使用 Slack「傳送頻道訊息」或 Discord「傳送頻道訊息」。將評論者名稱、評論內容與頁面 URL 映射到訊息中。加入網域過濾條件，以便每個站點通知不同的頻道。

保留每則評論的日誌。 新評論，接著使用 Google Sheets「建立試算表列」。將已刪除評論作為第二個 Zap，將評論 ID 追加為一列，讓試算表同時充當稽核追蹤。

當評論獲准時寄送電子郵件給作者。 使用「已更新評論」搭配 Zapier 篩選條件「Approved 為 true」，然後使用 Gmail「傳送電子郵件」。由於「已更新評論」會在每次變更時觸發，篩選條件使此 Zap 只對批准的情況作出回應。

將評論者加入您的 CRM 或郵件列表。 新評論，接著使用 HubSpot「建立或更新聯絡人」或 Mailchimp「新增或更新訂閱者」，使用評論者的電子郵件。加入任何人至行銷名單前，請遵守您的隱私政策與當地法規。

從表單建立評論。 Typeform 或 Google Forms「新回應」，接著使用 FastComments「建立評論」，並提供您網站用於見證的頁面 URL ID。將 Approved 保持未勾選，以便在評論顯示前先審核。

將公告發佈到資訊源。 Zapier 的 RSS「資訊源中新項目」，接著使用「建立資訊源貼文」，提供項目的標題、內容與連結。

將會員配置為 SSO 使用者。 使用 Memberstack、Memberful 或您自己的 webhook，接著「尋找 SSO 使用者」再以「尋找或建立」模式「建立 SSO 使用者」。

升級被舉報的評論。 「已更新評論」經過旗標計數大於零的篩選，接著使用 Trello「建立卡片」或 Linear「建立議題」，並附上評論 ID 與審核頁面的連結。

在頁面上線時即發佈。 WordPress 或 Ghost「新文章」，接著「建立頁面」並使用文章 URL，讓頁面在第一則評論出現前即被列出並受限。

歸檔已刪除的評論。 「已刪除評論」，接著使用 Airtable「建立記錄」，將完整評論內容存入以符合保存規範。

疑難排解

連線時出現「You do not have permission」。 目前登入的使用者不是該帳戶的 API 管理員。 請帳戶擁有者在「Users」頁面授予 API 權限，或以擁有者身分連線。

連線標示的網站錯誤。 同意頁面連線的是您當時登入的帳戶。請在 Zapier 中斷連線，在 FastComments 儀表板中切換帳戶，然後重新連線。

事件停止送達。 請檢查儀表板中的「Webhooks」頁面。若某個訂閱的端點連續失敗六天，系統會自動將其停用並顯示原因。您可以在該處重新啟用，或將 Zap 關閉再開啟。如果訂閱完全消失，表示有人將其刪除；將 Zap 關閉再開啟即可重新建立。

Zapier 顯示帳戶需要重新連線。 連線已從「Connected Apps」頁面被撤銷、核准連線的使用者失去了 API 權限，或帳戶已被刪除。請從 Zapier 重新連線。

動作失敗並顯示「does not have write access」。 連線當時僅以唯讀權限核准。請重新連線並核准兩項權限。

速率限制與點數。 動作與搜尋會消耗您方案中的 API 點數，並受到與 REST API 相同的速率限制。觸發器則不消耗任何點數。當 Zap 達到限制時，Zapier 會在 FastComments 回報的延遲時間後重試。

「Domain」下拉選單是空的。 網域只有在 FastComments 儀表板的「Domains」頁面中設定後才會顯示。將該欄位留空即可接收所有網域的事件。