Sìntonia — Console

Cosa devo guardare oggi

in ordine di gravità

Versioni

Non ancora misurato

Istanze

Cliente	Istanza	Dominio	Stato	Interni	Versione	Ultimo contatto	Ultimo backup

«Apri» porta nel pannello di quel centralino con l'accesso già fatto, senza una seconda password: la console firma un accesso a tempo e manda al nome dell'istanza — l'interfaccia la serve l'istanza, non la console. Se questa console cade, i clienti continuano ad amministrare il proprio centralino.

Un'istanza in creazione ha il bottone Riprendi: rivede le fasi dell'installazione e rigenera il comando da incollare. Il token non si può rimostrare — nel database c'è solo la sua impronta — quindi «riprendi» ne genera uno nuovo, e quello di prima smette di valere.

Rivenditori

Rivenditore	Contatto	Stato

Una credenziale sola

Ogni rivenditore riceve una sola credenziale, creata da noi. È la scelta di partenza: meno cose da spiegare, meno cose da sbagliare.

Il limite da conoscere: con un accesso condiviso il registro attività dice «NetCom ha creato un'istanza», non chi. Il modello dati prevede già più utenti: si aggiungono dalla scheda «Utenti», senza rifare nulla.

Il secondo fattore lo accende lui, dal suo accesso, se lo vuole: è facoltativo. Non possiamo accenderlo noi, ed è esattamente il punto di un secondo fattore.

Un rivenditore si sospende, non si cancella, appena ha un cliente o un movimento di licenze: sospeso non entra più in console, e le istanze dei suoi clienti continuano a far squillare i telefoni (§26.9).

Portafoglio licenze

Rivenditore	Acquistate	Impegnate	Disponibili	In scadenza (90 gg)

Le licenze si pre-acquistano a blocchi da 1, 5 o 10, a prezzo unitario decrescente. Sulla console non si paga: l'ordine avviene fuori e H2Web accredita il blocco. Qui si vede solo cosa è stato venduto e cosa è stato consumato.

Movimenti

Quando	Movimento	Q.tà	Causale	Saldo

Il portafoglio è un registro di movimenti, non un contatore: nessun movimento si cancella, gli errori si correggono con una rettifica motivata. È l'unico modo per rispondere a «perché me ne risultano sei e non sette?».

Come funzionano le licenze

Consumi del mese

Arrivano col battito (lotto 25). Interni attivi, minuti e costo AI per rivenditore, esportabili per la fatturazione: sono numeri che li manda l'istanza, e finché non li manda nessuno non c'è niente da esportare.
Noi fatturiamo al rivenditore, il rivenditore al cliente: la console non conosce i prezzi finali.

Clienti chi paga il centralino: l'anagrafica sta qui, i suoi dati telefonici no

Cliente	Referente	Contatti	Istanze

Cosa non c'è qui

Nessun dato telefonico del cliente: interni, numeri, chiamate e registrazioni vivono solo sulla sua istanza e la console non li vede (§26.3).

Un cliente può avere più istanze — sedi diverse, o una di prova — e restano separate: un'istanza per cliente, mai un Asterisk condiviso.

Alla dismissione di un'istanza il cliente resta, con la sua storia. Quando quella riga non serve più si elimina l'istanza dismessa dall'elenco (la licenza era già tornata); senza istanze si può poi togliere anche il cliente.

Utenti della console

Utente	Ruolo	2FA	Ultimo accesso	Stato

Chi entra qui può toccare decine di centralini. La verifica in due passaggi è facoltativa e si accende dal proprio accesso: questa colonna dice chi l'ha accesa, e nessuno può accenderla per un altro — un segreto che conosci in due non è un secondo fattore.

Il mio accesso

Questi non sono gli utenti dei centralini

Due gerarchie che non si toccano (§27): qui ci sono noi e i rivenditori. Gli utenti di un'istanza — amministratore e utenti collegati a un interno — li crea solo l'amministratore di quell'istanza, e da qui non si vedono né si creano.

