Integrazione con Zapier

Introduzione Primi passi Timer — Registrazione del tempo di lavoro Dashboard Tabella mensile Statistiche annuali Aggiungere e modificare record Progetti Attività Modelli Profilo e impostazioni retributive Esportazione e report di lavoro Geofencing Impostazioni dell'applicazione Sincronizzazione e backup Modalità Kiosk (Terminale) Notifiche e promemoria Richieste di lavoro File e archiviazione Premium e abbonamenti Integrazione con Zapier

Integrazione con Zapier

Collega Working Timer a migliaia di app tramite Zapier. Puoi, ad esempio, creare una registrazione di lavoro da un evento del calendario, un modulo, una riga di foglio di calcolo o un'attività completata.

L'integrazione usa l'API pubblica di Working Timer. Non devi condividere la password di Working Timer con Zapier.

Requisiti

  • Un account Working Timer con piano o prova Public API attivi
  • Un piano Zapier a pagamento con API by Zapier o Webhooks by Zapier
  • L'ID del profilo Working Timer che riceverà le registrazioni

Importante: Tratta la chiave API come una password. Non inserirla nel nome, nelle note, nell'URL o in campi dello Zap visibili nella cronologia.

1. Crea una chiave API

  1. Apri il portale API di Working Timer, seleziona Sign In e accedi.
  2. In API Dashboard, sotto API Keys, seleziona New Key.
  3. Inserisci un nome come Zapier e seleziona Create.
  4. Copia subito la chiave che inizia con wt_ak_: viene mostrata una sola volta.

Se la perdi, revocala e creane una nuova.

2. Trova l'ID del profilo

  1. Apri la documentazione API.
  2. Seleziona Authorize e inserisci la chiave nel campo ApiKey.
  3. Apri GET /api/v1/Profile, seleziona Try it out, quindi Execute.
  4. Trova il profilo nella risposta e copia il suo id.

L'ID è un GUID simile a a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Connetti API by Zapier

  1. In Zapier apri Apps, seleziona Add connection, quindi API by Zapier.
  2. Come Authentication type, scegli Static Headers (API key).
  3. In Headers aggiungi una riga:
X-Api-Key: wt_ak_la_tua_chiave
  1. Imposta Connection name su Working Timer.
  2. Imposta Domain filter su api.workingtimer.com.
  3. Usa come Test URL https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Seleziona Yes, Continue to API by Zapier.

API by Zapier è in versione beta. Se non è disponibile, usa il metodo Webhooks descritto sotto.

4. Crea il primo Zap

  1. Crea uno Zap e scegli un trigger, ad esempio un nuovo evento, attività, modulo o riga.
  2. Aggiungi API by Zapier, scegli API Request e la connessione Working Timer.
  3. Imposta Method su POST e URL su https://api.workingtimer.com/api/v1/WorkRecord.
  4. Inserisci in Body:
{
  "profileId": "ID_DEL_PROFILO",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Creato da Zapier"
}
  1. Sostituisci ID_DEL_PROFILO, associa i valori del trigger e usa prima Formatter by Zapier se serve convertirli.
  2. Seleziona Test step. Una richiesta riuscita restituisce 201. Verifica la registrazione in Working Timer e pubblica lo Zap.

clockIn e clockOut sono minuti dalla mezzanotte: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Per i turni notturni clockOut può superare 1440.

Alternativa: Webhooks by Zapier

Aggiungi Webhooks by Zapier con evento POST. Imposta l'URL su https://api.workingtimer.com/api/v1/WorkRecord, Payload Type su JSON, aggiungi i dati sopra e gli header X-Api-Key con la tua chiave e Content-Type con application/json. Un test riuscito restituisce 201.

Altre richieste utili

  • Profili: GET https://api.workingtimer.com/api/v1/Profile
  • Registrazioni: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Aggiornamento: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Eliminazione: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Consulta la documentazione API per gli altri endpoint.

Risoluzione dei problemi

  • 401 Unauthorized — la chiave manca, è incompleta o revocata. L'header deve chiamarsi esattamente X-Api-Key.
  • 403 Forbidden — attiva o rinnova il piano o la prova Public API.
  • 400 Bad Request — controlla JSON, data e valori numerici dei minuti.
  • Profile was not found — verifica che profileId appartenga allo stesso account.
  • 429 Too Many Requests — è stato raggiunto un limite API; riprova più tardi e controlla l'utilizzo.
  • Registrazioni duplicate — controlla la cronologia Zapier e usa un filtro o un ID sorgente univoco prima dell'azione.

Per revocare l'accesso, seleziona Revoke per la chiave Zapier in API Dashboard.

Precedente Premium e abbonamenti