NomaSign (Pré-visualização)
Envie modelos NomaSign reutilizáveis para assinatura a partir de fluxos de trabalho automatizados. Exchange um token de atualização de integração por um token portador e depois envie uma ou várias linhas de destinatários a partir de um modelo guardado com valores opcionais de campo, lembretes, expiração e definições de email.
Este conector está disponível nos seguintes produtos e regiões:
| Service | Classe | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões Azure Government - 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 (CCG) - 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 (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contact | |
|---|---|
| Name | Suporte à NomaSign |
| URL | https://www.nomasign.com/service-delivery/ |
| support@nomasign.com |
| Metadados do conector | |
|---|---|
| Publisher | Tu Fontes SA |
| Website | https://www.nomasign.com |
| Política de privacidade | https://www.nomasign.com/privacy/ |
| Categories | Productivity |
NomaSign
A NomaSign ajuda as equipas a enviar modelos de assinatura reutilizáveis para assinatura a partir 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 portador e enviar um modelo guardado para uma ou mais linhas destinatárias.
Prerequisites
- Uma conta NomaSign com um plano ativo que suporta integrações.
- Um modelo NomaSign guardado com marcadores de lugar rotulados.
- Um token de atualização de integração NomaSign gerado na aplicação web NomaSign.
- Um armazenamento seguro para o token de atualização, como o Azure Key Vault.
Ações suportadas
Token de atualização do Exchange
Troca o token de atualização da integração NomaSign atual por um token de acesso e um token de atualização rotativo. Guarde o token de atualização devolvido antes da próxima execução.
Enviar modelo
Cria sessões de assinatura a partir de um modelo NomaSign guardado, mapeia as etiquetas dos destinatários para marcadores do modelo, preenche os valores opcionais dos campos por etiqueta e envia convites de assinatura.
Problemas e limitações conhecidos
- O token inicial de atualização da integração é gerado na aplicação web NomaSign e mostrado uma vez.
- Os tokens de atualização rodam. Um fluxo de trabalho deve armazenar o token de atualização retornado mais recente após cada troca bem-sucedida.
- As etiquetas do destinatário devem corresponder às etiquetas marcantes do modelo. Mapeamentos provisórios em falta devolvem um erro de validação.
- Os valores do campo são o melhor esforço. Etiquetas de campo não combinadas são ignoradas.
- O remetente deve manter a sua conta Microsoft ou Google ligada no NomaSign para que os documentos modelo possam ser copiados e os convites possam ser enviados.
Obtenção de credenciais
Inicie sessão na aplicação web NomaSign como proprietário de uma organização, abra a área de configuração da integração, crie ou selecione um integrador e gere um token de integração. Copie imediatamente o token de atualização para uma loja segura porque só é mostrado uma vez.
Suporte
Para apoio, visite https://www.nomasign.com/service-delivery/ ou envie um email support@nomasign.com.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 a partir de um modelo NomaSign guardado, copia os documentos modelo e envia convites de assinatura para destinatários mapeados. |
| Token de atualização do Exchange |
Troca um token de atualização de integração NomaSign por um token portador de curta duração e um token de atualização rotativo. |
Enviar modelo
Cria sessões de assinatura a partir de um modelo NomaSign guardado, copia os documentos modelo e envia convites de assinatura para destinatários mapeados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Autorização NomaSign
|
X-NomaSign-Authorization | True | password |
Valor de autorização do portador usando o token de acesso devolvido pelo token de atualização do Exchange, por exemplo o portador ey... |
|
ID do modelo
|
templateId | True | string |
O identificador do modelo NomaSign. |
|
Etiqueta
|
label | True | string |
A etiqueta provisória do modelo, combinava com a caixa de forma insensível. |
|
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 opcional de nome de ficheiro de documento para rótulos duplicados de campos. |
|
|
Etiqueta
|
label | True | string |
A etiqueta do campo modelo. Rótulos duplicados usam sufixos numéricos como Amount 2. |
|
Recipient
|
recipient | string |
Filtro opcional de etiquetas provisórias para destinatários para etiquetas duplicadas de campos. |
|
|
Value
|
value | True | string |
O valor a pré-preencher nos campos modelo correspondentes. |
|
Tipo de assinatura
|
signingType | string |
Controla se os destinatários podem assinar em paralelo ou devem assinar por ordem. |
|
|
Requisito de autenticação
|
authRequirement | string |
Controla se os links públicos de assinatura requerem verificação de código de acesso de uso único. |
|
|
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 assinar convites. |
|
|
Message
|
message | string |
A mensagem simples incluída nos convites de assinatura. |
|
|
Modelo de mensagens
|
messageTemplate | string |
O modelo de mensagem usado para assinar convites. |
|
|
Recipientes do CC
|
cc | array of string |
Endereços de email copiados nos convites de assinatura. |
|
|
Responder ao email
|
replyToEmail |
A resposta ao endereço de email para assinar convites. |
||
|
Enviar notificação inicial
|
sendInitialNotification | boolean |
Defina para true para enviar imediatamente os convites iniciais de assinatura. |
|
|
Lembretes ativados
|
remindersEnabled | boolean |
Defina os lembretes de assinatura verdadeiros para agendar. |
|
|
Lembrete dias antes da expiração
|
reminderDaysBeforeExpiry | array of integer |
Dias antes da expiração, quando devem ser enviados emails de lembrete. |
|
|
Expira em poucos dias
|
expiresInDays | integer |
Número de dias antes de expirarem as sessões de assinatura criadas. |
Devoluções
Enviar resposta modelo.
- Corpo
- SendTemplateResponse
Token de atualização do Exchange
Troca um token de atualização de integração NomaSign por um token portador de curta duração e um token de atualização rotativo.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Token de atualização
|
refresh_token | True | password |
O token ativo de atualização da integração NomaSign. |
Devoluções
Resposta token OAuth.
- Corpo
- TokenResponse
Definições
TokenResponse
Resposta token OAuth.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Token de acesso
|
access_token | string |
O token portador a usar no cabeçalho X-NomaSign-Authorization. |
|
Token de atualização
|
refresh_token | string |
O token de atualização rodado para guardar para a próxima corrida. |
|
Expira em
|
expires_in | integer |
A vida útil do token de acesso em segundos. |
|
Tipo de token
|
token_type | string |
O tipo de token devolvido pelo serviço de autorização. |
|
Scope
|
scope | string |
Os telescópios concedidos ao token de acesso. |
SendTemplateResponse
Enviar resposta modelo.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
instanciação
|
instantiation | InstantiateTemplateResponse |
Resposta de instância de modelo. |
|
Convites
|
invites | array of SessionInviteResult |
Resultados por convite para a sessão. |
InstantiateTemplateResponse
Resposta de instância de modelo.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID de lote de envio em massa
|
bulkSendBatchId | string |
Identificador de lote quando mais do que uma sessão foi criada. |
|
Sessions
|
sessions | array of InstantiateRowResult |
Resultados de criação por sessão de linha. |
InstantiateRowResult
Resultado de criação por sessão de linha.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Índice de linha
|
rowIndex | integer |
O índice de linha baseado em zero do pedido. |
|
ID da sessão
|
sessionId | string |
O identificador de sessão de assinatura criado. |
|
Identificadores de Documento
|
documentIds | array of string |
Os identificadores de documentos de sessão criados estão por ordem modelo de documentos. |
|
Status
|
status | string |
O estado de criação de linhas. |
|
Erro
|
error | string |
A mensagem de erro da linha, quando a criação falhou. |
Resultado do Convite da Sessão
Resultado do convite para a sessão.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID da sessão
|
sessionId | string |
O identificador da sessão de assinatura. |
|
Title
|
title | string |
O título da sessão de autógrafos. |
|
Estado do convite
|
inviteStatus | string |
O estado do convite para esta sessão. |
|
Erro de convite
|
inviteError | string |
A mensagem de erro de convite, quando a envio falhou. |
|
Participants
|
participants | array of SessionParticipantEmailResult |
Resultados por email de participante. |
SessãoParticipanteEmailResultado
Resultado por email de participante.
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do Participante
|
participantId | string |
O identificador de participante assinante. |
|
Email
|
O endereço de email do participante. |
||
|
Name
|
name | string |
O participante mostra o nome. |
|
Status
|
status | string |
O estado do email do participante. |
|
URL de assinatura
|
signingUrl | string |
O URL público de assinatura deste participante. |