Revocare le sessioni è l'operazione che serve quando un tecnico se ne va di venerdì: chiude tutto subito, comprese le mezze sessioni di chi è fermo davanti alla richiesta del codice.

Registro attività della console

Quando	Chi	Cosa	Oggetto	Esito	Da dove

Ogni operazione fatta dalla console finisce qui: chi, quando, su cosa, con che esito e da quale indirizzo. Il registro non si cancella e non si modifica.

Le azioni fatte dentro un'istanza dopo un accesso rapido non stanno qui: stanno nel registro di quell'istanza, attribuite all'utente locale (§26.6). Sono due registri, e va bene così — il cliente deve poter leggere il proprio senza dipendere da noi.

DNS e Plesk

La console crea i record A dei nomi automatici via API Plesk (§26.5). Le credenziali stanno solo qui, cifrate: non partono mai verso una VPS.

Host dell'API

Utente Plesk

Password

non impostata

Zona DNS

Crea e cancella record dentro questa zona. Non tocca SOA, NS, MX né la posta.

TTL di riferimento

L'API XML di Plesk non imposta il TTL sul singolo record A: vale quello della zona. Qui resta il valore di riferimento (§26.5).

Vincoli duri: scrive solo sotto sintonia-; cancella per id, non per nome; se non è sicuro che il record sia suo, non cancella e lo dice.

Nomi automatici delle istanze

progressivo

Ogni istanza riceve un nome sul nostro dominio alla registrazione (§26.5). Il progressivo è un contatore: le dismissioni lasciano buchi.

Dominio genitore

Questa zona è solo nostra

Su una zona nostra il nome dell'istanza si scegle: quello che protegge gli altri record è il controllo su ciò che nella zona esiste già. Su una zona condivisa serve il prefisso.

Nomi riservati

Non si danno a un'istanza nemmeno se il record non esiste ancora: sono i nomi che useremo noi. Svuotando il campo tornano i predefiniti.

Prossimo nome

—

Email della console

SMTP nostro, non del cliente: avvisi di flotta. La console non manda email di reimpostazione password (§26.12).

Host

Porta

Cifratura

Utente

Password

non impostata

Mittente

Reply-To

Destinatari interni H2Web

Accesso unificato «Apri»

La chiave con cui la console firma i token a tempo (§26.6). Sta nel database, cifrata. Rigenerarla spegne «Apri» su tutte le istanze finché non ripubblicano la nuova impronta — gli utenti locali restano.

Impronta pubblica

—

Creata

—

API e agenti MCP

OAuth 2.1 remoto

MCP principale della console, per sviluppatori e superadmin: il client si collega a /mcp, apre il consenso OAuth dentro la console e riceve un token legato al tuo utente. I rivenditori non possono autorizzarlo.

URL MCP remoto

—

Configurazione Cursor:

{
  "mcpServers": {
    "sintonia-console": { "url": "https://…/mcp" }
  }
}

Documentazione API

Apri Swagger Apri ReDoc

/docs, /redoc e /openapi.json richiedono una sessione superadmin.

La console non fa da proxy verso i centralini: lo strumento emetti_token_istanza crea un AccessoMcp per una sola istanza e restituisce il suo https://nome/mcp. Da lì il client parla direttamente con quella VPS.

I token di servizio restano per automazioni nostre o helper legacy. Li puoi rimostrare dalla tabella. Per i client MCP nuovi usa OAuth remoto: nessun segreto copiato in un file di configurazione.

Operatività

Avviso «poche licenze»

Durata del token di installazione

Dominio pubblico di questa console

Viene da SINTONIA_CONSOLE_DOMINIO in console.env.

URL del canale pacchetti

Cosa non sta qui

Le quattro chiavi di console.env: senza di quelle la console non parte.

La chiave di firma dei pacchetti (§26.10): non sta sulla console. È fase V.

Il tuo secondo fattore: Utenti → Il mio accesso.

Telefonia e SMTP del cliente: restano sull'istanza (§26.3).

Stato a colpo d'occhio