n8n

Disponible

Cette intégration est active et prête à l'emploi sur tous les plans Pro.

Connectez Frihet à n8n pour automatiser les flux de travail : rappels automatiques, synchronisation avec le CRM, notifications personnalisées, et plus encore.

À quoi ça sert ?

Avec n8n intégré :

• Rappels automatiques — Envoie des e-mails lorsqu'une facture arrive à échéance
• Synchronisation CRM — De nouveaux clients sont créés dans Salesforce, Pipedrive, etc.
• Notifications personnalisées — Slack, e-mail, Telegram, webhook personnalisé
• Flux complexes — Conditionnels, boucles, ramifications logiques
• Webhook endpoints — D'autres systèmes déclenchent des actions dans Frihet

Prérequis

• Compte n8n — Créez-en un sur n8n.io
• Connaissances de base de n8n — Ou utilisez des modèles préconfigurés
• Endpoint API de Frihet — Consultez la documentation de l'API REST
• Frihet Pro ou supérieur

Obtenir les identifiants Frihet

Dans Frihet

1. Allez dans Paramètres → Intégrations → n8n
2. Cliquez sur "Générer la clé API"
3. Copiez la clé (quelque chose comme : fh_live_XXXXXXXXXXXXXXXXX)
4. Cliquez sur "Créer un Webhook"
5. Copiez l'URL du webhook (pour recevoir des événements)

Gardez les deux en lieu sûr.

Connecter Frihet à n8n

Étape 1 : Créez un workflow dans n8n

1. Allez sur n8n.io
2. Nouveau workflow
3. Ajoutez un nœud : Frihet (recherchez-le)

Étape 2 : Configurez les identifiants

1. Dans le nœud Frihet, allez dans Identifiants
2. Cliquez sur "Créer un nouvel identifiant"
3. Collez la clé API de Frihet
4. Enregistrez

Étape 3 : Choisissez l'action

Dans le nœud, choisissez quoi faire :

• Créer une facture
• Créer une dépense
• Créer un client
• Obtenir la liste des clients
• Obtenir la liste des factures
• Marquer une facture comme payée

Cas d'utilisation courants

Rappel d'échéance

Quand : Chaque matin à 9h Ce qu'il fait : Recherche les factures échues et envoie un e-mail au client

n8n workflow:
1. Trigger: Chaque jour à 09:00
2. Nodo Frihet: Obtenir les factures échues
3. Loop: Pour chaque facture
4. Nodo Email: Envoyer un e-mail de rappel
5. Actualizar en Frihet: Marquer "Rappel envoyé"

Nouveau client → CRM

Quand : Un client est créé dans Frihet Ce qu'il fait : L'ajoute automatiquement à Salesforce/Pipedrive

n8n workflow:
1. Trigger: Webhook de Frihet (nouveau client)
2. Nodo Frihet: Obtenir les données du client
3. Nodo Salesforce: Créer un contact
4. Nodo Email: Notifier l'équipe

Facture payée → Notification Slack

Quand : Une facture est marquée comme payée Ce qu'il fait : Envoie une notification à Slack avec les détails

n8n workflow:
1. Trigger: Webhook de Frihet (facture payée)
2. Nodo Frihet: Obtenir les détails de la facture
3. Nodo Slack: Envoyer un message formaté
4. Nodo Sheet: Enregistrer dans Google Sheets (facultatif)

Créer une facture depuis un formulaire

Quand : Quelqu'un remplit un formulaire Ce qu'il fait : Crée automatiquement une facture dans Frihet

n8n workflow:
1. Trigger: Webhook de formulaire (TypeForm, Typebot, etc.)
2. Node: Traiter les données du formulaire
3. Nodo Frihet: Créer une facture
4. Nodo Email: Confirmer au client

Modèles préconfigurés

n8n et Frihet offrent des modèles prêts à l'emploi :

