Ajoutez des signatures électroniques à n'importe quel flux de travail n8n avec Firma.dev

n8n est l'endroit où de nombreuses équipes exécutent déjà la logique de leurs contrats : un formulaire arrive, une opportunité change d'étape, une date de renouvellement approche, et un workflow se déclenche. La pièce manquante est généralement la signature elle-même. Firma.dev propose désormais un nœud communautaire dédié n8n-nodes-firma avec 83 opérations, un déclencheur qui gère ses propres webhooks, et un outil intégré pour l'agent IA de n8n, de sorte que vous n'avez plus besoin de configurer manuellement un nœud HTTP Request.

Parce que Firma.dev facture par enveloppe à 0,049 € (~5¢ USD) sans frais par utilisateur ni minimum mensuel, il s'adapte particulièrement bien à l'envoi automatisé. Lorsqu'un workflow envoie cinquante contrats de renouvellement en une nuit, vous payez pour cinquante enveloppes, et non pour un forfait supérieur auquel vous n'avez pas encore droit. C'est la différence entre une automatisation qui permet d'économiser de l'argent et une automatisation qui fait grimper discrètement la facture.

Cet article présente quatre façons d'intégrer Firma.dev dans n8n : le nœud dédié pour envoyer et gérer les documents, le nœud déclencheur pour réagir aux contrats signés, Firma.dev en tant qu'outil pour l'agent IA, et une configuration manuelle avec Webhook et requête HTTP si vous préférez éviter complètement les nœuds communautaires.

Option 1 : installer le nœud Firma.dev

C'est le moyen le plus rapide de faire fonctionner Firma.dev dans n8n. Le nœud gère l'authentification, le formatage des requêtes et la pagination pour vous, avec des champs déroulants au lieu de JSON brut.

Depuis l'éditeur de workflow, cliquez sur le + pour ajouter un nœud, recherchez « Firma », puis sélectionnez Install sous Community Nodes. Le nœud s'installe et s'ajoute à votre espace de travail en une seule étape. Si vous préférez l'installer à l'avance, allez dans Settings > Community Nodes, cliquez sur Install, et saisissez n8n-nodes-firma. Les instances auto-hébergées peuvent également l'installer manuellement :

cd ~/.n8n/nodes && npm install n8n-nodes-firma

cd ~/.n8n/nodes && npm install n8n-nodes-firma

cd ~/.n8n/nodes && npm install n8n-nodes-firma

Redémarrez n8n après une installation manuelle.

Ensuite, configurez les identifiants. Cliquez sur Credentials dans la barre latérale, ajoutez-en un nouveau et recherchez Firma API. Vous aurez besoin de votre clé API disponible dans Workspace Settings > API, et éventuellement d'un secret de webhook depuis Workspace Settings > Webhooks si vous prévoyez de valider les événements entrants plus tard. Laissez le champ Environment sur Production.

Le nœud couvre 83 opérations à travers des ressources telles que Signing Request, Template, Webhook, Workspace, Company, Domain et Email Template, de sorte que la plupart des workflows n'ont jamais besoin d'en sortir. Un envoi classique ressemble à ceci :

1. Ajoutez un nœud Firma et sélectionnez votre identifiant Firma API

2. Définissez la Resource sur Signing Request et l'Operation sur Create and Send

3. Définissez la Document Source sur Template et saisissez votre Template ID

4. Sous Recipients, ajoutez l'e-mail du signataire, son prénom, sa fonction et son ordre de signature en utilisant des expressions comme {{ $json.signer_email }}

La réponse inclut l'identifiant id de la nouvelle demande de signature, que vous pouvez enregistrer ou transmettre plus bas dans le flux. Pour les flux d'approbation, utilisez l'opération Create pour enregistrer un brouillon, insérez une étape d'approbation ou d'attente, puis appelez Send une fois la validation obtenue.

Une chose importante à noter avant d'intégrer cela dans un workflow actif : les opérations d'écriture de Firma, à savoir Create, Create and Send, Send et Resend, ne comportent pas de clé d'idempotence. Si un nœud réessaie automatiquement après un délai d'attente dépassé, vous risquez d'envoyer deux fois le même contrat, et les deux exemplaires ont valeur juridique une fois signés. Désactivez l'option Retry On Fail sur ces opérations et gérez les tentatives avec votre propre logique si nécessaire.

Option 2 : réagir aux documents signés avec le nœud Firma Trigger

Le nœud déclencheur fait quelque chose qu'un nœud Webhook générique ne peut pas faire : il enregistre et désenregistre automatiquement le webhook auprès de Firma.dev lorsque vous activez ou désactivez le workflow. Il n'y a pas d'étape à mémoriser dans le tableau de bord et rien n'est laissé de côté si vous désactivez un workflow.

Ajoutez un nœud Firma Trigger à un nouveau workflow, sélectionnez votre identifiant Firma API, et choisissez les événements à écouter sous Events, tels que Signing Request Completed ou Signing Request Recipient Declined. Vous pouvez limiter le déclencheur à un seul identifiant d'espace de travail si vous en gérez plusieurs. L'activation du workflow crée le webhook pointant vers votre instance n8n ; sa désactivation le supprime, et les webhooks orphelins des exécutions précédentes sont détectés et réutilisés plutôt que dupliqués.

Le déclencheur couvre l'ensemble des 27 événements de webhook de Firma.dev concernant les demandes de signature, les destinataires, les modèles, les espaces de travail et les domaines. Orientez-les avec un nœud Switch sur {{ $json.type }} :

