SocialHub.AI
開發者中心 · 開放擴充性

Zapier & Make 連接器

無需編寫程式碼即可將 Flash 連接到數千個應用程式。在 Zapier 或 Make 中,Flash 事件可以在任何位置啟動工作流程,而這些工作流程可以將資料推送回 Flash。 無需單獨安裝整合:連接器基於相同的 Webhook 和 v2 REST API 構建,相關文件請參見此處。

映射方式

三個部分,全部已經建好

每個無程式碼自動化流程都由觸發器、一個或多個操作以及身份驗證方法組成。 Flash 透過其現有平台介面提供所有這三項功能。

觸發器 = webhook 事件

連接器的觸發清單就是即時事件目錄——成員創建、等級升級、訂單下達等等。

操作 = v2 端點

操作會呼叫v2 REST 端點 — 建立會員、獎勵積分、發放優惠券、新增自訂object 記錄。

Auth = 作用域的 API 金鑰

連接器使用以 Authorization: Bearer 形式傳送的 fl_live_ 金鑰進行驗證,其作用域僅限於所需的操作和事件。

觸發器 — 底層原理

REST Hook 合約

Zapier 的 REST Hook 模型(以及 Make 的即時觸發器)直接對應到 Flash webhook 端點-無需額外的後端。 REST Hook 訂閱一個事件;當使用者關閉 Zap 時,它取消訂閱。所有三個生命週期步驟都使用 webhooks:manage 鍵。

REST 連線步驟Flash調用筆記
subscribePOST /api/v2/webhooks{ url, eventTypes: [event] } → 回應 data.id 是訂閱 ID。
unsubscribeDELETE /api/v2/webhooks/{id}訂閱時儲存的 id。
perform(交付的 POST 正文)當事件觸發時,精簡有效負載 Flash 將執行。
# subscribe (what the connector does when a Zap turns on)
curl -X POST https://flash.socialhub.ai/api/v2/webhooks \
  -H "Authorization: Bearer fl_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://hooks.zapier.com/...", "eventTypes": ["member.created"] }'
# 201 { "data": { "id": "whe_..." } }   <-- stored as the subscription id

# unsubscribe (Zap turned off)
curl -X DELETE https://flash.socialhub.ai/api/v2/webhooks/whe_... \
  -H "Authorization: Bearer fl_live_..."
操作

將資料推送回 Flash

一個操作其實就是呼叫 v2 端點,並指定鍵的作用域。只需為連接器的鍵提供所需的內容即可——例如,使用 members:write 建立成員,或使用 objects:write 新增自訂 object 記錄—每次呼叫都會像其他任何 API 請求一樣進行驗證和稽核。

# example action: upsert a member when something happens in another app
curl -X POST https://flash.socialhub.ai/api/v2/members \
  -H "Authorization: Bearer fl_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "fullName": "Ada Lovelace" }'

在 Account → API Keys 中建立金鑰並確定其範圍。瀏覽 REST API 參考 中的每個可用操作。