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/
Email 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
email True email

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 email

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.

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.

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
email 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.