# API aperta e integrazioni

> Un'API REST aperta, webhook firmati, la CLI tt e un server MCP con una Claude Skill, tutti già attivi. Integrazioni su misura e dati sempre accessibili.

URL: https://timetracking.tech/it/funzionalita/api-e-integrazioni
Language: it
Last updated: 2026-10-23

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.

## 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.
