重力短信 （预览版）
通过 RingCentral 发送和接收短信。 连接 RingCentral 帐户以发送短信、检查传递状态，并在消息到达时触发流。
此连接器在以下产品和区域中可用：
| 服务 | Class | Regions |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系我们 | |
|---|---|
| Name | 重力短信支持 |
| URL | https://gravitysms.com |
| 连接器元数据 | |
|---|---|
| 发布者 | 克拉克县技术 |
| 网站 | https://gravitysms.com |
| 隐私策略 | https://gravitysms.com/privacy |
| 类别 | Communication |
重力短信
重力短信使组织能够通过其 RingCentral 帐户发送和接收短信。 将 RingCentral 号码连接到Power Automate以发送出站消息、监视传递状态、列出消息历史记录，并在入站消息到达时触发流。
先决条件
- 具有活动订阅的 重力短信 帐户
- 通过重力短信仪表板连接的 RingCentral 帐户
- 重力短信仪表板中的 API 密钥
Setup
- 在 app.gravitysms.com 登录到重力短信仪表板
- 转到 Integrations 并激活 Power Automate 集成
- 复制提供的 API 密钥
- 在 Power Automate 中创建连接时，将 API 密钥粘贴到 API 密钥字段中
在发送或接收短信之前，必须在重力短信仪表板中连接 RingCentral 帐户。 转到 “设置” → RingCentral 并完成 OAuth 连接。
支持的作
动作
| Operation | Description |
|---|---|
| 发送短信 | 将出站短信排队，以便通过 RingCentral 号码传递。 |
| 获取邮件传递状态 | 按消息 ID 检索已发送邮件的当前传递状态。 |
| 列出消息历史记录 | 检索入站和出站短信的分页、可筛选列表。 |
| 检查 RingCentral 连接 | 验证 RingCentral 帐户是否已连接且令牌处于活动状态。 |
触发器
| 触发器 | Description |
|---|---|
| 收到短信时 | 当入站短信到达 RingCentral 号码时触发。 （可选）按电话号码进行筛选。 |
已知问题和限制
- 短信限制为 1,600 个字符。
- 电话号码必须采用 E.164 格式（例如 +14155551234）。
- 入站 SMS 触发器需要在重力短信仪表板中使用连接的 RingCentral 帐户。
- 发送短信需要分配给帐户的 RingCentral 号码。
支持
- 网站： gravitysms.com
- 文档： docs.gravitysms.com
- 隐私策略： gravitysms.com/privacy
- 服务条款： gravitysms.com/terms
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必需 |
|---|---|---|---|
| API 密钥 | securestring | 此 API 的 API 密钥 | 是 |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 列出消息历史记录 |
检索包含可选筛选器的短信分页列表。 |
| 发送短信 |
将出站短信排队，以便通过 RingCentral 传递。 |
|
检查 Ring |
检查 RingCentral 帐户是否已连接以及令牌状态。 |
| 获取邮件传递状态 |
检索特定短信的当前状态和详细信息。 |
列出消息历史记录
检索包含可选筛选器的短信分页列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
方向
|
direction | string |
按消息方向筛选 |
|
|
地位
|
status | string |
按消息状态筛选 |
|
|
从数字
|
from | string |
按发件人电话号码进行筛选（E.164 格式） |
|
|
To Number
|
to | string |
按收件人电话号码进行筛选（E.164 格式） |
|
|
开始日期
|
startDate | date-time |
筛选在此日期或之后创建的消息（ISO 8601） |
|
|
结束日期
|
endDate | date-time |
筛选在此日期或之前创建的消息（ISO 8601） |
|
|
Page
|
page | integer |
分页的页码 |
|
|
页面大小
|
limit | integer |
每页消息数（最大 100 条） |
返回
- Body
- ListMessagesResponse
发送短信
将出站短信排队，以便通过 RingCentral 传递。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
到
|
to | True | string |
E.164 格式的收件人电话号码（例如 +14155551234） |
|
来自
|
from | True | string |
E.164 格式的发件人电话号码（必须是帐户上的 RingCentral 号码） |
|
消息
|
body | True | string |
短信文本（1-1600 个字符） |
|
用户 ID
|
userId | string |
用于跟踪的可选用户标识符 |
返回
- Body
- SendSmsResponse
检查 RingCentral 连接
获取邮件传递状态
触发器
| 收到短信时 |
在 RingCentral 号码上收到入站短信时触发。 |
收到短信时
在 RingCentral 号码上收到入站短信时触发。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
电话号码
|
phoneNumber | string |
要监视入站短信的电话号码（E.164 格式，例如 +15551234567）。 保留为空以对所有数字触发。 |
返回
- Body
- InboundSmsPayload
定义
SendSmsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息 ID
|
messageId | string |
排队消息的唯一标识符 |
|
地位
|
status | string |
当前消息状态 |
MessageDetail
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息 ID
|
messageId | string |
唯一消息标识符 |
|
地位
|
status | string |
当前送达状态 |
|
RC 消息 ID
|
rcMessageId | string |
RingCentral 消息标识符 |
|
Error
|
error | string |
传递失败时出现错误消息 |
|
到
|
to | string |
收件人电话号码 |
|
来自
|
from | string |
发件人电话号码 |
|
消息
|
body | string |
消息文本 |
|
创建于
|
createdAt | date-time |
创建消息时 |
|
更新时间
|
updatedAt | date-time |
上次更新邮件的时间 |
ListMessagesResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
messages
|
messages | array of MessageDetail |
消息列表 |
|
总数
|
total | integer |
与筛选器匹配的消息总数 |
|
Page
|
page | integer |
当前页码 |
|
页面大小
|
limit | integer |
每页消息数 |
ConnectionStatus
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Connected
|
connected | boolean |
RingCentral 是否已连接 |
|
到期时间
|
expiresAt | date-time |
当前令牌过期时 |
|
RC 帐户 ID
|
rcAccountId | string |
RingCentral 帐户标识符 |
InboundSmsPayload
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息 ID
|
messageId | string |
状态查找的唯一消息标识符 |
|
从数字
|
from | string |
E.164 格式的发件人电话号码（例如 +15551234567） |
|
To Number
|
to | string |
E.164 格式的收件人电话号码 |
|
消息正文
|
text | string |
短信正文内容 |
|
Received At
|
receivedAt | date-time |
收到消息时的时间戳 （ISO 8601） |