NomaSign (versão prévia)
Envie modelos nomaSign reutilizáveis para assinatura de fluxos de trabalho automatizados. Exchange um token de atualização de integração para um token de portador e, em seguida, enviar uma ou muitas linhas de destinatário de um modelo salvo com valores de campo opcionais, lembretes, expiração e configurações de email.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Suporte ao NomaSign |
| URL | https://www.nomasign.com/service-delivery/ |
| support@nomasign.com |
| Metadados do conector | |
|---|---|
| Publicador | Sa de origem |
| Website | https://www.nomasign.com |
| Política de privacidade | https://www.nomasign.com/privacy/ |
| Categories | Produtividade |
NomaSign
O NomaSign ajuda as equipes a enviar modelos de assinatura reutilizáveis para assinatura de fluxos de trabalho automatizados. O conector expõe duas ações principais: trocar um token de atualização de integração nomaSign por um token de portador e enviar um modelo salvo para uma ou mais linhas de destinatário.
Prerequisites
- Uma conta NomaSign com um plano ativo que dá suporte a integrações.
- Um modelo nomaSign salvo com espaços reservados rotulados.
- Um token de atualização de integração nomaSign gerado no aplicativo Web NomaSign.
- Um repositório seguro para o token de atualização, como Azure Key Vault.
Ações suportadas
Exchange token de atualização
Troca o token de atualização de integração nomaSign atual por um token de acesso e um token de atualização girado. Armazene o token de atualização retornado antes da próxima execução.
Enviar modelo
Cria sessões de assinatura de um modelo nomaSign salvo, mapeia rótulos de destinatário para espaços reservados de modelo, pré-preenche valores de campo opcionais por rótulo e envia convites de assinatura.
Limitações e problemas conhecidos
- O token de atualização de integração inicial é gerado no aplicativo Web NomaSign e mostrado uma vez.
- Os tokens de atualização giram. Um fluxo de trabalho deve armazenar o token de atualização retornado mais recente após cada troca bem-sucedida.
- Os rótulos dos destinatários devem corresponder aos rótulos de espaço reservado do modelo. Mapeamentos de espaço reservado ausentes retornam um erro de validação.
- Os valores de campo são o melhor esforço. Rótulos de campo sem correspondência são ignorados.
- O remetente deve manter sua conta do Microsoft ou do Google conectada no NomaSign para que os documentos de modelo possam ser copiados e os convites possam ser enviados.
Obtendo credenciais
Entre no aplicativo Web NomaSign como um proprietário da organização, abra a área de instalação de integração, crie ou selecione um integrador e gere um token de integração. Copie o token de atualização para um repositório seguro imediatamente porque ele é mostrado apenas uma vez.
Suporte
Para obter suporte, visita https://www.nomasign.com/service-delivery/ ou email support@nomasign.com.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Ações
| Enviar modelo |
Cria sessões de assinatura de um modelo nomaSign salvo, copia os documentos de modelo e envia convites de assinatura para destinatários mapeados. |
| Exchange token de atualização |
Troca um token de atualização de integração nomaSign por um token de portador de curta duração e um token de atualização girado. |
Enviar modelo
Cria sessões de assinatura de um modelo nomaSign salvo, copia os documentos de modelo e envia convites de assinatura para destinatários mapeados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Autorização nomaSign
|
X-NomaSign-Authorization | True | password |
Valor de autorização do portador usando o token de acesso retornado por Exchange token de atualização, por exemplo, Portador ey... |
|
ID do Modelo
|
templateId | True | string |
O identificador de modelo NomaSign. |
|
Label
|
label | True | string |
O rótulo de espaço reservado do modelo, maiúsculas e minúsculas correspondentes sem diferenciação. |
|
Name
|
name | True | string |
O nome de exibição do destinatário. |
|
Email
|
True |
O endereço de email do destinatário. |
||
|
Document
|
document | string |
Filtro de nome de arquivo de documento opcional para rótulos de campo duplicados. |
|
|
Label
|
label | True | string |
O rótulo do campo de modelo. Rótulos duplicados usam sufixos numéricos, como o Valor 2. |
|
Recipient
|
recipient | string |
Filtro de rótulo de espaço reservado do destinatário opcional para rótulos de campo duplicados. |
|
|
Value
|
value | True | string |
O valor a ser pré-filtrado em campos de modelo correspondentes. |
|
Tipo de assinatura
|
signingType | string |
Controla se os destinatários podem entrar em paralelo ou devem entrar em ordem. |
|
|
Requisito de autenticação
|
authRequirement | string |
Controla se os links de assinatura pública exigem uma verificação de senha única. |
|
|
Nome do remetente
|
senderName | string |
O nome de exibição do remetente usado nos convites de assinatura. |
|
|
Subject
|
subject | string |
O assunto do email para assinatura de convites. |
|
|
Message
|
message | string |
A mensagem simples incluída nos convites de assinatura. |
|
|
Modelo de mensagem
|
messageTemplate | string |
O modelo de mensagem usado para assinatura de convites. |
|
|
Destinatários CC
|
cc | array of string |
Endereços de email copiados em convites de assinatura. |
|
|
Responder ao email
|
replyToEmail |
A resposta ao endereço de email para assinatura de convites. |
||
|
Enviar notificação inicial
|
sendInitialNotification | boolean |
Defina como true para enviar os convites de assinatura iniciais imediatamente. |
|
|
Lembretes habilitados
|
remindersEnabled | boolean |
Defina como true para agendar lembretes de assinatura. |
|
|
Lembrete dias antes da expiração
|
reminderDaysBeforeExpiry | array of integer |
Dias antes da expiração, quando emails de lembrete devem ser enviados. |
|
|
Expira em dias
|
expiresInDays | integer |
Número de dias antes da expiração das sessões de assinatura criadas. |
Retornos
Resposta de envio de modelo.
- Body
- SendTemplateResponse
Exchange token de atualização
Troca um token de atualização de integração nomaSign por um token de portador de curta duração e um token de atualização girado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Token de atualização
|
refresh_token | True | password |
O token de atualização de integração nomaSign ativo. |
Retornos
Resposta do token OAuth.
- Body
- TokenResponse
Definições
TokenResponse
Resposta do token OAuth.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Token de acesso
|
access_token | string |
O token de portador a ser usado no cabeçalho X-NomaSign-Authorization. |
|
Token de atualização
|
refresh_token | string |
O token de atualização girado a ser armazenado para a próxima execução. |
|
Expira em
|
expires_in | integer |
O tempo de vida do token de acesso em segundos. |
|
Tipo de token
|
token_type | string |
O tipo de token retornado pelo serviço de autorização. |
|
Scope
|
scope | string |
Os escopos concedidos ao token de acesso. |
SendTemplateResponse
Resposta de envio de modelo.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
instanciação
|
instantiation | InstantiateTemplateResponse |
Resposta de instanciação de modelo. |
|
Convites
|
invites | array of SessionInviteResult |
Resultados de convite por sessão. |
InstantiateTemplateResponse
Resposta de instanciação de modelo.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do lote de envio em massa
|
bulkSendBatchId | string |
Identificador de lote quando mais de uma sessão foi criada. |
|
Sessions
|
sessions | array of InstantiateRowResult |
Resultados de criação de sessão por linha. |
InstantiateRowResult
Resultado da criação da sessão por linha.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Índice de linha
|
rowIndex | integer |
O índice de linha baseado em zero da solicitação. |
|
ID da sessão
|
sessionId | string |
O identificador de sessão de assinatura criado. |
|
Identificadores de documento
|
documentIds | array of string |
Os identificadores de documento de sessão criados na ordem do documento do modelo. |
|
Status
|
status | string |
O status de criação da linha. |
|
Erro
|
error | string |
A mensagem de erro de linha, quando a criação falhou. |
SessionInviteResult
Resultado do convite por sessão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da sessão
|
sessionId | string |
O identificador da sessão de assinatura. |
|
Title
|
title | string |
O título da sessão de assinatura. |
|
Status do convite
|
inviteStatus | string |
O status do convite para esta sessão. |
|
Erro de convite
|
inviteError | string |
A mensagem de erro de convite ao enviar falhou. |
|
Participants
|
participants | array of SessionParticipantEmailResult |
Resultados de email por participante. |
SessionParticipantEmailResult
Resultado de email por participante.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do participante
|
participantId | string |
O identificador do participante de assinatura. |
|
Email
|
O endereço de email do participante. |
||
|
Name
|
name | string |
O nome de exibição do participante. |
|
Status
|
status | string |
O status do email do participante. |
|
URL de assinatura
|
signingUrl | string |
A URL de assinatura pública deste participante. |