Waitlist
Waitlist 是一個 SaaS 應用程式,讓企業能為產品發布或活動建立並管理候補名單,協助他們捕捉潛在客戶並營造期待感。主要使用者為行銷團隊與產品經理。
官方文件:https://developers.waitlist.com/
Waitlist 概覽
- 候補名單
- 參與者
- 表單
- 設定
視需要使用的動作名稱與參數。
使用 Waitlist
本技能使用 Membrane CLI 與 Waitlist 互動。Membrane 會自動處理認證與憑證刷新,讓您能專注於整合邏輯而非認證細節。
安裝 CLI
安裝 Membrane CLI 以便從終端機執行 membrane:
npm install -g @membranehq/cli@latest
認證
membrane login --tenant --clientName=<agentType>
此指令會根據互動模式是否可用,開啟瀏覽器進行認證,或將授權 URL 列印到終端機。
無頭環境: 此指令會印出一個授權 URL。請使用者在其瀏覽器中開啟該 URL。當他們完成登入後看到一組驗證碼時,請執行以下指令完成流程:
membrane login complete <code>
在任何指令後加上 --json 可取得機器可讀的 JSON 輸出。
代理類型: claude、openclaw、codex、warp、windsurf 等。這些類型會用於調整工具以最佳配合您的 Harness。
連接到 Waitlist
使用 membrane connection ensure 透過應用程式 URL 或網域來尋找或建立連線:
membrane connection ensure "http://getwaitlist.com/" --json
使用者在瀏覽器中完成認證。輸出內容包含新的連線 ID。
這是取得連線最快的方式。URL 會被正規化為網域,並與已知的應用程式比對。若找不到對應應用程式,則會建立一個新的應用程式,並自動建構對應的連接器。
如果傳回的連線狀態為 "READY",請跳到步驟 2。
1b. 等待連線就緒
如果連線處於 BUILDING 狀態,請輪詢直到就緒:
npx @membranehq/cli connection get <id> --wait --json
--wait 旗標會進行長時間輪詢(最長 --timeout 秒,預設 30 秒)直到狀態變更。持續輪詢直到 state 不再是 BUILDING。
結果狀態告訴您下一步該做什麼:
-
READY— 連線已完全設定完畢。跳到步驟 2。 -
CLIENT_ACTION_REQUIRED— 使用者或代理需要採取某些行動。clientAction物件描述了所需的動作:clientAction.type— 所需動作的類型:"connect"— 使用者需要進行認證(OAuth、API 金鑰等)。涵蓋初始認證與重新認證已斷開的連線。"provide-input"— 需要更多資訊(例如要連接到哪個應用程式)。
clientAction.description— 人類可讀的動作說明。clientAction.uiUrl(可選)— 預先建置的使用者介面 URL,使用者可在此完成動作。若存在則向使用者顯示。clientAction.agentInstructions(可選)— 給 AI 代理的指示,說明如何以程式化方式進行。
使用者完成動作後(例如在瀏覽器中進行認證),請再次使用
membrane connection get <id> --json輪詢以檢查狀態是否變為READY。 -
CONFIGURATION_ERROR或SETUP_FAILED— 發生錯誤。請檢查error欄位以取得詳細資訊。
搜尋動作
使用自然語言描述您想做的事來進行搜尋:
membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json
您應始終在特定連線的上下文中搜尋動作。
每個結果包含 id、name、description、inputSchema(動作接受的參數)以及 outputSchema(動作回傳的內容)。
熱門動作
使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 來探索可用的動作。
執行動作
membrane action run <actionId> --connectionId=CONNECTION_ID --json
若要傳遞 JSON 參數:
membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json
結果位於回應中的 output 欄位。
代理請求
當可用的動作無法滿足您的需求時,您可以透過 Membrane 的代理直接傳送請求到 Waitlist API。Membrane 會自動將基底 URL 附加到您提供的路徑,並注入正確的認證標頭 — 包括在憑證過期時進行透明的刷新。
membrane request CONNECTION_ID /path/to/endpoint
常用選項:
| 旗標 | 說明 |
|---|---|
-X, --method | HTTP 方法(GET、POST、PUT、PATCH、DELETE)。預設為 GET |
-H, --header | 新增請求標頭(可重複),例如 -H "Accept: application/json" |
-d, --data | 請求主體(字串) |
--json | 簡寫方式,用於傳送 JSON 主體並設定 Content-Type: application/json |
--rawData | 原樣傳送主體,不做任何處理 |
--query | 查詢字串參數(可重複),例如 --query "limit=10" |
--pathParam | 路徑參數(可重複),例如 --pathParam "id=123" |
最佳實務
- 始終優先使用 Membrane 與外部應用程式溝通 — Membrane 提供預先建置的動作,內建認證、分頁與錯誤處理。這會消耗較少的 token,並使通訊更加安全。
- 先探索再建置 — 在撰寫自訂 API 呼叫之前,先執行
membrane action list --intent=QUERY(將 QUERY 替換為您的意圖)來尋找現有的動作。預先建置的動作能處理分頁、欄位對應以及原始 API 呼叫遺漏的邊界情況。 - 讓 Membrane 處理憑證 — 絕對不要向使用者索取 API 金鑰或 token。請建立連線;Membrane 會在伺服器端管理完整的認證生命週期,不留存任何本機祕密。