n8n-nodes-send-and-wait-custom

Enrichissez vos workflows n8n avec un e-mail « Send & Wait » totalement personnalisable : branding supprimable, HTML complet, ressources externes et page de réponse sur mesure avec jetons sécurisés.

Fonctionnalités

• HTML 100 % libre via le champ Email HTML Body (placeholders {{buttons}}, {{workflowId}}, {{executionId}}).
• Attribution n8n optionnelle (Remove n8n Branding).
• Chargement d'actifs externes (Custom CSS URL, Custom JS URL).
• Liens signés avec expiration (Link Expiration) et redirection post-réponse (Redirect URL).
• Pages de réponse personnalisées (Custom HTML Page) ou formulaire texte enrichi.
• Sortie compatible n8n (mêmes structures que le « Send Email → Send and Wait » officiel, avec responseText, clickedOption, responseTimestamp, executionId).

Installation

Dans un projet n8n (Community Nodes)

# Dans votre dossier custom nodes
pnpm install n8n-nodes-send-and-wait-custom
pnpm build  # génère dist/

Dans l'UI n8n, activez les Community Nodes puis ajoutez n8n-nodes-send-and-wait-custom. Relancez n8n pour charger le module.

Développement local

git clone https://github.com/example/send-and-wait-custom.git
cd send-and-wait-custom
pnpm install
pnpm dev   # compilation TypeScript en watch

Pour tester dans n8n en mode fichier :

1. Copiez le chemin du dossier (par exemple ~/.n8n/custom/send-and-wait-custom).
2. Lancez pnpm build pour générer dist/.
3. Redémarrez n8n.

Utilisation

1. Ajoutez le node Send & Wait (Custom) dans votre workflow.
2. Saisissez l'expéditeur (From Email) et le destinataire (To Email).
3. Rédigez l'objet et le message ou fournissez votre propre HTML.
4. Choisissez le type de réponse :
   • Approval Buttons : configurez les options dans Reply Options.
   • Free Text Form : personnalisez titre, description et appel à l'action.
5. Ajustez au besoin les champs avancés (expiration, redirection, page HTML, template d'URL de réponse).
6. Renseignez vos identifiants SMTP (smtp credential).

Lorsque l'e-mail est envoyé, l'exécution se met automatiquement en attente (putExecutionToWait). Le workflow ne reprend qu'après une réponse HTTP valide sur l'URL signée.

Sortie du node

Le JSON renvoyé contient :

• responseText – texte libre ou libellé du bouton cliqué.
• clickedOption – identifiant de l'action choisie.
• responseTimestamp – date ISO de la réponse.
• executionId – identifiant de l'exécution en attente.
• status – text-response, approve, reject, etc. selon l'option.

Sécurité

• Jetons HMAC SHA-256 signés (nonce.signature) stockés dans les données statiques du node.
• Vérification stricte du protocole (https) côté webhook.
• Option d'expiration automatique des liens.

Scripts utiles

pnpm build     # compile TypeScript + icônes vers dist/
pnpm dev       # build incrémental en watch
pnpm lint      # lint du projet
pnpm lintfix   # lint + corrections auto

Publication sur npm

1. Mettez à jour package.json (version, dépôt, auteur, mots-clés).
2. Assurez-vous que dist/ est à jour (pnpm build).
3. Connectez-vous à npm : npm login.
4. Publiez :

   npm publish --access public
   

5. Communiquez l'URL npm afin que n8n puisse l'installer en Community Node.

Licence

MIT