Passa al contenuto principale

n8n

Disponibile

Questa integrazione è attiva e pronta all'uso su tutti i piani Pro.

Collega Frihet a n8n per automatizzare i flussi di lavoro: solleciti automatici, sincronizzazione con CRM, notifiche personalizzate e altro ancora.

A cosa serve?​

Con n8n integrato:

  • Solleciti automatici — Invia email quando una fattura scade
  • Sincronizzazione CRM — Nuovi clienti vengono creati in Salesforce, Pipedrive, ecc.
  • Notifiche personalizzate — Slack, email, Telegram, webhook personalizzato
  • Flussi complessi — Condizionali, loop, ramificazioni logiche
  • Endpoint webhook — Altri sistemi attivano azioni in Frihet

Requisiti​

Ottenere le credenziali di Frihet​

In Frihet​

  1. Vai a Impostazioni → Integrazioni → n8n
  2. Clicca su "Genera chiave API"
  3. Copia la chiave (qualcosa come: fh_live_XXXXXXXXXXXXXXXXX)
  4. Clicca su "Crea Webhook"
  5. Copia l'URL del webhook (per ricevere eventi)

Salva entrambi in un luogo sicuro.

Collegare Frihet a n8n​

Passaggio 1: Crea workflow in n8n​

  1. Vai su n8n.io
  2. Nuovo workflow
  3. Aggiungi nodo: Frihet (cercalo)

Passaggio 2: Configura le credenziali​

  1. Nel nodo di Frihet, vai a Credenziali
  2. Clicca su "Crea nuova credenziale"
  3. Incolla la chiave API di Frihet
  4. Salva

Passaggio 3: Scegli l'azione​

Nel nodo, scegli cosa fare:

  • Crea fattura
  • Crea spesa
  • Crea cliente
  • Ottieni elenco clienti
  • Ottieni elenco fatture
  • Contrassegna fattura come pagata

Casi d'uso comuni​

Sollecito di scadenza​

Quando: Ogni mattina alle 9:00 Cosa fa: Cerca fatture scadute e invia email al cliente

n8n workflow:
1. Trigger: Ogni giorno alle 09:00
2. Nodo Frihet: Ottieni fatture scadute
3. Loop: Per ogni fattura
4. Nodo Email: Invia email di sollecito
5. Aggiorna in Frihet: Contrassegna "Sollecito inviato"

Nuovo cliente → CRM​

Quando: Quando viene creato un cliente in Frihet Cosa fa: Lo aggiunge automaticamente a Salesforce/Pipedrive

n8n workflow:
1. Trigger: Webhook di Frihet (nuovo cliente)
2. Nodo Frihet: Ottieni dati del cliente
3. Nodo Salesforce: Crea contatto
4. Nodo Email: Notifica al team

Fattura pagata → Notifica Slack​

Quando: Quando una fattura viene contrassegnata come pagata Cosa fa: Invia una notifica a Slack con i dettagli

n8n workflow:
1. Trigger: Webhook di Frihet (fattura pagata)
2. Nodo Frihet: Ottieni dettagli della fattura
3. Nodo Slack: Invia messaggio formattato
4. Nodo Sheet: Registra su Google Sheets (opzionale)

Crea fattura da form​

Quando: Quando qualcuno compila un modulo Cosa fa: Crea automaticamente una fattura in Frihet

n8n workflow:
1. Trigger: Webhook da modulo (TypeForm, Typebot, ecc.)
2. Nodo: Elabora i dati del modulo
3. Nodo Frihet: Crea fattura
4. Nodo Email: Conferma al cliente

Template preconfigurati​

n8n e Frihet offrono template pronti:

  1. Su n8n, vai a Community → Templates
  2. Cerca "Frihet"
  3. Scegli un template
  4. Clicca su "Use this template"
  5. Configura solo le credenziali

Template disponibili​

  • "Sollecito fatture scadute"
  • "Sincronizza clienti con Airtable"
  • "Notifiche di pagamento su Slack"
  • "Crea fatture da Typeform"
  • "Backup giornaliero su Google Drive"

Usali come base e personalizza.

Webhook di Frihet​

Frihet invia automaticamente eventi a n8n. Consulta la documentazione completa dei webhook per dettagli su firma HMAC-SHA256, tentativi di ripetizione e tutti i tipi di evento.

Eventi che attivano il webhook​

EventoDati inviati
Fattura creataID, cliente, importo, scadenza
Fattura pagataID, cliente, importo, data pagamento
Fattura scadutaID, cliente, importo, giorni scaduti
Cliente creatoID, nome, email, telefono
Spesa creataID, categoria, importo, data
Pagamento ricevutoID fattura, cliente, importo

Configurare il webhook in Frihet​

  1. Impostazioni → Integrazioni → n8n
  2. Clicca su "Crea Webhook"
  3. Scegli quali eventi attivare (raccomandato: tutti)
  4. Copia l'URL del webhook
  5. Su n8n, configura un nodo "Webhook" come trigger con quell'URL

Azioni disponibili in Frihet​

Crea fattura​

Input:
- Cliente ID (o creane uno nuovo)
- Descrizione
- Importo
- Scadenza
- IVA

Output:
- ID fattura creata
- Numero documento
- Stato

Crea spesa​

Input:
- Categoria
- Importo
- Data
- Fornitore (opzionale)

Output:
- ID spesa
- Conferma

Ottieni elenco​

Input:
- Filtro (data, cliente, stato)
- Limite risultati

Output:
- Array di fatture/spese/clienti

Contrassegna come pagata​

