NomaSign (预览版)
从自动化工作流发送可重用的 NomaSign 模板进行签名。 Exchange持有者令牌的集成刷新令牌,然后使用可选字段值、提醒、过期和电子邮件设置从保存的模板发送一行或多行。
此连接器在以下产品和区域中可用:
| Service | Class | 区域 |
|---|---|---|
| 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 | NomaSign 支持 |
| URL | https://www.nomasign.com/service-delivery/ |
| support@nomasign.com |
| 连接器元数据 | |
|---|---|
| Publisher | 你源 SA |
| 网站 | https://www.nomasign.com |
| 隐私策略 | https://www.nomasign.com/privacy/ |
| Categories | 生产力 |
NomaSign
NomaSign 可帮助团队从自动化工作流发送可重用的签名模板进行签名。 连接器公开两个主要操作:交换持有者令牌的 NomaSign 集成刷新令牌,并将保存的模板发送到一个或多个收件人行。
Prerequisites
- 具有支持集成的活动计划的 NomaSign 帐户。
- 保存的 NomaSign 模板,其中包含带标签的占位符。
- NomaSign 集成刷新令牌在 NomaSign Web 应用中生成。
- 刷新令牌的安全存储,例如Azure 密钥保管库。
支持的操作
Exchange刷新令牌
交换当前 NomaSign 集成刷新令牌以获取访问令牌和轮换刷新令牌。 在下一次运行之前存储返回的刷新令牌。
发送模板
从保存的 NomaSign 模板创建签名会话,将收件人标签映射到模板占位符,按标签预填充可选字段值,并发送签名邀请。
已知问题和限制
- 初始集成刷新令牌在 NomaSign Web 应用中生成,并显示一次。
- 刷新令牌将轮换。 工作流必须在每次成功交换后存储最新返回的刷新令牌。
- 收件人标签必须与模板占位符标签匹配。 缺少占位符映射会返回验证错误。
- 字段值是最佳努力。 跳过不匹配的字段标签。
- 发件人必须在 NomaSign 中保留其Microsoft或 Google 帐户连接,以便复制模板文档并发送邀请。
获取凭据
以组织所有者身份登录到 NomaSign Web 应用,打开集成设置区域,创建或选择集成器,并生成集成令牌。 立即将刷新令牌复制到安全存储中,因为它仅显示一次。
支持
有关支持,请访问 https://www.nomasign.com/service-delivery/ 或发送电子邮件 support@nomasign.com。
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
操作
| Exchange刷新令牌 |
交换 NomaSign 集成刷新令牌,以获取生存期较短的持有者令牌和轮换的刷新令牌。 |
| 发送模板 |
从保存的 NomaSign 模板创建签名会话,复制模板文档,并向映射的收件人发送签名邀请。 |
Exchange刷新令牌
交换 NomaSign 集成刷新令牌,以获取生存期较短的持有者令牌和轮换的刷新令牌。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
刷新令牌
|
refresh_token | True | password |
活动的 NomaSign 集成刷新令牌。 |
返回
OAuth 令牌响应。
- Body
- TokenResponse
发送模板
从保存的 NomaSign 模板创建签名会话,复制模板文档,并向映射的收件人发送签名邀请。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
NomaSign 授权
|
X-NomaSign-Authorization | True | password |
使用Exchange刷新令牌返回的访问令牌的持有者授权值,例如 Bearer ey... |
|
模板编号
|
templateId | True | string |
NomaSign 模板标识符。 |
|
标签
|
label | True | string |
模板占位符标签,不区分大小写。 |
|
Name
|
name | True | string |
收件人显示名称。 |
|
Email
|
True |
收件人电子邮件地址。 |
||
|
Document
|
document | string |
重复字段标签的可选文档文件名筛选器。 |
|
|
标签
|
label | True | string |
模板字段标签。 重复标签使用数字后缀,例如 Amount 2。 |
|
Recipient
|
recipient | string |
重复字段标签的可选收件人占位符标签筛选器。 |
|
|
Value
|
value | True | string |
要预填充到匹配的模板字段的值。 |
|
签名类型
|
signingType | string |
控制收件人是可以并行登录还是必须按顺序登录。 |
|
|
身份验证要求
|
authRequirement | string |
控制公共签名链接是否需要一次性密码验证。 |
|
|
发件人姓名
|
senderName | string |
签名邀请中使用的发件人显示名称。 |
|
|
主题
|
subject | string |
签名邀请的电子邮件主题。 |
|
|
Message
|
message | string |
签名邀请中包含的纯消息。 |
|
|
消息模板
|
messageTemplate | string |
用于签名邀请的消息模板。 |
|
|
抄送收件人
|
cc | array of string |
签名邀请时复制的电子邮件地址。 |
|
|
回复电子邮件
|
replyToEmail |
用于签名邀请的电子邮件地址的答复。 |
||
|
发送初始通知
|
sendInitialNotification | boolean |
设置为 true 以立即发送初始签名邀请。 |
|
|
已启用提醒
|
remindersEnabled | boolean |
设置为 true 以计划签名提醒。 |
|
|
到期前的提醒日
|
reminderDaysBeforeExpiry | array of integer |
应发送提醒电子邮件的到期前几天。 |
|
|
过期日期(以天为单位)
|
expiresInDays | integer |
创建签名会话过期前的天数。 |
返回
模板发送响应。
- Body
- SendTemplateResponse
定义
TokenResponse
OAuth 令牌响应。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
访问令牌
|
access_token | string |
在 X-NomaSign-Authorization 标头中使用的持有者令牌。 |
|
刷新令牌
|
refresh_token | string |
用于存储下一次运行的轮换刷新令牌。 |
|
过期期限
|
expires_in | integer |
访问令牌生存期(以秒为单位)。 |
|
令牌类型
|
token_type | string |
授权服务返回的令牌类型。 |
|
Scope
|
scope | string |
授予访问令牌的范围。 |
SendTemplateResponse
模板发送响应。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
实例化
|
instantiation | InstantiateTemplateResponse |
模板实例化响应。 |
|
邀请
|
invites | array of SessionInviteResult |
每个会话邀请结果。 |
InstantiateTemplateResponse
模板实例化响应。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
批量发送批 ID
|
bulkSendBatchId | string |
创建多个会话时批处理标识符。 |
|
Sessions
|
sessions | array of InstantiateRowResult |
每行会话创建结果。 |
InstantiateRowResult
每行会话创建结果。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
行索引
|
rowIndex | integer |
请求中的从零开始的行索引。 |
|
会话 ID
|
sessionId | string |
创建的签名会话标识符。 |
|
文档 ID
|
documentIds | array of string |
模板文档顺序中创建的会话文档标识符。 |
|
Status
|
status | string |
行创建状态。 |
|
Error
|
error | string |
创建失败时出现行错误消息。 |
SessionInviteResult
每个会话邀请结果。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
会话 ID
|
sessionId | string |
签名会话标识符。 |
|
Title
|
title | string |
签名会话标题。 |
|
邀请状态
|
inviteStatus | string |
此会话的邀请状态。 |
|
邀请错误
|
inviteError | string |
发送失败时发出的邀请错误消息。 |
|
Participants
|
participants | array of SessionParticipantEmailResult |
每个参与者的电子邮件结果。 |
SessionParticipantEmailResult
每个参与者的电子邮件结果。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
参与者 ID
|
participantId | string |
签名参与者标识符。 |
|
Email
|
参与者电子邮件地址。 |
||
|
Name
|
name | string |
参与者显示名称。 |
|
Status
|
status | string |
参与者电子邮件状态。 |
|
签名 URL
|
signingUrl | string |
此参与者的公共签名 URL。 |