1. Dans n8n, allez dans Community → Modèles
2. Recherchez "Frihet"
3. Choisissez un modèle
4. Cliquez sur "Use this template"
5. Configurez uniquement les identifiants

Modèles disponibles

• "Rappel de factures échues"
• "Synchroniser les clients vers Airtable"
• "Notifications de paiements dans Slack"
• "Créer des factures depuis Typeform"
• "Sauvegarde quotidienne vers Google Drive"

Utilisez-les comme base et personnalisez-les.

Webhook de Frihet

Frihet envoie automatiquement des événements à n8n. Consultez la documentation complète des webhooks pour plus de détails sur la signature HMAC-SHA256, les tentatives et tous les types d'événements.

Événements déclenchant le webhook

Événement	Données envoyées
Facture créée	ID, client, montant, échéance
Facture payée	ID, client, montant, date de paiement
Facture échue	ID, client, montant, jours de retard
Client créé	ID, nom, e-mail, téléphone
Dépense créée	ID, catégorie, montant, date
Paiement reçu	ID facture, client, montant

Configurer le webhook dans Frihet

1. Paramètres → Intégrations → n8n
2. Cliquez sur "Créer un Webhook"
3. Choisissez quels événements déclencher (recommandé : tous)
4. Copiez l'URL du webhook
5. Dans n8n, configurez un nœud "Webhook" comme déclencheur avec cette URL

Actions disponibles dans Frihet

Créer une facture

Entrée :
- ID Client (ou créer un nouveau)
- Libellé
- Montant
- Échéance
- TVA

Sortie :
- ID de la facture créée
- Numéro de document
- Statut

Créer une dépense

Entrée :
- Catégorie
- Montant
- Date
- Fournisseur (facultatif)

Sortie :
- ID de la dépense
- Confirmation

Obtenir une liste

Entrée :
- Filtre (date, client, statut)
- Limite de résultats

Sortie :
- Tableau de factures/dépenses/clients

Marquer comme payée

Entrée :
- ID facture
- Montant (facultatif)
- Méthode de paiement (facultative)

Sortie :
- Confirmation
- Date de mise à jour

Exemple complet : Rappel quotidien

Objectif

Chaque matin à 8h, s'il y a des factures échues, envoie un e-mail au client.

Workflow dans n8n

Étape 1 : Déclencheur

Scheduler: Tous les jours à 08:00
Timezone: Europe/Madrid

Étape 2 : Obtenir les factures échues

Nodo: Frihet
Acción: Get Invoices
Filtro: State = "unpaid" AND Due Date < Today

Étape 3 : Boucler sur chaque facture

Loop Node: Pour chaque facture dans le résultat
  - Obtenir l'e-mail du client
  - Calculer les jours de retard

Étape 4 : Envoyer un e-mail

Nodo: Gmail / SendGrid
À : e-mail du client
Objet : "Facture n°{{$node.Frihet.data.number}} à recouvrer"
Corps :
  "Votre facture {{id}} de {{monto}} euros
   est échue depuis {{días_vencida}} jours.
   Veuillez effectuer le paiement dès que possible.
   [Lien de paiement]"

Étape 5 : Mettre à jour dans Frihet

Nodo: Frihet
Acción: Update Invoice
Mettre à jour: reminder_sent = true
Mettre à jour: reminder_date = today

Synchronisation bidirectionnelle avec le CRM

Créer un client dans Frihet → Salesforce

1. Trigger: Webhook Frihet (client créé)
2. Frihet: Obtenir les données du client
3. Salesforce: Créer un compte
4. Salesforce: Créer un contact
5. Frihet: Enregistrer l'ID Salesforce dans le client

Créer une affaire dans Salesforce → Facture dans Frihet

1. Trigger: Webhook Salesforce (affaire conclue)
2. Salesforce: Obtenir les données de l'affaire
3. Frihet: Créer un client (si nouveau)
4. Frihet: Créer une facture avec le montant de l'affaire
5. Salesforce: Mettre à jour l'affaire avec un lien vers Frihet

