Automatize as suas assinaturas com n8n
n8n é a plataforma de automação open source que pode ser auto-hospedada. Dois caminhos para a Certyneo: importe nosso fluxo de trabalho pronto para usar, que usa apenas os nós Webhook e HTTP Request fornecidos com n8n e, portanto, não requer nenhuma instalação, ou instale o nó comunitário n8n-nodes-certyneo se preferir um nó Certyneo em seu painel. Em ambos os casos, cole sua chave API e seus eventos de assinatura controlam o resto da sua stack.
O fluxo de trabalho não requer nenhuma instalação: usa apenas os nós fornecidos com n8n, portanto funciona em qualquer lugar, inclusive no n8n Cloud. O nó comunitário n8n-nodes-certyneo é publicado no npm e se instala via Settings → Community nodes em uma instância auto-hospedada; n8n Cloud, por sua vez, oferece apenas nós que n8n verificou.
Por que conectar Certyneo a n8n
n8n oferece a você a escolha: o serviço gerenciado ou seu próprio servidor. Em ambos os casos, a integração Certyneo usa a API pública e webhooks, sem intermediário proprietário entre seus contratos e suas ferramentas.
Os 11 eventos, não quatro
O nó Webhook recebe o ciclo de vida completo dos envelopes — criação, envio, abertura, assinatura, recusa, cancelamento, expiração, devolução ao remetente. Nenhum disparo é deixado de lado, ao contrário dos conectores com lista fixa.
Toda a API, sem esperar
O nó HTTP Request chama qualquer ponto de entrada da API Certyneo assim que existe: criar um envelope, enviá-lo, depositar um documento, recuperar o PDF assinado ou o dossiê de prova.
Auto-hospedagem possível
Em uma instância n8n que você hospeda, os metadados de seus contratos não transitam por nenhum terceiro: o tráfego vai de seu servidor para Certyneo, e em lugar nenhum mais. Um argumento de peso para equipes jurídicas e CISOs.
Chave API e assinatura HMAC
A conexão autentica-se por uma chave API com escopo limitado, revogável a qualquer momento. Cada evento recebido é assinado em HMAC-SHA256: seu workflow pode verificar que vem mesmo de Certyneo.
Eventos disponíveis
Inscreva o nó Webhook nos eventos de sua escolha. Eles chegam em tempo real, com o cabeçalho de assinatura X-Certyneo-Signature a verificar no lado do n8n.
| Evento | Se dispara quando… |
|---|---|
Envelope criadoenvelope.created | Um envelope acaba de ser criado, ainda no estado de rascunho. |
Envelope enviadoenvelope.sent | Um envelope sai do rascunho e segue para seus destinatários. |
Envelope assinadoenvelope.completed | Todos os destinatários assinaram: o envelope está finalizado, com um link para baixar o PDF assinado. |
Envelope recusadoenvelope.declined | Um destinatário recusa assinar, com o motivo que indicou. |
Envelope canceladoenvelope.voided | O remetente cancela um envelope já enviado: os links de assinatura tornam-se inutilizáveis. |
Envelope expiradoenvelope.expired | O prazo passou sem que todos os destinatários tivessem assinado. |
Envelope devolvido ao remetenteenvelope.returned_to_sender | Um destinatário devolve o envelope para correção em vez de assiná-lo. |
Envelope reenviadoenvelope.resubmitted | O remetente corrige e reenvia um envelope que lhe havia sido devolvido. |
Destinatário assinourecipient.signed | Um destinatário conclui sua assinatura. Se dispara uma vez por signatário, não apenas no final. |
Destinatário abriurecipient.viewed | Um destinatário abre o envelope pela primeira vez — útil para fazer um acompanhamento no momento certo. |
Destinatário aprovourecipient.approved | Um destinatário cujo papel é «aprovador» valida o envelope sem nele apor uma assinatura. |
Endereço inacessívelrecipient.bounced | O endereço de um destinatário retorna uma falha permanente (caixa inexistente, domínio inativo). As retomadas param: corrija o endereço e reenvie o envelope. |
O que você pode controlar
Cada linha é uma chamada do nó HTTP Request, com autenticação Header Auth e sua chave Certyneo.
Criar um envelope
POST /envelopes — compõe um envelope a partir de um modelo Certyneo ou de documentos já depositados, com seus destinatários.
Enviar o envelope
POST /envelopes/:id/send — remove o envelope do rascunho e envia os convites para assinatura.
Listar envelopes
GET /envelopes — lista paginada, os mais recentes em primeiro lugar, com um filtro de status opcional.
Depositar um documento
POST /documents — envia um PDF a partir de qualquer nó n8n, incluindo um anexo de e-mail ou um arquivo Drive.
Listar os modelos
GET /templates — recupera os identificadores de seus modelos para não ter que codificá-los no workflow.
Transferir o PDF assinado
GET /envelopes/:id/signed-document — obtém o documento assinado, e /audit-trail para o dossiê de prova.
Configurar a integração
O workflow que fornecemos já contém o webhook, o roteamento por evento, a chamada de subscrição e um exemplo de envio. Considere cinco minutos.
- 1
Importar o workflow
No n8n, abra o menu do workflow e selecione « Import from URL… », depois cole o endereço do nosso modelo. Você também pode transferir o arquivo e soltá-lo na tela.
- 2
Gerar sua chave API
Abra Certyneo → Configurações → API REST e crie uma chave com os escopos envelopes e webhooks. Copie-a: ela só é exibida uma única vez.
- 3
Criar o identificador Header Auth
No n8n, adicione um identificador « Header Auth »: nome « Authorization », valor « Bearer » seguido de sua chave. Selecione-o nos nós HTTP Request do workflow.
- 4
Subscrever e ativar
Copie a URL de produção do nó Webhook, cole-a na chamada de subscrição, execute-a uma vez e depois ative o workflow. Guarde o « secret » retornado: serve para verificar a assinatura dos eventos.
- 5
Conectar Google Drive
O modelo deposita o PDF assinado e sua prova de auditoria no seu Drive: selecione sua conta Google nos dois nós de arquivamento. Pode substituí-los por S3, SharePoint ou qualquer outro armazenamento, consomem o mesmo campo binário.
Segurança e conformidade
A integração n8n repousa na API pública Certyneo, com o mesmo nível de exigência do resto da plataforma.
- Trocas criptografadas em HTTPS de ponta a ponta.
- Chaves API com escopo limitado: conceda apenas os direitos necessários.
- Cada evento é assinado em HMAC-SHA256 — verifique-o antes de agir sobre ele.
- Revogação de uma chave a qualquer momento a partir do seu painel.
Perguntas frequentes
É necessário instalar um nó Certyneo no n8n?
Não é obrigatório. O fluxo de trabalho que publicamos usa apenas os nós Webhook e HTTP Request fornecidos com n8n: nada para instalar e funciona tão bem no n8n Cloud. Um nó comunitário existe se preferir — n8n-nodes-certyneo no npm, com um nó de ação, um nó disparador e seu identificador — e se instala via Settings → Community nodes em uma instância auto-hospedada. A documentação n8n reserva n8n Cloud aos nós que ela verificou.
Que subscrição Certyneo é necessária para usar o n8n?
Uma chave real (sk_live_…) requer um plano que inclua acesso à API (Standard e superior). Os planos Gratuito e Pessoal têm uma chave de sandbox (sk_test_…) para percorrer todo o fluxo em envelopes de teste, sem e-mail enviado aos signatários.
Como obtenho minha chave API?
A partir de Certyneo, vá para Configurações → API REST e crie uma chave com os escopos envelopes:read, envelopes:write e webhooks:write. Ela começa com sk_live_ (ou sk_test_ para o sandbox) e é exibida apenas uma vez: copie-a imediatamente.
Isso funciona em uma instância n8n auto-hospedada?
Sim, e esse é o caso de uso mais interessante. Sua instância simplesmente precisa ser acessível pela Internet para receber nossos webhooks: uma URL pública em HTTPS é suficiente. Nenhum dado passa então por um serviço terceirizado.
Quais eventos de assinatura são cobertos?
Os onze eventos do ciclo de vida: envelope criado, enviado, assinado, recusado, cancelado, expirado, devolvido ao remetente, reapresentado, e destinatário tendo aberto, assinado ou aprovado. Você escolhe aqueles aos quais se subscreve.
Como verificar que um evento realmente vem de Certyneo?
Cada entrega tem um cabeçalho X-Certyneo-Signature que contém o HMAC-SHA256 do corpo da requisição, calculado com o segredo devolvido na criação da assinatura. Compare-o em um nó Code antes de processar o evento.
A integração n8n é paga?
Certyneo não cobra uma taxa adicional. Do lado do n8n, uma instância auto-hospedada é gratuita; no n8n Cloud, cada execução consome a cota do seu plano.
Ir mais longe
Automatize seus contratos hoje mesmo
Importe o workflow, cole sua chave API e deixe suas assinaturas desencadear o resto.