Gravity SMS（預覽）
透過 RingCentral 發送與接收簡訊。 連接你的 RingCentral 帳號，發送簡訊、查詢送達狀態，並在訊息抵達時觸發流程。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| Copilot Studio | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government regions - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| Name | 重力簡訊支援 |
| URL | https://gravitysms.com |
| 連接器中繼資料 | |
|---|---|
| 發行者 | 克拉克郡技術學院 |
| 網站 | https://gravitysms.com |
| 隱私策略 | https://gravitysms.com/privacy |
| 類別 | Communication |
重力簡訊
Gravity SMS 讓組織能透過其 RingCentral 帳號發送與接收簡訊。 將您的 RingCentral 號碼連接到 Power Automate，以發送外撥訊息、監控送達狀態、列出訊息歷史，並在收到入訊息時觸發流程。
先決條件
- 一個有有效訂閱的 Gravity 簡訊 帳號
- 一個透過 Gravity SMS 儀表板連接的 RingCentral 帳號
- 來自 Gravity SMS 儀表板的 API 金鑰
設定
- 登入您的Gravity SMS儀表板 app.gravitysms.com
- 請到 Integrations啟用 Power Automate 整合
- 複製提供的 API 金鑰
- 在 Power Automate 建立連線時，將 API 金鑰貼到 API Key欄位
您的 RingCentral 帳號必須先在 Gravity SMS 儀表板中連接，才能發送或接收簡訊。 到RingCentral→設定，完成OAuth連線。
支援的作業
動作
| Operation | Description |
|---|---|
| 傳送簡訊 | 透過你的 RingCentral 號碼排隊發送一則外撥簡訊。 |
| 查詢訊息投遞狀態 | 透過訊息 ID 取得已發送訊息的當前送達狀態。 |
| 列表訊息歷史 | 檢索一個分頁且可篩選的進出簡訊清單。 |
| 檢查 RingCentral 連線 | 確認你的 RingCentral 帳號是否已連結且該代幣是否有效。 |
觸發器
| Trigger | Description |
|---|---|
| 收到簡訊時 | 當收到入站簡訊時，會觸發 RingCentral 的號碼。 可選擇依電話號碼篩選。 |
已知問題和限制
- 簡訊限制為1,600字元。
- 電話號碼必須為 E.164 格式（例如 +14155551234）。
- 入站的 SMS 觸發器需要在 Gravity SMS 儀表板中連接一個 RingCentral 帳號。
- 發送簡訊需要為你的帳號分配一個 RingCentral 號碼。
支援
- 網站： gravitysms.com
- 文件說明： docs.gravitysms.com
- 隱私政策： gravitysms.com/privacy
- 服務條款： gravitysms.com/terms
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有地區 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| Name | 類型 | Description | Required |
|---|---|---|---|
| API 金鑰 | 安全字串 | 此 API 的 API 金鑰 | 沒錯 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 傳送 SMS 訊息 |
排隊排隊發送的 SMS 訊息，透過 RingCentral 傳送。 |
| 列表訊息歷史 |
取得帶有可選篩選功能的分頁 SMS 訊息清單。 |
| 查詢訊息投遞狀態 |
取得特定簡訊的當前狀態與詳細資訊。 |
|
檢查 Ring |
請檢查你的 RingCentral 帳戶是否已連結，以及代幣狀態。 |
傳送 SMS 訊息
排隊排隊發送的 SMS 訊息，透過 RingCentral 傳送。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
發往
|
to | True | string |
接收電話號碼 E.164 格式（例如 +14155551234） |
|
寄件者
|
from | True | string |
寄件人電話號碼為 E.164 格式（您必須是您帳戶上的 RingCentral 號碼） |
|
Message
|
body | True | string |
簡訊文字（1-1600 字元） |
|
使用者識別碼
|
userId | string |
可選的使用者識別碼用於追蹤 |
傳回
列表訊息歷史
取得帶有可選篩選功能的分頁 SMS 訊息清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方向
|
direction | string |
依訊息方向篩選 |
|
|
現況
|
status | string |
依訊息狀態篩選 |
|
|
發件人編號
|
from | string |
依寄件人電話號碼篩選（E.164格式） |
|
|
到編號
|
to | string |
依收件人電話號碼篩選（E.164格式） |
|
|
開始日期
|
startDate | date-time |
在此日期或之後產生的過濾訊息（ISO 8601） |
|
|
結束日期
|
endDate | date-time |
在此日期或之前產生的過濾訊息（ISO 8601） |
|
|
頁面
|
page | integer |
分頁的頁碼 |
|
|
頁面大小
|
limit | integer |
每頁訊息數量（最多 100 則） |
傳回
查詢訊息投遞狀態
取得特定簡訊的當前狀態與詳細資訊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訊息識別碼
|
messageId | True | string |
唯一訊息識別碼 |
傳回
檢查 RingCentral 連線
觸發程序
| 收到簡訊時 |
當收到 RingCentral 號碼的入站簡訊時，會觸發。 |
收到簡訊時
當收到 RingCentral 號碼的入站簡訊時，會觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
電話號碼
|
phoneNumber | string |
用來監控來電簡訊的電話號碼（E.164格式，例如+15551234567）。 所有號碼都留空觸發。 |
傳回
定義
SendSmsResponse
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訊息識別碼
|
messageId | string |
排隊訊息的唯一識別碼 |
|
現況
|
status | string |
目前訊息狀態 |
訊息詳情
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訊息識別碼
|
messageId | string |
唯一訊息識別碼 |
|
現況
|
status | string |
目前交付狀況 |
|
RC 訊息識別碼
|
rcMessageId | string |
RingCentral 訊息識別碼 |
|
錯誤
|
error | string |
若交付失敗，則會出現錯誤訊息 |
|
發往
|
to | string |
接聽者電話號碼 |
|
寄件者
|
from | string |
寄件人電話號碼 |
|
Message
|
body | string |
消息正文 |
|
創立於
|
createdAt | date-time |
訊息製作時間 |
|
更新於
|
updatedAt | date-time |
訊息最後更新的時間 |
清單訊息回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
messages
|
messages | array of MessageDetail |
訊息列表 |
|
總計數
|
total | integer |
與過濾器匹配的訊息總數 |
|
頁面
|
page | integer |
目前頁碼 |
|
頁面大小
|
limit | integer |
每頁訊息數量 |
連線狀態
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
已連線
|
connected | boolean |
RingCentral 是否已連接 |
|
過期時間
|
expiresAt | date-time |
當目前的代幣到期時 |
|
RC 帳戶編號
|
rcAccountId | string |
RingCentral 帳號識別碼 |
InboundSmsPayload
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訊息識別碼
|
messageId | string |
用於狀態查詢的唯一訊息識別碼 |
|
發件人編號
|
from | string |
寄件人電話號碼（E.164格式）（例如 +15551234567） |
|
到編號
|
to | string |
收信者電話號碼（E.164格式） |
|
訊息文字
|
text | string |
簡訊訊息內容 |
|
收稿日期
|
receivedAt | date-time |
收到訊息的時間戳記（ISO 8601） |