NomaSign (préversion)
Envoyez des modèles NomaSign réutilisables pour la signature à partir de flux de travail automatisés. Exchange un jeton d’actualisation d’intégration pour un jeton du porteur, puis envoyez une ou plusieurs lignes de destinataire à partir d’un modèle enregistré avec des valeurs de champ facultatives, des rappels, une expiration et des paramètres de messagerie.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Standard | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Prise en charge de NomaSign |
| URL | https://www.nomasign.com/service-delivery/ |
| Courriel | support@nomasign.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Vous avez une SAP source |
| Website | https://www.nomasign.com |
| Politique de confidentialité | https://www.nomasign.com/privacy/ |
| Categories | Productivité |
NomaSign
NomaSign aide les équipes à envoyer des modèles de signature réutilisables pour la signature à partir de flux de travail automatisés. Le connecteur expose deux actions principales : échanger un jeton d’actualisation d’intégration NomaSign pour un jeton du porteur et envoyer un modèle enregistré à une ou plusieurs lignes de destinataire.
Prerequisites
- Un compte NomaSign avec un plan actif qui prend en charge les intégrations.
- Modèle NomaSign enregistré avec des espaces réservés étiquetés.
- Jeton d’actualisation d’intégration NomaSign généré dans l’application web NomaSign.
- Magasin sécurisé pour le jeton d’actualisation, tel que Azure Key Vault.
Actions prises en charge
Exchange jeton d’actualisation
Échange le jeton d’actualisation d’intégration NomaSign actuel pour un jeton d’accès et un jeton d’actualisation pivoté. Stockez le jeton d’actualisation retourné avant l’exécution suivante.
Modèle d’envoi
Crée des sessions de signature à partir d’un modèle NomaSign enregistré, mappe les étiquettes des destinataires aux espaces réservés du modèle, préremplit les valeurs de champ facultatives par étiquette et envoie des invitations de signature.
Problèmes connus et limitations
- Le jeton d’actualisation d’intégration initial est généré dans l’application web NomaSign et affiché une seule fois.
- Les jetons d’actualisation pivotent. Un flux de travail doit stocker le dernier jeton d’actualisation retourné après chaque échange réussi.
- Les étiquettes de destinataire doivent correspondre aux étiquettes d’espace réservé du modèle. Les mappages d’espaces réservés manquants retournent une erreur de validation.
- Les valeurs de champ sont les meilleurs efforts. Les étiquettes de champ sans correspondance sont ignorées.
- L’expéditeur doit conserver son compte Microsoft ou Google connecté dans NomaSign afin que les documents de modèle puissent être copiés et les invitations peuvent être envoyées.
Obtention d’informations d’identification
Connectez-vous à l’application web NomaSign en tant que propriétaire de l’organisation, ouvrez la zone d’installation de l’intégration, créez ou sélectionnez un intégrateur et générez un jeton d’intégration. Copiez immédiatement le jeton d’actualisation dans un magasin sécurisé, car il n’est affiché qu’une seule fois.
Support
Pour le support, visitez ou envoyez https://www.nomasign.com/service-delivery/ un e-mail support@nomasign.com.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.
Actions
| Exchange jeton d’actualisation |
Échange un jeton d’actualisation d’intégration NomaSign pour un jeton porteur de courte durée et un jeton d’actualisation pivoté. |
| Modèle d’envoi |
Crée des sessions de signature à partir d’un modèle NomaSign enregistré, copie les documents de modèle et envoie des invitations de signature aux destinataires mappés. |
Exchange jeton d’actualisation
Échange un jeton d’actualisation d’intégration NomaSign pour un jeton porteur de courte durée et un jeton d’actualisation pivoté.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Jeton de rafraîchissement
|
refresh_token | True | password |
Jeton d’actualisation d’intégration NomaSign actif. |
Retours
Réponse du jeton OAuth.
- Body
- TokenResponse
Modèle d’envoi
Crée des sessions de signature à partir d’un modèle NomaSign enregistré, copie les documents de modèle et envoie des invitations de signature aux destinataires mappés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Autorisation NomaSign
|
X-NomaSign-Authorization | True | password |
Valeur d’autorisation du porteur à l’aide du jeton d’accès retourné par Exchange jeton d’actualisation, par exemple bearer ey... |
|
ID de modèle
|
templateId | True | string |
Identificateur du modèle NomaSign. |
|
Étiquette
|
label | True | string |
Étiquette d’espace réservé du modèle, qui ne respecte pas la casse. |
|
Name
|
name | True | string |
Nom complet du destinataire. |
|
Courriel
|
True |
Adresse e-mail du destinataire. |
||
|
Document
|
document | string |
Filtre de nom de fichier de document facultatif pour les étiquettes de champ dupliquées. |
|
|
Étiquette
|
label | True | string |
Étiquette de champ de modèle. Les étiquettes en double utilisent des suffixes numériques tels que Amount 2. |
|
Recipient
|
recipient | string |
Filtre d’étiquettes d’espace réservé du destinataire facultatif pour les étiquettes de champ dupliquées. |
|
|
Value
|
value | True | string |
Valeur à préremplir dans les champs de modèle correspondants. |
|
Type de signature
|
signingType | string |
Détermine si les destinataires peuvent se connecter en parallèle ou doivent se connecter dans l’ordre. |
|
|
Exigence d’authentification
|
authRequirement | string |
Contrôle si les liens de signature publique nécessitent une vérification ponctuelle du code secret. |
|
|
Nom de l’expéditeur
|
senderName | string |
Nom complet de l’expéditeur utilisé dans les invitations de signature. |
|
|
Subject
|
subject | string |
Objet de l’e-mail pour la signature d’invitations. |
|
|
Message
|
message | string |
Message brut inclus dans les invitations de signature. |
|
|
Modèle de message
|
messageTemplate | string |
Modèle de message utilisé pour signer des invitations. |
|
|
Destinataires CC
|
cc | array of string |
Adresses e-mail copiées lors de la signature d’invitations. |
|
|
Répondre à l’e-mail
|
replyToEmail |
Réponse à l’adresse e-mail pour la signature d’invitations. |
||
|
Envoyer une notification initiale
|
sendInitialNotification | boolean |
Définissez la valeur true pour envoyer immédiatement les invitations de signature initiales. |
|
|
Rappels activés
|
remindersEnabled | boolean |
Définissez la valeur true pour planifier les rappels de signature. |
|
|
Jours de rappel avant l’expiration
|
reminderDaysBeforeExpiry | array of integer |
Jours avant l’expiration lorsque les e-mails de rappel doivent être envoyés. |
|
|
Expire en jours
|
expiresInDays | integer |
Nombre de jours avant l’expiration des sessions de signature créées. |
Retours
Réponse d’envoi du modèle.
- Body
- SendTemplateResponse
Définitions
TokenResponse
Réponse du jeton OAuth.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Access token (Jeton d’accès)
|
access_token | string |
Jeton du porteur à utiliser dans l’en-tête X-NomaSign-Authorization. |
|
Jeton de rafraîchissement
|
refresh_token | string |
Jeton d’actualisation pivoté à stocker pour l’exécution suivante. |
|
Expire dans
|
expires_in | integer |
Durée de vie du jeton d’accès en secondes. |
|
Type de jeton
|
token_type | string |
Type de jeton retourné par le service d’autorisation. |
|
Scope
|
scope | string |
Étendues accordées au jeton d’accès. |
SendTemplateResponse
Réponse d’envoi du modèle.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
instanciation
|
instantiation | InstantiateTemplateResponse |
Réponse d’instanciation du modèle. |
|
Invitations
|
invites | array of SessionInviteResult |
Résultats de l’invitation par session. |
InstancieTemplateResponse
Réponse d’instanciation du modèle.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de lot d’envoi en bloc
|
bulkSendBatchId | string |
Identificateur de lot lorsque plusieurs sessions ont été créées. |
|
Sessions
|
sessions | array of InstantiateRowResult |
Résultats de création de session par ligne. |
InstancierRowResult
Résultat de création de session de ligne.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Index de ligne
|
rowIndex | integer |
Index de ligne de base zéro de la requête. |
|
ID de la session
|
sessionId | string |
Identificateur de session de signature créé. |
|
ID de document
|
documentIds | array of string |
Identificateurs de document de session créés dans l’ordre de document du modèle. |
|
Status
|
status | string |
État de création de ligne. |
|
Error
|
error | string |
Message d’erreur de ligne, lors de l’échec de la création. |
SessionInviteResult
Résultat de l’invitation par session.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de la session
|
sessionId | string |
Identificateur de session de signature. |
|
Titre
|
title | string |
Titre de la session de signature. |
|
État de l’invitation
|
inviteStatus | string |
État de l’invitation pour cette session. |
|
Erreur d’invitation
|
inviteError | string |
Message d’erreur d’invitation lors de l’envoi ayant échoué. |
|
Participants
|
participants | array of SessionParticipantEmailResult |
Résultats de l’e-mail par participant. |
SessionParticipantEmailResult
Résultat de l’e-mail par participant.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Identifiant du participant
|
participantId | string |
Identificateur du participant de signature. |
|
Courriel
|
Adresse e-mail du participant. |
||
|
Name
|
name | string |
Nom complet du participant. |
|
Status
|
status | string |
État de l’e-mail du participant. |
|
URL de signature
|
signingUrl | string |
URL de signature publique pour ce participant. |