Chiavi di accesso
In Amministrazione › Integrazioni e API › Chiavi API crei una chiave con un nome e i permessi necessari. La chiave viene mostrata una sola volta: copiala subito in un posto sicuro. Puoi revocarla in qualsiasi momento. Il CRM conserva solo un'impronta cifrata della chiave.
Ogni richiesta deve contenere l'intestazione:
Authorization: Bearer aks_…la_tua_chiave…
Limite: 120 richieste al minuto per chiave. Ogni chiamata viene registrata nel log (categoria Integrazioni e API).
Permessi
| Permesso | Consente |
|---|---|
| remote:write | registrare e aggiornare sessioni di assistenza remota |
| remote:read | leggere le sessioni di assistenza remota |
| tickets:read | leggere stato e oggetto delle richieste di supporto |
Endpoint
| Metodo e indirizzo | Descrizione |
|---|---|
GET /api/v1/stato | verifica che il servizio risponda (senza chiave) |
POST /api/v1/sessioni-remote | registra o aggiorna una sessione (JSON) |
GET /api/v1/sessioni-remote?ticket=T-2026-0001 | sessioni di una richiesta |
GET /api/v1/ticket/T-2026-0001 | stato di una richiesta |
POST /api/v1/isl/eventi | eventi HTTP di ISL Conference Proxy (token dedicato) |
GET /api/v1/openapi.json | descrizione completa in formato OpenAPI 3 |
Esempio: registrare una sessione
POST /api/v1/sessioni-remote
Authorization: Bearer aks_…
Content-Type: application/json
{"provider": "isl", "session_code": "123-456-789", "ticket": "T-2026-0001",
"status": "ended", "duration_seconds": 840, "notes": "Stampante configurata"}Risposta: {"id": 12, "status": "ended", "ticket": "T-2026-0001"}.
Sicurezza
Solo HTTPS, nessun cookie, chiavi revocabili, permessi minimi, registro delle chiamate. Le API non espongono e-mail, telefoni o altri dati personali dei clienti.
Aggiornata il 21/10/2026