NomaSign(預覽)
從自動化工作流程中傳送可重複使用的 NomaSign 簽名範本。 Exchange 將整合的刷新權杖換成持有人權杖,然後從儲存的範本發送一列或多列收件人,並可選欄位值、提醒、到期日及電子郵件設定。
此連接器適用於以下產品和區域:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | 進階 | 除下列區域外的所有 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) |
| 連絡人 | |
|---|---|
| Name | NomaSign 支援 |
| URL | https://www.nomasign.com/service-delivery/ |
| support@nomasign.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 你是南非的來源 |
| Website | https://www.nomasign.com |
| 隱私權原則 | https://www.nomasign.com/privacy/ |
| Categories | Productivity |
諾瑪簽名
NomaSign 協助團隊從自動化工作流程中傳送可重複使用的簽名範本。 連接器會暴露兩個主要動作:將 NomaSign 整合的刷新令牌交換為持有人令牌,並將已儲存的範本傳送給一個或多個收件人列。
Prerequisites
- 一個有有效方案且支援整合的 NomaSign 帳號。
- 一個已儲存的 NomaSign 模板,並標註佔位符。
- NomaSign 整合的刷新令牌是在 NomaSign 網頁應用程式中產生的。
- 一個用於儲存刷新令牌的安全儲存,例如 Azure Key Vault。
支援行動
Exchange 刷新令牌
將目前的 NomaSign 整合刷新令牌交換為一個存取令牌和一個輪替刷新令牌。 在下一次執行前儲存回來的刷新代幣。
傳送範本
從儲存的 NomaSign 範本建立簽署會話,將收件人標籤映射到模板佔位符,依標籤預先填充可選欄位值,並發送簽署邀請函。
已知問題和限制
- 初始整合刷新令牌會在 NomaSign 網頁應用程式中產生,並顯示一次。
- 刷新代幣會輪流使用。 工作流程必須在每次成功交換後儲存最新回傳的刷新代幣。
- 收件人標籤必須與模板的佔位標籤相符。 缺少佔位符映射會回傳驗證錯誤。
- 場值是盡力而為。 未匹配的欄位標籤會被跳過。
- 寄件人必須在 NomaSign 中保持 Microsoft 或 Google 帳號的連結,以便複製範本文件並發送邀請函。
取得資格認證
以組織擁有者身份登入 NomaSign 網頁應用程式,開啟整合設定區,建立或選擇整合商,並產生整合令牌。 立即將刷新令牌複製到安全儲存,因為它只會顯示一次。
Support
如需支援,請造訪https://www.nomasign.com/service-delivery/或寄信至support@nomasign.com
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有地區 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
動作
| Exchange 刷新令牌 |
將 NomaSign 整合的刷新令牌交換為短壽命持有人令牌及輪替更新令牌。 |
| 傳送範本 |
從儲存的 NomaSign 範本建立簽署會話,複製範本文件,並將簽署邀請函發送給已映射的收件人。 |
Exchange 刷新令牌
將 NomaSign 整合的刷新令牌交換為短壽命持有人令牌及輪替更新令牌。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
重新整理權杖
|
refresh_token | True | password |
NomaSign 整合的即時更新令牌。 |
傳回
OAuth 代幣回覆。
傳送範本
從儲存的 NomaSign 範本建立簽署會話,複製範本文件,並將簽署邀請函發送給已映射的收件人。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
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得主
|
cc | array of string |
簽名邀請函上複製了電子郵件地址。 |
|
|
回覆電子郵件
|
replyToEmail |
回覆電子郵件地址以簽署邀請函。 |
||
|
發送初步通知
|
sendInitialNotification | boolean |
設定為 true,立即發送初始簽約邀請函。 |
|
|
已啟用提醒
|
remindersEnabled | boolean |
設定為真實以排定簽約提醒。 |
|
|
到期前幾天提醒
|
reminderDaysBeforeExpiry | array of integer |
在到期前幾天應該發送提醒郵件。 |
|
|
幾天後到期
|
expiresInDays | integer |
簽署會期結束前的天數。 |
傳回
模板發送回覆。
定義
TokenResponse
OAuth 代幣回覆。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
存取憑證
|
access_token | string |
持有人標記,用於 X-NomaSign-Authorization 標頭。 |
|
重新整理權杖
|
refresh_token | string |
旋轉刷新代幣,儲存到下一次執行。 |
|
到期於
|
expires_in | integer |
存取權杖的壽命以秒計。 |
|
標記類型
|
token_type | string |
授權服務回傳的權杖類型。 |
|
Scope
|
scope | string |
授權給存取權杖的範圍。 |
SendTemplateResponse
模板發送回覆。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
具現化
|
instantiation | InstantiateTemplateResponse |
範本實例化回應。 |
|
邀請函
|
invites | array of SessionInviteResult |
每場邀請結果。 |
InstantiateTemplateResponse(實現模板回應)
範本實例化回應。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
批量發送批次 ID
|
bulkSendBatchId | string |
當建立多個會話時的批次識別碼。 |
|
會議
|
sessions | array of InstantiateRowResult |
每列會話建立結果。 |
InstantiateRowResult
每列會話建立結果。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
列索引
|
rowIndex | integer |
請求中以零為基礎的列索引。 |
|
會話識別碼
|
sessionId | string |
建立的簽署會話識別碼。 |
|
文件識別碼
|
documentIds | array of string |
建立的會話文件識別碼依範本文件順序排列。 |
|
Status
|
status | string |
列創建狀態。 |
|
錯誤
|
error | string |
當建立失敗時,會出現列錯誤訊息。 |
邀請會議結果
每場次邀請結果。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
會話識別碼
|
sessionId | string |
簽署會話識別碼。 |
|
職稱
|
title | string |
簽名會的標題。 |
|
邀請狀態
|
inviteStatus | string |
本次會議的邀請狀態。 |
|
邀請錯誤
|
inviteError | string |
發送失敗時出現邀請錯誤訊息。 |
|
Participants
|
participants | array of SessionParticipantEmailResult |
每位參與者電子郵件結果。 |
SessionParticipantEmailResult
每位參與者電子郵件結果。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
參與者標識碼
|
participantId | string |
簽署參與者識別碼。 |
|
Email
|
參與者的電子郵件地址。 |
||
|
Name
|
name | string |
參與者的顯示名稱。 |
|
Status
|
status | string |
參與者的電子郵件狀態。 |
|
簽名網址
|
signingUrl | string |
此參與者的公開簽名網址。 |