Automação de Assinaturas Eletrónicas no n8n: Guarde Documentos Assinados no Google Drive com o Firma.dev

Cada documento assinado que entra no Firma.dev pode iniciar automaticamente tudo o que acontece a seguir. Este guia aborda a versão mais simples disso: no momento em que um pedido de assinatura é concluído, o n8n recolhe o documento finalizado e coloca-o diretamente no Google Drive. Sem consultas periódicas, sem downloads manuais, sem ninguém na equipa a ter de se lembrar de arquivar a papelada.

O fluxo de trabalho tem quatro passos, e o vídeo abaixo orienta-o na construção de todo o processo em menos de nove minutos.

Ver no YouTube ↗

Pré-requisitos

• Uma instância do n8n, na nuvem ou auto-alojada

• Uma conta Firma.dev e uma chave de API ao nível do espaço de trabalho (explicamos mais abaixo a importância de ser "ao nível do espaço de trabalho")

• O nó comunitário da Firma.dev instalado no n8n, que abrange toda a superfície da API, incluindo o acionador. Os passos de instalação e a lista completa de operações encontram-se na documentação de integração do n8n

• Uma conta do Google Drive ligada no n8n

O fluxo de trabalho de quatro passos

1. Acionador para Pedido de Assinatura Concluído

Adicione um novo fluxo de trabalho, procure por Firma.dev no seletor de nós e adicione o acionador. Escolha o evento Signing Request Completed (Pedido de Assinatura Concluído).

Ligue a sua conta Firma.dev e insira o ID do seu espaço de trabalho, depois copie o URL do webhook gerado pelo n8n. Vá ao seu painel da Firma.dev: Settings → Webhooks → Webhook Endpoints → Add a webhook, cole o URL, selecione Signing Request Completed e clique em Create Webhook. O Firma.dev fornece um segredo de webhook. Este deve ser colocado nas credenciais do n8n juntamente com a chave da API.

Utilize a chave de API do espaço de trabalho específico que está a automatizar, e não a chave ao nível da conta. Os espaços de trabalho permitem manter clientes ou departamentos separados, cada um com a sua própria identidade visual e a sua própria chave restrita, enquanto a chave ao nível da conta pode criar e eliminar espaços de trabalho por completo. Para algo tão específico como esta automatização, a chave do espaço de trabalho é a opção padrão mais segura.

Teste antes de continuar: clique em Execute Step para que o acionador comece a escutar e, em seguida, envie um pedido de assinatura real (um modelo com apenas um signatário funciona bem) para que o resto do fluxo de trabalho tenha dados reais com que trabalhar.

2. Obter Pedido de Assinatura

Adicione um segundo passo, procure novamente por Firma.dev e escolha Get Signing Request (Obter Pedido de Assinatura). Arraste o ID do pedido de assinatura do resultado do acionador para este nó, e não o ID do próprio envio do webhook. Ambos estão lado a lado e parecem semelhantes, mas este nó precisa especificamente do ID do pedido de assinatura. Execute o passo para obter todos os detalhes desse pedido.

3. Descarregar o ficheiro assinado via HTTP

Adicione um nó de HTTP Request. O resultado de Get Signing Request contém mais do que um URL, e aquele que está identificado como o documento original é a versão não assinada. O que pretende é o URL de download final, o ficheiro assinado com as assinaturas, dados de conclusão e certificado anexados. Arraste esse campo para o nó de HTTP Request e execute o passo. O n8n descarrega o ficheiro como dados binários, prontos para o último nó.

4. Carregar para o Google Drive

Adicione um nó de Google Drive configurado para Upload a file (Carregar um ficheiro) e ligue a sua conta do Drive. O campo do nome do ficheiro aceita um valor fixo ou uma expressão do n8n, pelo que pode construir um nome dinâmico a partir de campos anteriores no fluxo de trabalho, como o nome do signatário ou o título do documento, em vez de um nome de ficheiro genérico. Escolha a pasta de destino e já está.

Erros comuns

• Utilizar uma chave de API restrita ao espaço de trabalho, e não a nível de conta. A chave de conta pode criar e eliminar espaços de trabalho, o que representa mais acessos do que uma automatização como esta necessita.

• Selecionar o ID do pedido de assinatura, e não o ID do envio do webhook que ativou o fluxo de trabalho. Eles estão lado a lado no resultado do acionador.

• Descarregar o URL do documento final, e não o URL do documento original. O original não está assinado.

• O segredo do webhook funciona nos dois sentidos. O Firma.dev gera-o quando cria o webhook, e este tem de ser colado na credencial do n8n para que o acionador possa validar os pedidos recebidos.

Mais além do Google Drive

Guardar no Drive é apenas uma opção entre muitas assim que um pedido de assinatura é concluído. O mesmo acionador pode enviar emails aos destinatários, publicar uma notificação, escrever uma linha numa base de dados ou alimentar um fluxo de trabalho maior encadeado no n8n, para que a sua equipa receba sempre o documento finalizado sem que ninguém tenha de verificar manualmente. Substitua o último nó pelo que o fluxo de trabalho realmente necessitar, os três primeiros passos mantêm-se iguais.

Se esta é a primeira vez que liga o Firma.dev ao n8n, o guia de integração do n8n aborda o envio e a reação a pedidos de assinatura de forma mais ampla; este artigo é o aprofundamento numa rota específica. Para ver a lista completa de operações e o método de ferramenta de agente de IA para controlo por linguagem natural, consulte a documentação de integração do n8n. O Firma.dev também suporta o Zapier se este se adequar melhor à sua estrutura tecnológica, e os webhooks restritos ao espaço de trabalho funcionam da mesma forma totalmente fora do n8n.

Obtenha 50 envelopes gratuitos: Os clientes da Firma.dev vindos do n8n podem registar-se com o código N8N-FIRMA26 já aplicado para obter 50 envelopes grátis na sua primeira compra, ou introduzir o código manualmente ao comprar caso já tenham uma conta. A oferta expira a 1 de outubro de 2026.

Comece a utilizar o Firma.dev gratuitamente, sem necessidade de cartão de crédito.