Notifications personnalisées

Option 1 : E-mail

Nodo: Gmail / SendGrid
Modèle personnalisé avec :
  - Logo de votre entreprise
  - Détails de la facture
  - Lien de paiement

Option 2 : Slack

Nodo: Slack
Message :
  ":moneybag: Facture payée
   Client : {{cliente}}
   Montant : €{{monto}}
   Statut : Payée ✅"

Opción 3 : WhatsApp/Telegram

Nodo: Telegram / WhatsApp (vía Twilio)
Message :
  "Bonjour {{nom}},
   Votre facture n°{{id}} arrive à échéance dans 3 jours.
   [Payez ici]"

Option 4 : Webhook personnalisé

Si vous avez votre propre système :

Nodo: HTTP POST
URL: https://votre-systeme.com/frihet-webhook
Body:
  {
    "event": "invoice_paid",
    "invoice_id": "...",
    "amount": 1200,
    "client": "..."
  }

Votre système le traite comme il le souhaite.

Conditions et logique

Vous pouvez ajouter des conditions :

SI facture échue PLUS DE 7 JOURS
  ALORS envoyer un e-mail + créer une tâche
SINON SI échue MOINS DE 7 JOURS
  ALORS envoyer uniquement un e-mail
SINON
  ALORS ne rien faire

Ou des ramifications plus complexes :

SI le client est "Premium"
  ALORS appeler par téléphone
SINON SI le client est "Normal"
  ALORS envoyer un e-mail
SINON
  ALORS ignorer

Tests et débogage

Exécuter le workflow manuellement

1. Dans n8n, cliquez sur "Execute"
2. Vous voyez les résultats étape par étape
3. S'il y a une erreur, elle s'affiche avec des détails
4. Ajustez et exécutez à nouveau

Journaux et historique

1. Allez dans Executions dans votre workflow
2. Vous voyez chaque exécution :
   • Quand elle a été exécutée
   • Si elle a réussi
   • Temps d'exécution
   • Résultats de chaque nœud

Tester avec des données de test

Avant d'activer (planifier), testez :

1. Modifiez le déclencheur en Manual
2. Cliquez sur "Execute" plusieurs fois
3. Vérifiez que chaque nœud fonctionne
4. Ensuite, passez à Déclencheur automatique (scheduler)

Limites et coûts

Dans n8n

• Workflows automatiques : Dépend de votre plan
• Exécutions : Gratuit jusqu'à une certaine limite
• Nœuds : Illimités
• Intégrations : Des centaines disponibles

Dans Frihet

• Appels API : Inclus dans Pro (pas de limite supplémentaire)
• Webhooks : Illimités
• Données : Aucune limite spéciale pour n8n

Dépannage

"Le webhook ne se déclenche pas"

• Vérifiez que le webhook est actif dans Frihet
• L'événement doit correspondre à la configuration
• Vérifiez les journaux de n8n : Executions → historique
• S'il y a une erreur HTTP, vérifiez l'état du webhook

"Error: No credentials found"

• Dans n8n, vérifiez que les identifiants sont enregistrés
• Copiez à nouveau la clé API de Frihet
• Recréez l'identifiant

"Comment déboguer si quelque chose ne fonctionne pas ?"

1. Ajoutez un nœud "Log" entre les étapes pour voir les données intermédiaires
2. Exécutez manuellement étape par étape
3. Allez dans Executions → historique complet
4. Recherchez l'erreur dans les journaux

"Puis-je utiliser plusieurs workflows ?"

Oui. Vous pouvez avoir :

• Workflow 1: Rappels quotidiens
• Workflow 2: Synchronisation CRM
• Workflow 3: Sauvegardes automatiques
• Tous s'exécutant en parallèle

Prochaines étapes

• Explorez les modèles de n8n
• Lisez la documentation de l'API REST et les webhooks
• Créez votre première automatisation personnalisée

---

Précédent : Revolut Business