Bot 平台 （預覽版）
將 The Bot Platform 的機器人連接到任何應用程序，向機器人用戶發送消息，使用您在 The Bot Platform 中的現有機器人設置屬性值
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 機器人平台支援 |
| URL | https://thebotplatform.com/contact/ |
| hello@thebotplatform.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 機器人平台 |
| 網站 | https://thebotplatform.com |
| 隱私策略 | https://thebotplatform.com/privacy-policy/ |
| 類別 | 傳達;網站 |
Bot Platform 連接器可讓您使用 Power Automate 流程中的資料，將訊息傳送給機器人中的使用者、建立新屬性，以及設定現有屬性的值。 連接器利用我們的 API 來執行所有這些動作，而不需要手動設定 API 呼叫，而只需使用連接器即可更快地執行 API 動作。
先決條件
您需要在 The Bot Platform 上註冊一個帳戶
如何取得認證
登入 The Bot Platform CMS 後，前往您要連接的機器人。 單擊側邊欄菜單中的“API 訪問”並創建一個新的集成應用程序。 系統會提供您用戶端識別碼和秘密金鑰，請在 Power Automate 中輸入此資訊，以使用連接器向 Power Automate 驗證機器人。
開始使用連接器
登入您的帳戶後，前往您要整合的機器人，然後按一下「API 存取」以取得您的用戶端 ID 和金鑰。 取得此資訊之後，請建立新的 Power Automate 流程，系統會提示您在該處輸入用戶端識別碼和秘密金鑰。 輸入此資訊後，將出現一個彈出窗口，請求存取機器人的權限。 點擊“允許”，一切就緒！
已知問題和限制
- 目前只能透過電子郵件地址識別使用者，以便能夠將資訊傳達回機器人。
- 您無法使用簡單的文字訊息操作傳送影像 URL。
常見錯誤和補救措施
對於安裝在 Microsoft Teams 上的 Bot，您無法將訊息傳送給先前未與 Bot 互動的使用者。 因應措施是先從平台內傳送廣播給使用者，然後再使用聯結器傳送訊息。
FAQ
有關我們用例的更多信息，請訪問我們的 Dev Docs 頁面
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 用戶端識別碼 - 您的 The Bot Platform clientId | 字串 | 請輸入您的客戶 ID。 | 對 |
| 您的 The Bot Platform 用戶端密碼 | securestring | 請輸入客戶端密碼。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 傳送簡單的文字訊息給機器人使用者 |
使用文字傳送訊息給機器人使用者 |
| 建立使用者屬性 |
在機器人中設定新屬性 |
| 設定屬性值 |
透過使用者電子郵件地址設定屬性值 |
傳送簡單的文字訊息給機器人使用者
使用文字傳送訊息給機器人使用者
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
收發簡訊
|
text | string |
在此處輸入您的短信 |
|
|
電子郵件地址
|
recipient | string |
收件人的電子郵件地址 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
對外活動
|
data | ExternalActivity |
建立使用者屬性
在機器人中設定新屬性
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
屬性名稱
|
name | string |
提供屬性的名稱 |
|
|
是PII嗎？
|
is_pii | string |
這是個人身份信息嗎？ |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
使用者屬性
|
data | UserAttribute |
使用者屬性 |
設定屬性值
透過使用者電子郵件地址設定屬性值
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
正在設定屬性之使用者的電子郵件地址
|
emailaddress | True | string |
電子郵件地址 |
|
屬性 ID
|
id | True | string |
機器人中的現有屬性 |
|
value
|
value | string |
屬性值 |