使用說明 使用說明
API 使用介紹

API 使用介紹

從外部啟動工作流、讓外部應用程式代表你使用對話與讀取文件、從網站呼叫外部 API,以及連接外部 MCP 伺服器。

本頁內容 6

這一部分說明網站和外部系統之間的五種連接方法:三種是外部系統呼叫網站,兩種是網站去呼叫外部系統。

從外部啟動工作流:Webhook 觸發

在工作流裡放一個「Webhook」觸發節點並儲存,這個工作流就有了一個公開的網址。工作流在「啟用中」時,外部系統用 HTTP 呼叫這個網址,工作流就會開始執行,呼叫帶來的標頭、查詢參數與內容,會變成工作流的第一筆資料。網站可以馬上回應,也可以等工作流跑完,再把結果回傳給呼叫端。

讓外部應用程式代表你:第三方應用程式

後台管理員登記過的外部應用程式,可以請你允許它代表你使用網站。網站會顯示授權頁,列出它要求的權限,由你選「允許」或「拒絕」。你允許之後,它會知道你的名字與電子郵件,並且只能使用你允許的對話、通知與文件權限,不能做其他事。

讓你自己的程式呼叫網站:個人權杖

在設定的「API 存取」分頁,你可以建立個人權杖,交給你自己寫的程式或工具。程式帶著它呼叫網站,網站就把這次呼叫當成是你。它和第三方應用程式一樣,只能用你勾選的對話、通知與文件權限,並知道你的名字與電子郵件。

從網站呼叫外部 API:「HTTP 請求」節點與憑證

工作流裡的「HTTP 請求」節點,會呼叫其他服務的 API,並把回應變成資料,交給下一個節點。對方要求身分驗證時,先把金鑰或密碼存成一個憑證,再在節點上選它。

讓 AI Agent 使用外部工具:外部 MCP 伺服器

每一個登入的人都可以連接外部的 MCP 伺服器,放在「私人」或自己所在的專案。連上之後,這台伺服器提供的工具會出現在它的「權限」清單開放給的 AI Agent 的工具窗格「可用工具」裡。把工具加入某個 AI Agent 並儲存之後,這個 AI Agent 在對話中就可以使用它們。

網站沒有的東西

  • 網站沒有另外給外部系統寫入文檔,或讀寫資料表的 API。外部應用程式與你的個人權杖取得「使用你的工作區」時,以你的名義使用工作區的每一個應用程式,和你在網站上能做的事一樣,但不能建立、撤銷或列出權杖。沒有這個權限時,它們能代表你做的只有這些:使用你的對話、接收你的通知、透過「在這台裝置讀取你的文件」讀取你可以檢視的文檔頁面,並知道你的名字與電子郵件,其他的都不行,請看第三方應用程式與授權頁與API 存取。
  • 要從外部系統把資料送進網站,請用 Webhook 觸發啟動一個工作流,由工作流處理送進來的資料。
  • 網站本身不是 MCP 伺服器。外部的 AI 工具不能用 MCP 連進這個網站。

LINE 與 Meta 的 Webhook 網址,以及公開分享頁,屬於 Workspace 的說明,這裡不談。