Automação de Assinaturas Eletrónicas com n8n + Pipedrive: Envie Contratos no Momento em que um Negócio Muda de Fase

Qualquer alteração de etapa de negócio no Pipedrive pode acionar algo automaticamente, e o envio de um contrato é uma das coisas mais úteis que se podem associar a esse evento. Este guia cobre exatamente isso: no momento em que um negócio passa para uma etapa selecionada, o n8n extrai os detalhes do contacto do Pipedrive e dispara um pedido de assinatura da Firma.dev a partir de um modelo guardado. Ninguém na equipa tem de se lembrar de o enviar... ele simplesmente sai.

O Pipedrive tem a sua própria assinatura de documentos integrada, mas encaminhar isto através do n8n e da Firma.dev custa uma fração do valor. A 0,049 € por envelope (cerca de 5 cêntimos de dólar), envie vinte contratos por mês desta forma e o custo total de assinatura fica abaixo de um euro. O acesso à API necessário do lado do Pipedrive está incluído em qualquer plano, pelo que o único custo real restante é o próprio envelope.

O fluxo de trabalho é composto por quatro etapas, criadas com o construtor de IA do n8n, e o vídeo abaixo explica todo o processo. Se preferir não ter o trabalho de digitar tudo manualmente, o fluxo de trabalho concluído está disponível para importação direta; no entanto, vale a pena ler o passo a passo abaixo se quiser adaptá-lo ou integrá-lo em fluxos de trabalho que já tenha em execução.

Ver no YouTube

Descarregar o modelo de fluxo de trabalho — importe-o para o n8n, depois substitua os IDs das suas etapas e o ID do modelo, e volte a ligar as suas credenciais do Pipedrive e da Firma.dev.

Pré-requisitos

• Uma conta Pipedrive com acesso à API

• 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

• Um modelo de assinatura já criado no seu espaço de trabalho da Firma.dev, com a ordem dos campos configurada previamente

Os documentos de integração do n8n cobrem a referência completa do nó se for a sua primeira vez a ligar a Firma.dev ao n8n.

O fluxo de trabalho de quatro etapas

1. Acionador para negócio atualizado

Adicione um nó de acionamento do Pipedrive no n8n e ligue a sua conta. O construtor de IA do n8n define automaticamente a Entidade como Negócio (Deal) e a Ação como Alterar (Change), mantendo a Autenticação de Entrada como Nenhuma (None), uma vez que o Pipedrive chama o webhook diretamente. Se preferir construir isto manualmente, confirme você mesmo estes mesmos três campos. Execute a etapa e, em seguida, mova um negócio de teste entre etapas no Pipedrive para que o acionador tenha dados reais com os quais trabalhar.

2. Filtrar pela etapa pretendida

A saída do acionador inclui um objeto de dados com o novo stage_id do negócio e um objeto anterior com a etapa de onde ele veio. Adicione um filtro que verifique ambos: data.stage_id é igual à sua etapa pretendida, e previous.stage_id é igual à etapa anterior a essa. Dessa forma, o fluxo de trabalho só é acionado nessa transição específica, e não em qualquer movimento que por acaso lá vá parar mais tarde. Os IDs de etapa do Pipedrive não são fáceis de consultar diretamente. A forma mais simples de os encontrar é arrastar um negócio de teste entre etapas e ler os números na própria saída do acionador.

3. Obter os detalhes do contacto

Adicione um nó do Pipedrive configurado para Obter Pessoa (Get Person) e passe o campo person_id dos dados do negócio, e não o ID do negócio em si. A execução desta etapa devolve o e-mail e o nome do signatário, prontos para o nó seguinte.

4. Criar e enviar a partir de um modelo

Adicione um nó da Firma.dev utilizando Criar e Enviar, que cria e envia um pedido de assinatura numa única chamada. Defina o ID do modelo a partir do seu espaço de trabalho da Firma.dev (Modelos, depois o modelo específico) e mapeie o e-mail e o nome do signatário da etapa anterior. É também aqui que o construtor de IA do n8n precisou de uma correção manual: ele definiu o campo de ordem dos itens do modelo a começar em 0, mas a Firma.dev conta a partir de 1, pelo que esse campo tem de ser corrigido manualmente.

Problemas comuns a evitar

• O campo de ordem dos itens começa em 0 no n8n, e não em 1. Os fluxos de trabalho criados por IA falham constantemente neste ponto. Os modelos da Firma.dev contam os itens a partir de 1, por isso verifique este campo antes de enviar qualquer coisa em ambiente de produção.

• Utilize o person_id, e não o ID do negócio, para consultar os detalhes do contacto. O registo do negócio contém uma referência à pessoa, e não as suas informações de contacto diretas.

• Os IDs das etapas residem na saída de dados brutos do acionador, não na interface do Pipedrive. Execute a etapa do acionador após mover um negócio de teste para os ler diretamente.

• Utilize uma chave de API da Firma.dev com âmbito de espaço de trabalho. Isto mantém esta automatização limitada a um único espaço de trabalho, ao contrário de uma chave ao nível da conta, que pode criar ou eliminar espaços de trabalho.

Além de uma única etapa

Este mesmo padrão estende-se para além de um único acionador. Etapas diferentes podem apontar para modelos diferentes, pelo que um negócio que atinge "Contrato Pronto" envia um documento e um negócio que atinge "Renovação" envia outro, tudo a partir do mesmo pipeline do Pipedrive... as mesmas quatro etapas, apenas ligadas a uma etapa diferente e a um modelo diferente. Assim que um contrato é enviado, um segundo fluxo de trabalho atento ao evento Pedido de Assinatura Concluído da Firma.dev pode guardar o documento finalizado diretamente no Google Drive (abordado num guia complementar), notificar a equipa de vendas ou escrever uma linha num campo do seu próprio CRM.

Se esta for a sua primeira vez a ligar as duas ferramentas, o guia de integração do n8n cobre o conjunto mais amplo de acionadores e ações disponíveis, e a documentação lista todas as operações que o nó da Firma.dev suporta. A Firma.dev também funciona da mesma forma através do Zapier para equipas que já utilizem essa tecnologia.

Ganhe 50 envelopes gratuitos: Os clientes da Firma.dev que venham do n8n podem registar-se com o código N8N-FIRMA26 já aplicado para obterem 50 envelopes gratuitos na sua primeira compra, ou introduzir o código manualmente no momento da compra se já tiverem uma conta. A oferta expira a 10 de outubro de 2026.

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