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 de phase, une date de renouvellement approche, et un flux de travail se déclenche. La pièce manquante est généralement la signature elle-même. Avec Firma.dev, vous déposez un nœud HTTP Request dans n'importe quel flux de travail, enregistrez votre clé API une fois, et envoyez des signatures électroniques juridiquement contraignantes sans quitter n8n.

Parce que Firma.dev facture 0,049 € par enveloppe (~5¢ USD) sans frais d'utilisateur ni minimum mensuel, il s'adapte particulièrement bien aux envois automatisés. Lorsqu'un flux de travail envoie cinquante contrats de renouvellement en une nuit, vous payez pour cinquante enveloppes, et non pour un forfait supérieur. C'est là toute la différence entre une automatisation qui permet de réaliser des économies et une automatisation qui fait grimper la facture en toute discrétion.

Cet article présente trois façons d'intégrer Firma.dev dans n8n : le nœud HTTP Request pour l'envoi, un déclencheur Webhook pour réagir aux documents signés, et Firma.dev en tant qu'outil pour l'agent IA de n8n.

Option 1 : envoyer avec le nœud HTTP Request

C'est la méthode dont la plupart des flux de travail ont besoin. Vous enregistrez votre clé API Firma.dev une fois en tant qu'identifiant, puis n'importe quel nœud HTTP Request de n'importe quel flux de travail peut la réutiliser.

Tout d'abord, créez l'identifiant. Dans l'éditeur n8n, ouvrez Credentials, cliquez sur Add Credential, et choisissez Header Auth. Nommez l'identifiant Firma API, définissez le Name de l'en-tête sur Authorization, et collez votre clé API Firma.dev comme Value. n8n chiffre les identifiants avec la clé de votre instance, ainsi le fait de référencer l'identifiant permet de ne pas faire apparaître votre clé dans le JSON du flux de travail exporté. Ne collez jamais la clé directement dans le champ d'un nœud.

Ajoutez maintenant un nœud HTTP Request et pointez-le vers le point de terminaison de création et d'envoi, qui crée une demande de signature à partir d'un modèle et l'envoie en un seul appel :

• Method : POST

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

• Authentication : Generic Credential Type, Header Auth, en utilisant l'identifiant Firma API

• Send Body : On, JSON

Le corps récupère les valeurs des nœuds en amont grâce aux expressions n8n :

{
  "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
    }
  ]
}

Connectez ce nœud à l'élément déclencheur de votre flux de travail. Un Form Trigger envoie un contrat dès qu'un client soumet un formulaire. Un Webhook Trigger déclenche la demande lorsque votre application signale qu'une opportunité change de phase. Un Schedule Trigger exécute un lot nocturne de renouvellements à partir d'une requête de base de données. La réponse contient l'id de la nouvelle demande de signature, ce qui vous permet de l'enregistrer, de la stocker ou de s'y référer plus tard.

Si vous avez besoin d'une étape de révision humaine avant tout envoi, créez un brouillon avec POST /signing-requests, placez un nœud Approval au milieu du flux de travail, puis appelez POST /signing-requests/{id}/send une fois validé.

Option 2 : réagir aux documents signés grâce à un déclencheur Webhook

L'envoi ne représente que la moitié du processus. L'autre moitié consiste à agir dès qu'un document est signé. Ajoutez un nœud Webhook comme déclencheur, définissez sa méthode sur POST, et copiez l'URL de production. Dans le tableau de bord de Firma.dev sous Settings → Webhooks, ajoutez cette URL et abonnez-vous aux événements qui vous intéressent, à commencer par signing_request.completed.

De retour dans n8n, ajoutez un nœud Switch après le déclencheur et orientez le flux en fonction de {{ $json.body.type }}. Une signature finalisée peut mettre à jour votre CRM et lancer la mise en service. Un refus peut en informer l'équipe commerciale. Un document expiré peut être renvoyé ou déclarer l'opportunité comme perdue. Le document signé se trouve à l'adresse {{ $json.body.data.signing_request.signed_document_url }}, vous pouvez donc l'envoyer directement vers un nœud Google Drive, S3 ou Notion pour l'archiver sans étape supplémentaire.

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

Si vous utilisez le nœud AI Agent, vous pouvez lui fournir Firma.dev comme outil appelable et le laisser décider quand envoyer. Ajoutez un nœud HTTP Request Tool comme entrée d'outil, configurez-le exactement comme pour l'Option 1, et nommez l'outil send_signing_request. Donnez-lui une description qui explique à l'agent quand l'utiliser, et définissez un schéma d'entrée comportant template_id, signer_email, signer_first_name et signer_last_name. L'agent enverra désormais des contrats directement depuis une instruction en langage naturel. Associez-le à un second outil pointant vers GET /templates si vous souhaitez que l'agent choisisse lui-même le bon modèle.

Signature intégrée dans une autre application

Si votre flux de travail se termine par la signature du document directement au sein de votre propre produit plutôt que par e-mail, récupérez l'identifiant du destinataire signing_request_user_id à partir de la réponse de l'API et intégrez l'interface utilisateur 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 fonctionne sur une infrastructure hébergée dans l'UE et génère un journal d'audit complet, garantissant ainsi la valeur juridique de l'automatisation que vous construisez.

📘 Consultez le guide d'intégration complet de n8n
La configuration complète, incluant 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 dès maintenant

Vous pouvez mettre en place le premier parcours le temps de créer un identifiant et un nœud. Commencez à utiliser Firma.dev gratuitement, sans carte de crédit requise, et ajoutez des signatures électroniques aux flux de travail que vous utilisez déjà.