• signing_request.completed met à jour votre CRM et lance la mise en œuvre

• signing_request.recipient.declined en informe l'équipe commerciale

• signing_request.expired renvoie le document ou déplace l'opportunité en perdue

Si vous avez ajouté un secret de webhook à votre identifiant, le déclencheur valide automatiquement l'en-tête X-Firma-Signature avec HMAC-SHA256, y compris l'en-tête de période de grâce utilisé lors de la rotation des secrets. Les requêtes dont la validation échoue sont rejetées avant d'atteindre la logique de votre workflow. Pour en savoir plus sur la façon dont les événements de webhook s'associent aux espaces de travail multi-locataires, consultez le guide des webhooks d'espace de travail.

Si votre prochaine étape consiste à archiver automatiquement le document finalisé, le tutoriel Google Drive présente précisément cette configuration en quatre étapes, du déclenchement jusqu'au téléchargement, dans un guide dédié.

L'API webhook de Firma.dev nécessite HTTPS. n8n Cloud s'en charge pour vous ; les instances auto-hébergées ont besoin d'un proxy inverse avec TLS, ou d'un tunnel comme cloudflared tunnel --url http://localhost:5678 ou ngrok http 5678 pendant la phase de développement. De plus, les webhooks doivent toujours être activés dans le tableau de bord de Firma.dev sous Workspace Settings > Webhooks. Le bouton de test par webhook contourne cet interrupteur principal, donc un test réussi ne garantit pas que les événements réels soient transmis.

Option 3 : Firma.dev en tant qu'outil pour l'agent IA n8n

Le nœud Firma peut également servir d'outil natif pour le nœud AI Agent, sans configuration HTTP personnalisée requise. Dans un workflow d'agent IA, ajoutez un nœud Firma en tant qu'outil d'entrée, sélectionnez votre identifiant, puis choisissez la ressource et l'opération que vous souhaitez exposer, comme Signing Request > Create and Send.

Exposez plusieurs opérations si vous souhaitez que l'agent dispose de réelles options plutôt que d'un seul outil unique. Une association courante est Template > List, afin que l'agent puisse rechercher lui-même le bon modèle, combiné avec Signing Request > Create and Send pour l'envoyer et Signing Request > Get pour vérifier le statut sur demande. L'agent décide de l'outil à appeler en fonction de la conversation, de sorte qu'une consigne comme « envoyer l'accord de confidentialité à jane@acme.com » est traitée sans que vous ayez à écrire cette logique vous-même.

Cette option nécessite n8n v1.47 ou une version ultérieure.

Configuration manuelle : Webhook et requête HTTP

Si votre équipe évite les nœuds communautaires, ou si vous utilisez une version de n8n antérieure à ceux-ci, vous pouvez tout de même connecter Firma.dev directement à l'API. Il s'agit de la même intégration que ci-dessus, mais assemblée à partir des nœuds génériques de n8n au lieu des nœuds dédiés.

Pour l'envoi, ajoutez un nœud HTTP Request avec un identifiant Header Auth nommé Firma API, l'en-tête Authorization, la valeur de votre clé API, et pointez-le vers le point de terminaison create-and-send :

POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send

POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send

POST https://api.firma.dev/functions/v1/signing-request-api/signing-requests/create-and-send

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

{
  "template_id": "{{ $json.template_id }}",
  "recipients": [
    {
      "first_name": "{{ $json.signer_first_name }}",
      "last_name": "{{ $json.signer_last_name }}",
      "email": "{{ $json.signer_email }}",
      "designation": "Signer",
      "order": 1
    }
  ]
}

Le même modèle de brouillon puis d'envoi s'applique : POST /signing-requests pour créer un brouillon, puis POST /signing-requests/{id}/send une fois qu'il est prêt à être envoyé.

Pour réagir aux documents signés, ajoutez un nœud de déclenchement Webhook, copiez son URL de production, et collez-la dans le tableau de bord de Firma.dev sous Settings > Webhooks avec les événements souhaités. Orientez la charge utile avec un nœud Switch sur {{ $json.body.type }}, et récupérez le fichier signé depuis {{ $json.body.data.signing_request.signed_document_url }} pour l'archiver dans Google Drive, S3 ou Notion. Contrairement au nœud déclencheur, vous devez vous charger d'enregistrer et de supprimer ce webhook vous-même lors de la modification d'un workflow.

Signature au sein d'une autre application

Si votre flux se termine par la signature du document par le destinataire au sein de votre propre produit plutôt que par e-mail, récupérez le signing_request_user_id du destinataire à partir de la réponse de l'API et intégrez l'interface de signature de Firma.dev :

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

<iframe
  src="https://app.firma.dev/signing/{signing_request_user_id}"
  style="width:100%;height:900px;border:0;"
  allow="camera;microphone;clipboard-write"
  title="Document Signing"
></iframe>

Tout s'exécute sur une infrastructure hébergée dans l'UE et produit une piste d'audit complète, garantissant ainsi la validité juridique des automatisations que vous créez.

📘 Consultez le guide d'intégration complet de n8n
La configuration complète, y compris chaque champ de nœud, détail d'identifiant et événement de webhook, est disponible dans la documentation : https://docs.firma.dev/guides/n8n-integration

Commencer

Vous pouvez installer le nœud Firma.dev et envoyer votre première demande de signature en un rien de temps. Commencez à utiliser Firma.dev gratuitement, sans carte de crédit requise, et intégrez la signature électronique aux workflows que vous utilisez déjà.