Per i negozi e per chi integra

Impegni di servizio

Versione del 9 novembre 2026

La disponibilità di ogni mese, misurata: Stato del servizio

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à mensileDisservizio massimo in un mese di 30 giorni
assistantLa conversazione che compone il carrello e l'ordine, su ogni canale99,9%43 minuti
web_chatLa chat sul sito del negozio99,9%43 minuti
apiL'API REST (/v1) per catalogo, clienti, ordini, eventi, e il feed del catalogo99,9%43 minuti
eventsWebhook firmati, coda in pull ed email degli ordini99,9%43 minuti
portalIl portale del negozio99,9%43 minuti
mcpIl server MCP per gli agenti AI99,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 outage o degraded del 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:

  1. manutenzione annunciata sulla pagina di stato almeno 48 ore prima, al più 4 ore al mese, con l'orario;
  2. guasti dei fornitori del modello linguistico (oggi OpenAI) registrati come tali sull'incidente, per il solo componente assistant e solo per i turni che ne dipendono;
  3. 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 minuti degraded per assistant (due episodi di turni in errore il 28 ottobre) e 10 per portal (due episodi di errori 5xx il 31 ottobre). Disponibilità con la regola di questo documento: assistant e portal 99,956%, gli altri 100%. Il mese di ottobre (dal 24, 10.748 minuti misurati): assistant e portal 99,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) e GET /v1/status si 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-Control di 30 secondi): chi integra può collegarlo ai propri sistemi di monitoraggio.
  • Se la misura stessa si ferma, la pagina lo dice (unknown, e un 503 STATO_NON_MISURABILE quando 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.