Connecter n8n

n8n se connecte à Cord de deux façons. Le nœud Cord est le chemin le plus court ; le nœud HTTP Request sert pour tout endpoint que le nœud ne couvre pas encore.

Avec le nœud Cord

1. Dans n8n, allez dans Settings › Community nodes et installez n8n-nodes-cord. Vous avez besoin d’une instance n8n auto-hébergée et des droits d’administrateur sur celle-ci. Sur n8n Cloud, il apparaîtra dans le panneau des nœuds dès que n8n aura terminé sa vérification.
2. Créez une clé secrète dans Cord : activez le Mode développeur dans Votre compte › Préférences et ouvrez l’onglet Clés API du Workbench, la pastille Développeurs dans le coin inférieur droit. Le bouton Créer une clé API de Paramètres › Intégrations › n8n vous y mène. Utilisez une clé avec le droit d’écriture ; celles qui commencent par sk_test_ fonctionnent sur votre environnement de test.
3. Dans n8n, créez un identifiant Cord API et collez la clé. Le bouton de test interroge votre compte et vous indique s’il s’agit d’une clé de test ou de production.
4. Ajoutez le nœud Cord Trigger, choisissez les événements et activez le flux : n8n enregistre le webhook dans Cord à votre place et le supprime lorsque vous désactivez le flux.
5. Pour agir sur Cord, ajoutez le nœud Cord : clients (créer, mettre à jour, obtenir, rechercher), devis (créer, obtenir, rechercher, envoyer, marquer comme payé) et tâches.

Le déclencheur vérifie la signature X-Cord-Signature-V1 de chaque livraison : un POST vers l’URL du webhook qui ne provient pas de Cord est donc ignoré.

Avec le nœud HTTP Request

1. Dans Cord, ajoutez votre webhook dans l’onglet Webhooks du Workbench avec l’URL fournie par le nœud Webhook de n8n.
2. Pour appeler l’API, utilisez le nœud HTTP Request sur https://cordhq.app/api/v1/... avec l’en-tête Authorization: Bearer sk_....

Limites

Les webhooks et les appels à l’API sont décomptés des limites de votre offre, comme avec Zapier ou Make. L’utilisation de l’API du mois figure dans les onglets Vue d’ensemble et Clés API du Workbench (les appels effectués avec des clés de test et ceux du Workbench ne sont pas décomptés), et vos endpoints par rapport à la limite de l’offre, dans l’onglet Webhooks.