Input:
- ID fattura
- Importo (opzionale)
- Metodo di pagamento (opzionale)

Output:
- Conferma
- Data di aggiornamento

Esempio completo: Sollecito giornaliero​

Obiettivo​

Ogni mattina alle 8:00, se ci sono fatture scadute, invia un'email al cliente.

Workflow in n8n​

Passaggio 1: Trigger

Scheduler: Ogni giorno alle 08:00
Timezone: Europe/Madrid

Passaggio 2: Ottieni fatture scadute

Nodo: Frihet
Azione: Get Invoices
Filtro: State = "unpaid" AND Due Date < Today

Passaggio 3: Loop su ogni fattura

Loop Node: Per ogni fattura nel risultato
  - Ottieni email del cliente
  - Calcola giorni scaduti

Passaggio 4: Invia email

Nodo: Gmail / SendGrid
A: email del cliente
Oggetto: "Fattura #{{$node.Frihet.data.number}} da riscuotere"
Corpo:
  "La tua fattura {{id}} di {{monto}} euro
   è scaduta da {{días_vencida}} giorni.
   Per favore, effettua il pagamento il prima possibile.
   [Link per il pagamento]"

Passaggio 5: Aggiorna in Frihet

Nodo: Frihet
Azione: Update Invoice
Aggiorna: reminder_sent = true
Aggiorna: reminder_date = today

Sincronizzazione bidirezionale con CRM​

Crea cliente in Frihet → Salesforce​

1. Trigger: Webhook Frihet (cliente creato)
2. Frihet: Ottieni dati del cliente
3. Salesforce: Crea Account
4. Salesforce: Crea Contatto
5. Frihet: Salva ID Salesforce nel cliente

Crea deal in Salesforce → Fattura in Frihet​

1. Trigger: Webhook Salesforce (deal vinto)
2. Salesforce: Ottieni dati del deal
3. Frihet: Crea cliente (se nuovo)
4. Frihet: Crea fattura con importo del deal
5. Salesforce: Aggiorna deal con link a Frihet

Notifiche personalizzate​

Opzione 1: Email​

Nodo: Gmail / SendGrid
Template personalizzato con:
  - Logo della tua azienda
  - Dettagli della fattura
  - Link per il pagamento

Opzione 2: Slack​

Nodo: Slack
Messaggio:
  ":moneybag: Fattura pagata
   Cliente: {{cliente}}
   Importo: €{{monto}}
   Stato: Pagata ✅"

Opzione 3: WhatsApp/Telegram​

Nodo: Telegram / WhatsApp (vía Twilio)
Messaggio:
  "Ciao {{nome}},
   La tua fattura #{{id}} scade tra 3 giorni.
   [Paga qui]"

Opzione 4: Webhook personalizzato​

Se hai il tuo sistema:

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

Il tuo sistema elabora come necessario.

Condizioni e logica​

Puoi aggiungere condizioni:

IF fattura scaduta DA PIÙ DI 7 GIORNI
  THEN allora invia email + crea attività
ELSE IF scaduta DA MENO DI 7 GIORNI
  THEN allora invia solo email
ELSE
  THEN allora non fare nulla

O ramificazioni più complesse:

IF cliente è "Premium"
  THEN allora chiama per telefono
ELSE IF cliente è "Regular"
  THEN allora invia email
ELSE
  THEN allora ignora

Testing e debugging​

Esegui workflow manualmente​

  1. Su n8n, clicca su "Execute"
  2. Vedi i risultati passo dopo passo
  3. Se c'è un errore, lo mostra con dettagli
  4. Modifica e riavvia

Log e cronologia​

  1. Vai a Executions nel tuo workflow
  2. Vedi ogni esecuzione:
    • Quando è stata eseguita
    • Se ha avuto successo
    • Tempo di esecuzione
    • Risultati di ogni nodo

Test con dati di prova​

Prima di attivare (pianificare), prova:

  1. Modifica il trigger in Manuale
  2. Clicca su "Execute" più volte
  3. Verifica che ogni nodo funzioni
  4. Quindi passa a Trigger automatico (scheduler)

Limiti e costi​

Su n8n​

  • Workflow automatici: Dipende dal tuo piano
  • Esecuzioni: Gratuito fino a un certo limite
  • Nodi: Illimitati
  • Integrazioni: Centinaia disponibili

Su Frihet​

  • API calls: Inclusi nel piano Pro (nessun limite aggiuntivo)
  • Webhook: Illimitati
  • Dati: Nessun limite speciale per n8n

Troubleshooting​

"Webhook non si attiva"​

  • Verifica che il webhook sia attivo in Frihet
  • L'evento deve corrispondere alla configurazione
  • Controlla i log di n8n: Executions → cronologia
  • Se c'è un errore HTTP, controlla lo stato del webhook

"Errore: Nessuna credenziale trovata"​

  • Su n8n, verifica che le credenziali siano state salvate
  • Copia nuovamente la chiave API di Frihet
  • Ricrea la credenziale

"Come fare il debug se qualcosa non funziona?"​

  1. Aggiungi il nodo "Log" tra i passaggi per vedere i dati intermedi
  2. Esegui manualmente passo dopo passo
  3. Vai a Executions → cronologia completa
  4. Cerca l'errore nei log

"Posso usare più workflow?"​

Sì. Puoi avere:

  • Workflow 1: Solleciti giornalieri
  • Workflow 2: Sincronizzazione CRM
  • Workflow 3: Backup automatici
  • Tutti in esecuzione in parallelo

Prossimi passi​

Precedente: Revolut Business