API e integrazioni

REST API mobile, webhook con Ticket Hub Pro, sincronizzazione calendari Google e Office 365.

API REST mobile

Endpoint /api/v1/*, autenticazione via token Sanctum. Documentazione completa generata da OpenAPI in /docs/api.

Casi d'uso:

  • App Flutter LM Presenze (Android, iOS).
  • Integrazione gestionali esterni (custom).
  • Bot Slack/Teams che comunicano con LM Presenze.

Webhook Ticket Hub Pro

Le ore lavorate su ticket in THP fluiscono nel timesheet di LM Presenze:

  1. In Admin → Integrazioni → Ticket Hub Pro generi un secret.
  2. In THP configuri il webhook puntato a https://presenze.lorenzomalferrari.com/api/webhooks/thp.
  3. Test webhook dal pannello.

[Screenshot: pannello integrazione THP con stato connessione]

Calendario Google / Office 365

Da Profilo → Integrazioni calendario. OAuth con Google o Microsoft. Una volta connesso:

  • Le ferie approvate compaiono come eventi sul calendario personale.
  • I turni assegnati compaiono come eventi.
  • I colloqui pianificati creano eventi con link Meet/Teams.

Webhook in uscita

In Admin → Integrazioni → Webhook definisci endpoint custom dove il sistema notifica eventi (es. "assenza approvata"). Utile per integrare con Zapier, Make, n8n.

FAQ

I dati sui calendari esterni sono sicuri? Solo titolo e date dell'evento (non causale assenza, non dettagli colloquio). Puoi configurare cosa mandare.

Posso disconnettere? Sì, in qualsiasi momento. I dati già scritti nel calendario esterno restano lì (vai a cancellarli manualmente se serve).