Vai al contenuto

API aperta e integrazioni

Le ore sono il punto di partenza per altri sistemi: paghe, fatturazione, pianificazione, reportistica. TimeTracking nasce per essere collegato: API REST, webhook, CLI, server MCP e Claude Skill sono già attivi, e altri connettori pronti all'uso sono in arrivo.

Demo animata: da un terminale si inserisce o aggiorna un cliente tramite ID esterno con l'API REST, si riceve un JSON e poi un webhook firmato comunica a un CRM che il foglio ore è stato approvato. Upsert tramite ID esterno, Risposta JSON, Parte il webhook, CRM aggiornato.

Come collegare TimeTracking

  1. Creare una chiave API

    Gli amministratori creano chiavi API per organizzazione con gli ambiti necessari. Le chiavi possono essere revocate in qualsiasi momento.

  2. Leggere, scrivere e ascoltare

    Con l'API REST si leggono le ore approvate, si creano registrazioni in blocco, si inseriscono o aggiornano persone e incarichi con i propri ID esterni, o si avviano export. Con i webhook si ricevono le modifiche nel momento in cui avvengono.

  3. Usare ciò che è pronto

    Già attivi: export CSV, XLSX e JSON configurabili, una preimpostazione di prova in formato SD Worx, webhook, la CLI tt, il server MCP e la Claude Skill. App native per Zapier e Make, Slack e Teams, calendari e altre preimpostazioni paghe sono in arrivo.

Cosa è attivo e cosa è in arrivo

Indichiamo con onestà lo stato delle integrazioni. Già attivi: l'API REST con descrizione OpenAPI 1.1, webhook firmati con nuovi tentativi e riproduzione, lo strumento da riga di comando tt, il server MCP con una Claude Skill, export CSV, XLSX e JSON configurabili e una preimpostazione di prova in formato SD Worx. In arrivo: preimpostazioni per Loket, Nmbrs, AFAS e DATEV, sincronizzazione con Google Calendar e Outlook per la rilevazione predittiva, Slack e Microsoft Teams, app native per Zapier e Make, e SSO con SCIM.

Ogni integrazione ha una propria pagina con lo stato attuale, così si sa esattamente cosa si può usare oggi.

  • Attivo: API REST, webhook e CLI tt
  • Attivo: server MCP e Claude Skill
  • Attivo: export CSV, XLSX e JSON configurabili, preimpostazione in formato SD Worx
  • In arrivo: preimpostazioni paghe, calendari, Slack, Teams, app Zapier e Make, SSO e SCIM

I dati restano accessibili

TimeTracking non vincola i dati. Ogni piano può esportare in CSV, XLSX e JSON, e un export completo dell'account è disponibile in qualsiasi momento. In caso di abbandono, si porta via tutto.

Questa apertura facilita anche il passaggio da altri strumenti: gli endpoint in blocco dell'API e gli inserimenti o aggiornamenti tramite ID esterno permettono di caricare persone, clienti e incarichi da un altro sistema senza creare duplicati.

Pensato anche per gli agenti IA

Il server MCP permette ad assistenti come Claude di leggere e aggiornare i dati sulle ore con le stesse autorizzazioni dell'utente che lo collega, e la Claude Skill insegna a Claude le attività più comuni in TimeTracking. Si possono chiedere in linguaggio naturale gli straordinari della settimana scorsa per cliente, o preparare un controllo delle paghe. Entrambi sono già attivi.

Schemi di integrazione comuni

La maggior parte dei collegamenti segue pochi schemi. Un processo notturno legge le ore approvate in un data warehouse o in uno strumento di reportistica. Un back office o un sistema di gestione dei candidati invia persone, clienti e incarichi a TimeTracking, così nessuno li inserisce due volte. E un processo paghe o di fatturazione ascolta un webhook e recupera un export appena un periodo viene approvato.

Finché non arrivano le app native per Zapier e Make, le stesse automazioni funzionano già oggi con un trigger webhook e un passaggio HTTP che chiama l'API. La descrizione OpenAPI semplifica la generazione di un client nel linguaggio usato dal team, gli endpoint di elenco sono paginati e le richieste hanno limiti di frequenza per mantenere la piattaforma veloce per tutti.

  • Leggere le ore approvate nella reportistica
  • Sincronizzare persone, clienti e incarichi tramite ID esterno
  • Reagire ai webhook dopo l'approvazione

Domande frequenti

Esiste un'API pubblica?

Sì. Un'API REST con descrizione OpenAPI 1.1 è già disponibile, con paginazione, endpoint in blocco e inserimenti o aggiornamenti tramite ID esterno. Limiti di frequenza più alti fanno parte del piano Pro.

Quali integrazioni sono attive oggi?

L'API REST, i webhook, la CLI tt, il server MCP e la Claude Skill, gli export CSV, XLSX e JSON configurabili e una preimpostazione di prova in formato SD Worx. Gli altri connettori sono indicati come in arrivo.

È possibile esportare tutti i dati?

Sì. Ogni piano include export CSV, XLSX e JSON, ed è possibile richiedere un export completo dell'account in qualsiasi momento.

Ci sono i webhook?

Sì. I webhook sono attivi. Ogni consegna è firmata, le consegne non riuscite vengono ritentate ed è possibile riprodurre gli eventi passati.

Provi TimeTracking gratis

Gratis fino a 5 utenti. Core da €1 per utente al mese, tutto incluso.