將 FastComments 連接至 Zapier
FastComments 的 Zapier 應用程式可在不撰寫程式碼的情況下，將您的評論連接到數千個其他應用程式。
您可以使用它在有人評論時發送 Slack 訊息、將每則評論記錄到試算表、從表單提交建立評論，或將評論者新增至您的 CRM。觸發器會在事件發生的瞬間即被觸發，因為它們是透過 webhook 而非輪詢實作，而動作則代表您呼叫 FastComments API。
本指南假設您已擁有 FastComments 帳戶。您可以在此建立帳戶。
連接您的帳戶 
連接您的帳戶
- 在 Zapier 中，將 FastComments 步驟新增至 Zap，或在 Zapier 應用程式目錄中開啟 FastComments 應用頁面。
- 選擇 Sign in to FastComments。Zapier 會先詢問您的區域：除非您的帳戶是在 EU 區域（
eu.fastcomments.com）建立，否則請選擇 United States。 - 會開啟 FastComments 視窗。如果您尚未登入，請登入。
- 檢視同意頁面。它會顯示 Zapier 應用程式、將要連接的帳戶，以及請求的權限（讀取與寫入）。選擇 Approve。
- Zapier 會儲存此連接，並以您的網站名稱與使用者名稱標記。
此連接使用 OAuth。沒有 API 金鑰會被複製到 Zapier，Zapier 持有的令牌僅適用於您已批准的帳戶。
誰可以連接
批准連接的人必須是 FastComments 帳戶的 API admin。帳戶擁有者具備此權限；其他團隊成員可在「使用者」頁面上被授予此權限。沒有此權限的人會看到「you do not have permission」頁面，而非同意表單。
連接正確的站點
同意頁面會連接您目前已登入的帳戶。如果您管理多個帳戶，請在批准之前從帳戶切換器切換至正確的帳戶，或使用同意頁面上的 switch account 連結。Zapier 中的連接標籤會顯示站點名稱，因此錯誤的選擇很容易被發現。
檢視與撤銷存取
每個連接都會顯示在 FastComments 儀表板的 Connected Apps 下，並列出其擁有的權限以及最後使用時間。在那裡撤銷連接會立即斷開 Zapier；任何使用該連接的 Zap 都會停止，直到重新連接。您也可以在 Zapier 的 My Apps 中移除該連接。
觸發器
Triggers
Triggers start a Zap when something happens in FastComments. All three are instant: FastComments delivers the event to Zapier through a webhook the moment it happens. Nothing polls your account and no API credits are spent waiting.
| 觸發器 | 觸發時機 |
|---|---|
| New Comment | 發表了一則評論。預設情況下，僅已批准且非垃圾評論會觸發。 |
| Updated Comment | 評論被編輯、批准、投票、置頂、鎖定或以其他方式變更。 |
| Deleted Comment | 評論被刪除。 |
Each trigger returns the full comment: id, page URL and URL ID, commenter name and email, the comment text as markdown and as HTML, vote counts, approval and spam flags, the locale, the domain, and any mentions. The fields match the webhook payload documented under Webhooks, Data Structures.
Options
Domain. Every trigger has an optional domain filter, listing the domains configured on your account. Leave it blank to receive events from every domain.
Include Unapproved and Spam Comments. On the New Comment trigger only. Comments that are held for moderation or marked as spam are skipped by default. When such a comment is approved later, the Updated Comment trigger fires for it, so a Zap that should react to every comment that becomes visible uses Updated Comment with a filter on the approved field.
How delivery works
Turning a Zap on creates a webhook subscription on your account, visible on the Webhooks page with the source API. Turning the Zap off removes it. Zapier's own limits apply to how many events it accepts per minute; FastComments retries a delivery that fails, with a growing delay, and disables a subscription that keeps failing for six days. A disabled subscription can be re-enabled from the Webhooks page, or simply turn the Zap off and on again to create a fresh one.
An account can hold up to 50 API subscriptions. Each Zap using a FastComments trigger uses one.
操作與搜尋
動作與搜尋
動作會在 FastComments 中建立資料；搜尋則會查找資料，以便後續步驟使用。每個動作都會呼叫 FastComments REST API，並消耗與您自行程式碼呼叫相同的 API 點數：每次呼叫消耗 1 點，除非另有說明。
建立評論
在頁面上發表評論。
| Field | Required | Notes |
|---|---|---|
| Page URL ID | Yes | 評論小工具在頁面上使用的 URL ID，評論會依此分組。 |
| Page URL | Yes | 完整的頁面 URL，用於通知電子郵件。 |
| Comment | Yes | FastComments markdown 格式的評論內容。 |
| Commenter Name | Yes | 名稱在每個電子郵件下必須唯一，若使用相同名稱但不同電子郵件會失敗。 |
| Commenter Email | No | 若該電子郵件尚未存在，系統會為其建立使用者。 |
| User ID | No | 已存在的 SSO 使用者 ID。會優先於名稱與電子郵件。 |
| Parent Comment ID | No | 設定以發表回覆。 |
| Approved, Verified | No | 兩者預設為 true。未批准的評論會保持隱藏，直到被審核。 |
| Posted At | No | 預設為現在時間。 |
| Avatar URL, Page Title, Locale | No | 語系預設為 en_us。 |
| Show Live In Widget | No | 即時將評論推送給觀眾。耗費 2 點而非 1 點。 |
| Run Spam Check, Send Emails | No | 預設為關閉。 |
建立頁面
在任何評論出現之前建立頁面記錄，以便能夠列出與限制。需要提供 URL ID、標題、URL，並可選擇允許查看的 SSO 群組 ID。
建立 SSO 使用者
建立單一登入使用者。需要提供您自己的使用者 ID、使用者名稱與電子郵件，並可選擇顯示名稱、顯示標籤、頭像、網站、群組 ID，以及通知與隱私旗標。管理員角色無法透過 Zapier 授予。
建立動態貼文
從 HTML 內容在 FastComments 動態中建立貼文，可選擇提供標題、作者、標籤，以及一個連結預覽。
建立雜湊標籤
建立評論者可使用的雜湊標籤，可選擇提供其連結的 URL。
標記評論
將評論標記為需要審核。提供執行標記的使用者 ID，或留空以使用 Zapier 整合的身分標記。
搜尋
| Search | Input | Returns |
|---|---|---|
| Find Comment | Comment ID | 該評論，或無結果。 |
| Find SSO User | 該 SSO 使用者，或無結果。 | |
| Find Page | URL ID | 該頁面，或無結果。 |
搜尋不到結果不會使 Zap 失敗。可在 Zapier 的 "find or create" 模式中將搜尋與建立結合，於缺少頁面或使用者時自動建立。
範例 Zaps
範例 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 頁面設定完畢後，域名即會出現在下拉選單。若將此欄位留空，將接收所有域名的事件。