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 do negócio no Pipedrive pode desencadear outra ação automaticamente, e enviar um contrato é uma das coisas mais úteis a associar a isso. Este guia abrange 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 do 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 do Firma.dev custa uma fração do valor. A €0,049 por envelope (cerca de 5 cêntimos de dólar), envie vinte acordos por mês desta forma e o custo total da assinatura fica abaixo de um euro. O acesso à API necessário no lado do Pipedrive está incluído em qualquer plano, pelo que o único custo real restante é o próprio envelope.

O fluxo de trabalho tem quatro etapas, construídas com o construtor de IA do n8n, e o vídeo abaixo explica todo o processo. Se preferir não o escrever manualmente, o fluxo de trabalho concluído está disponível para importação direta, mas 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 etapas e o ID do modelo pelos seus e volte a ligar as suas credenciais do Pipedrive e do Firma.dev.

Pré-requisitos

• Uma conta Pipedrive com acesso à API

• Uma instância n8n, na nuvem ou autoalojada

• 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 do Firma.dev, com a ordem dos campos configurada com antecedência

A documentação de integração do n8n abrange a referência completa dos nós se esta for a primeira vez que liga o Firma.dev ao n8n.

O fluxo de trabalho de quatro etapas

1. Ativação na atualização de negócio

Adicione um nó de gatilho 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), com a Autenticação de Entrada (Incoming Authentication) deixada como Nenhuma (None), uma vez que o Pipedrive chama o webhook diretamente. Se estiver a construir isto manualmente, confirme esses mesmos três campos por si mesmo. Execute o passo e depois mova um negócio de teste entre etapas no Pipedrive para que o gatilho tenha dados reais com que trabalhar.

2. Filtrar para a etapa de destino

A saída do gatilho inclui um objeto de dados com o novo stage_id do negócio e um objeto anterior com a etapa de onde veio. Adicione um filtro que verifique ambos: data.stage_id é igual à sua etapa de destino, e previous.stage_id é igual à etapa anterior a esta. Dessa forma, o fluxo de trabalho só é acionado nessa transição específica, e não em qualquer movimento que acabe por aterrar ali mais tarde. Os IDs das etapas 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 gatilho.

3. Obter os detalhes do contacto

Adicione um nó Pipedrive definido como Obter Pessoa (Get Person) e insira o campo person_id dos dados do negócio, não o ID do próprio negócio. A execução deste passo 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ó Firma.dev usando Criar e Enviar, que constrói e envia um pedido de assinatura numa única chamada. Defina o ID do modelo do seu espaço de trabalho do Firma.dev (Modelos, depois o modelo específico) e mapeie o e-mail e o nome do signatário do passo anterior. É também aqui que o construtor de IA do n8n precisou de uma correção manual: definiu o campo de ordem dos itens do modelo a começar em 0, mas o Firma.dev conta a partir de 1, pelo que esse campo tem de ser corrigido manualmente.

Erros comuns

• O campo de ordem dos itens começa em 0 no n8n, não em 1. Os fluxos de trabalho construídos por IA falham constantemente nisto. Os modelos do Firma.dev contam os itens a partir de 1, por isso verifique este campo antes de enviar qualquer coisa para o 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 diretamente às suas informações de contacto.

• Os IDs das etapas residem na saída bruta do gatilho, não na interface do Pipedrive. Execute o passo do gatilho depois de mover um negócio de teste para os ler diretamente.

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

Para além de uma única etapa

Este mesmo padrão estende-se para além de um único gatilho. Diferentes etapas podem apontar para diferentes modelos, de modo que um negócio que atinja "Contrato Pronto" envia um acordo e um negócio que atinja "Renovação" envia outro, tudo a partir do mesmo pipeline do Pipedrive... os mesmos quatro passos, apenas ligados a uma etapa diferente e a um modelo diferente. Assim que um acordo é enviado, um segundo fluxo de trabalho que escuta o evento de Pedido de Assinatura Concluído do 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 próprio CRM.

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

Ganhe 50 envelopes gratuitos: Os clientes do Firma.dev que venham do n8n podem registar-se com o código N8N-FIRMA26 já aplicado para obterem 50 envelopes grátis 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 usar o Firma.dev gratuitamente, sem necessidade de cartão de crédito.