Qui scriviamo che cosa promettiamo su disponibilità e tempi di risposta, come lo misuriamo e dove chiunque può controllarlo. Ogni obiettivo è sotto quanto abbiamo già misurato: non promettiamo un numero che i nostri sistemi non abbiano già tenuto. La misura è la stessa della pagina di stato (/status, e GET /v1/status dell'API, senza chiave), che pubblica ogni mese, per ogni componente, la disponibilità calcolata con la regola di questo documento e l'obiettivo accanto.
1. In breve
Componente (id nella pagina di stato) | Che cos'è | Disponibilità mensile | Disservizio massimo in un mese di 30 giorni |
|---|---|---|---|
assistant | La conversazione che compone il carrello e l'ordine, su ogni canale | 99,9% | 43 minuti |
web_chat | La chat sul sito del negozio | 99,9% | 43 minuti |
api | L'API REST (/v1) per catalogo, clienti, ordini, eventi, e il feed del catalogo | 99,9% | 43 minuti |
events | Webhook firmati, coda in pull ed email degli ordini | 99,9% | 43 minuti |
portal | Il portale del negozio | 99,9% | 43 minuti |
mcp | Il server MCP per gli agenti AI | 99,9% | 43 minuti |
| Tempo di risposta (dal lato del server, ultimi 30 giorni) | Mediana (p50) | 95° percentile (p95) |
|---|---|---|
| Un turno dell'assistente: dal messaggio ricevuto alla risposta pronta | ≤ 9 s | ≤ 15 s |
Una lettura dell'API (GET /v1/…) | ≤ 0,75 s | ≤ 2,5 s |
Una scrittura dell'API (PUT, POST, DELETE /v1/…) | ≤ 1 s | ≤ 3,5 s |
2. Come si misura la disponibilità
Che cosa si guarda. Ogni minuto, senza intervento umano, i nostri allarmi:
- chiamano la porta di ogni componente (una sonda) e controllano che risponda come deve entro 8 secondi;
- controllano il lavoro vero degli ultimi 5 minuti: risposte con errore del server (5xx) delle funzioni e dell'API, turni dell'assistente finiti in errore, consegne di webhook ed email abbandonate o in ritardo, lavori programmati fermi.
Da qui nascono gli incidenti, gli stessi che la pagina di stato mostra:
outage: la porta del componente non risponde come deve a due sonde di fila;degraded: la porta risponde, ma una parte del lavoro fallisce (una delle verifiche del lavoro vero è rossa).
Un incidente si chiude dopo 10 minuti senza il guasto.
La regola del mese. Per ogni componente e per ogni mese di calendario (ora UTC):
- minuti misurati = i minuti del mese in cui gli allarmi hanno misurato il componente. Un minuto in cui la misura non c'è (allarmi fermi, sonda senza esito) non conta né come disponibile né come guasto, e la pagina lo dichiara;
- minuti di disservizio = i minuti misurati coperti da un incidente
outageodegradeddel componente, dal suo primo all'ultimo minuto rosso. Due incidenti sovrapposti contano una volta; - disponibilità del mese = (minuti misurati − minuti di disservizio) ÷ minuti misurati × 100.
Contiamo anche i minuti degraded, non solo le interruzioni. È una scelta più severa per noi: un errore che non ferma la porta ma ferma il vostro lavoro (un ordine che non parte, un turno che fallisce) è disservizio anche se la pagina risponde.
Dove si legge. GET /v1/status (senza chiave) rende per ogni componente availability.month (il mese in corso, fin qui) e availability.previous_month (il mese chiuso), con measured_minutes, outage_minutes, degraded_minutes, downtime_minutes, availability_percent, objective_percent e objective_met. Le finestre di 30 e 90 giorni (availability.30d, availability.90d) restano com'erano: il loro uptime_percent conta solo gli outage.
Che cosa la misura non vede. La sonda prova che la porta risponde; le verifiche del lavoro vero vedono gli errori che i sistemi registrano. Una risposta sbagliata che nessun sistema registra come errore non è disservizio per questa misura: quella la seguono i nostri controlli di qualità, non questo impegno.
3. Esclusioni
Non sono disservizio i minuti dovuti a:
- manutenzione annunciata sulla pagina di stato almeno 48 ore prima, al più 4 ore al mese, con l'orario;
- guasti dei fornitori del modello linguistico (oggi OpenAI) registrati come tali sull'incidente, per il solo componente
assistante solo per i turni che ne dipendono; - funzioni dichiarate in prova (beta) nella documentazione, uso fuori dai limiti del proprio piano, guasti della rete o dei sistemi del cliente, sospensione dell'account, forza maggiore.
Oggi nessuna esclusione è applicata. La pagina di stato non ha ancora un registro pubblico delle manutenzioni né la causa scritta sugli incidenti: finché non c'è, il calcolo pubblicato conta ogni minuto di disservizio, ed è il più severo possibile. Un'esclusione si applicherà solo quando sarà scritta sulla pagina di stato insieme all'incidente, così che chiunque possa ricalcolarla.
4. Tempi di risposta
I tempi sono misurati dal lato del server: dall'arrivo della richiesta alla risposta pronta. Non comprendono la rete fino a voi né, per WhatsApp, il tragitto del messaggio attraverso Meta.
- Assistente: il tempo totale del turno registrato nella traccia di ogni turno reale (esclusi i turni di prova e quelli finiti in errore), negli ultimi 30 giorni. Un turno comprende la chiamata al modello linguistico, che da sola pesa la parte più grande.
- API: la durata registrata nel registro di ogni chiamata (
/v1, esclusi gli errori 5xx), negli ultimi 30 giorni.
Sono obiettivi, non garanzie: si pubblicano e si misurano, ma non danno diritto a crediti. Sotto i 100 campioni nel periodo un percentile non si giudica: si scrive «non misurato».
5. Su che cosa poggiano questi numeri (misura del 9 novembre 2026)
- Disponibilità: gli allarmi misurano dal 24 ottobre 2026 alle 12:51 UTC (il server MCP dal 5 novembre alle 15:26). Al 9 novembre, su circa 22.600 minuti misurati (15,7 giorni), nessun minuto di
outage; 10 minutidegradedperassistant(due episodi di turni in errore il 28 ottobre) e 10 perportal(due episodi di errori 5xx il 31 ottobre). Disponibilità con la regola di questo documento:assistanteportal99,956%, gli altri 100%. Il mese di ottobre (dal 24, 10.748 minuti misurati):assistanteportal99,907%. La storia è breve: è la ragione per cui l'obiettivo è 99,9% e non più alto. - Turni dell'assistente: 575 turni reali in 30 giorni (WhatsApp e chat web): mediana 6,9 s, p95 13,5 s, p99 18,2 s. Per settimana la mediana è stata fra 6,2 e 8,0 s e il p95 fra 10,8 e 14,2 s.
- API: 579 letture e 362 scritture in 30 giorni: letture mediana 0,46 s e p95 2,15 s; scritture mediana 0,63 s e p95 2,96 s. Sono chiamate dei nostri banchi di prova (ambiente
test): l'API non ha ancora traffico di produzione. Gli obiettivi dell'API si rivedranno sul primo mese di traffico reale.
6. Come comunichiamo i guasti
- La pagina di stato (
/status) eGET /v1/statussi aggiornano da sole ogni minuto: un incidente compare appena gli allarmi lo aprono, con il componente, la gravità, l'inizio, l'ultimo minuto visto e la chiusura. Nessuno deve scriverlo a mano, quindi non può essere taciuto. - Lo stato si può leggere da programma (JSON,
ETag,Cache-Controldi 30 secondi): chi integra può collegarlo ai propri sistemi di monitoraggio. - Se la misura stessa si ferma, la pagina lo dice (
unknown, e un503 STATO_NON_MISURABILEquando lo stato non si può leggere): mai «tutto funziona» per difetto. - Gli allarmi avvisano la nostra squadra a ogni incidente aperto.
7. Crediti e condizioni contrattuali
Questo documento non prevede crediti di servizio. Condizioni diverse (crediti, tempi di presa in carico dell'assistenza, comunicazioni dirette) si concordano per iscritto nel contratto del piano enterprise.
8. Come si confrontano con il mercato (pagine ufficiali lette il 9 novembre 2026)
- Twilio (
twilio.com/en-us/legal/service-level-agreement/twilio-apis, aggiornata il 9 aprile 2026): 99,95% sulle API, 99,99% per l'edizione Enterprise; mese di calendario, minuti di indisponibilità; esclude manutenzione annunciata con 24 ore, guasti degli operatori e interruzioni sotto i 5 minuti; credito del 10%. - Supabase (
supabase.com/sla): 99,9% per mese di calendario, solo piano Enterprise; esclude manutenzione annunciata e fornitori cloud; crediti dal 10% al 30%. - Stripe (
stripe.com/legal/ssa, 28 settembre 2026): nessun impegno di disponibilità contrattuale; pubblica la disponibilità storica. - Shopify (
help.shopify.com, piano Plus): «potrebbe includere» un 99,99% nel contratto individuale, non pubblico.
Il nostro 99,9% è lo stesso livello che i fornitori di infrastruttura pubblicano per i loro piani enterprise, e poggia su ciò che abbiamo misurato, non su un impegno preso da altri per noi.
9. Come cambia questo documento
Gli obiettivi si alzano quando la misura li regge per almeno tre mesi di calendario completi, e si scrive la data. Non si abbassano per un mese andato male: quel mese resta pubblicato con objective_met: false. Ogni versione è datata.