Documentazione

Guida operativa per la governance degli obiettivi OKR e KPI, distinzione tra KR e KPI, pianificazione quote, collegamento bidirezionale Kanban, inoltro email senza API, DNS personalizzati e gestione al banco.

Governance degli obiettivi

Nella gestione quotidiana di hotel, ristoranti, studi, tour operator e negozi, i sistemi di obiettivi falliscono quando il team confonde Objectives direzionali (O), Key Results di svolta (KR), metriche operative continue (KPI) e attività giornaliere. DING OS distingue tutti e quattro i livelli collegandoli in tempo reale a ricavi, prenotazioni, attribuzione dello staff e bacheche Kanban.

Apri Obiettivi

1. Matrice gerarchica degli obiettivi

Standard aziendale
LivelloLimite consigliatoDomanda chiaveNatura della misuraEsempio pratico
OKR · Objective
Obiettivo strategico
3 - 5 a trimestre
Per sede o reparto
Quale svolta vogliamo ottenere in questo trimestre?Traguardo qualitativo per un trimestre o un anno. L’avanzamento (0-100%) viene calcolato automaticamente dai Key Results collegati.Diventare la struttura di riferimento per eventi aziendali e benessere nel Q4.
KR · Key Result
Risultato chiave
3 - 5 KR per Objective
Massimo 5 KR
Con quale numero misuriamo il raggiungimento dell’Objective?Traguardo quantitativo (dalla base X al target Y) all’interno di un Objective. Misura una crescita o trasformazione netta.Portare i ricavi banchetti B2B da $15,000 a $40,000; aumentare il tasso di riacquisto membri dal 18% al 35%.
KPI · Metric
KPI operativo
3 - 5 KPI al mese
Per reparto o collaboratore
Le operazioni giornaliere e mensili rispettano gli standard?Metrica quantitativa autonoma monitorata mese dopo mese per mantenere quote di fatturato, occupazione e qualità del servizio.Quota ricavi mensile di $50,000; occupazione camere oltre il 75%; tasso di annullamento ordini sotto il 2%.
Task · Kanban
Attività esecutiva
Illimitate
Collegate a 3 - 5 obiettivi
Quale azione concreta eseguiamo oggi per far crescere i numeri?Scheda operativa sulla bacheca Kanban con responsabile, scadenza e stato (Da fare ➔ In corso ➔ Revisione ➔ Completato).Inviare pacchetti gala di fine anno a 30 aziende partner; chiamare 50 clienti VIP con voucher compleanno.
Regola 1

Perché i team confondono KR e KPI

Sia i KR sia i KPI usano numeri ($40,000, 300 prenotazioni, 85%). Per distinguerli in 3 secondi, immagina un’auto: il KPI è il cruscotto (temperatura motore, livello carburante, velocità di crociera) che deve restare regolare ogni mese. L’OKR è il percorso GPS verso una nuova meta, mentre i KR sono le pietre miliari lungo il tragitto.

Regola 2

Quando un KPI operativo diventa un KR

Se una metrica è stabile e assegni solo quote mensili costanti (ad esempio $20,000 di incasso bar al mese), creala come KPI autonomo. Se invece il KPI cala o lanci una campagna per raddoppiarlo nel prossimo trimestre (portare il bar da $20,000 a $45,000 con serate live), quella metrica diventa un Key Result (KR) dentro un Objective strategico.

Regola 3

Limite 3-5 contro la dispersione

L’errore più diffuso è creare 10-15 obiettivi insieme o inserire mansioni ordinarie nei KR per gonfiare le percentuali. Limita ogni trimestre a 3-5 Objectives con 3-5 KR orientati ai risultati e assegna 3-5 KPI mensili per collaboratore legati agli ordini saldati (booking.owner). Sposta le attività quotidiane sulla bacheca Kanban.

2. Attivazione degli obiettivi in quattro passaggi

Passaggio 1: Scegliere la classificazione

In Attività ➔ Obiettivi, clicca su Crea obiettivo. Scegliendo OKR · Obiettivo strategico si apre il generatore rapido per definire 2-4 Key Results misurabili. Scegliendo KPI · Metrica operativa compaiono i campi Valore iniziale, Target e Unità.

Passaggio 2: Collegare le fonti dati in tempo reale

Associa ogni KR o KPI a una delle cinque fonti: Ricavi (sommati dai conti saldati), Prenotazioni (ordini completati), Attribuzione (performance live tramite booking.owner), Attività completate (schede Kanban in Completato) o Aggiornamento manuale.

Passaggio 3: Ripartire i target con Quota Planner

Clicca su Quota Planner, inserisci il target complessivo della sede (ad esempio $60,000 mensili), seleziona i collaboratori coinvolti e scegli distribuzione equa o ponderata. DING OS genera i KPI individuali collegati e traccia i risultati in diretta.

Passaggio 4: Inviare azioni correttive su Kanban

DING OS confronta i progressi effettivi con il tempo trascorso nel periodo per segnalare gli obiettivi In ritardo o A rischio. Apri il pannello Check-in e clicca su + Aggiungi attività al Board per inviare subito una scheda operativa su Kanban.


Architettura di sistema

DING OS è un sistema operativo multi-tenant per vendita diretta, prenotazioni e coordinamento al banco. Opera in autonomia oppure a fianco del tuo gestionale contabile o alberghiero, normalizzando email in ingresso, ordini QR in sede e conti aperti in un’unica coda in tempo reale.

SottosistemaEndpointSpecifica operativa
Parser MIME in ingressoPOST /v1/email/ingest/Termina il traffico SMTP diretto a [slug]@getding.io sull’edge worker Cloudflare, estrae entità strutturate (cliente, voci, orario, riferimento, totale) e applica una finestra di idempotenza SHA-256 di 30 giorni.
Proxy edge per dominiproxy.getding.ioMappa sottodomini personalizzati (ding.yourbrand.com) e handle ([slug].getding.io) su container isolati con gestione automatica dei certificati DV TLS 1.3.
Bus di smistamento al bancowss://api.getding.io/v1/wsTrasmette le transizioni di stato (pending, confirmed, ready, completed) a tutti i terminali abbinati con avviso visivo persistente e segnale acustico a 880Hz.
Motore conti multimodalePOST /v1/counter/Gestisce incasso immediato, prenotazioni a fascia oraria e riconciliazione post-verifica dei conti aperti (reconcile_order) con attribuzione obbligatoria (booking.owner).

Coesistenza con software gestionali esistenti

DING OS può operare da solo o affiancare il software amministrativo esistente senza modificare il piano dei conti né il registro fiscale.

Operatività front-office (DING OS)

Estrazione automatica di ordini e prenotazioni da email, vetrina QR in 14 lingue, raccolta preventivi in chat (capture_inquiry), verifica consumi conti aperti e coordinamento al banco.

Contabilità e libro mastro (ERP, POS, PMS)

Fatturazione elettronica IVA, scritture in prima nota, chiusura fiscale giornaliera, codifica tessere camera e scarico magazzino tramite CSV o sincronizzazione webhook.


Acquisizione email

Inoltra notifiche d’ordine, conferme OTA e richieste di preventivo B2B dal tuo server di posta all’indirizzo del tuo spazio senza configurare API. I messaggi MIME vengono estratti direttamente nella coda operativa senza polling IMAP né salvataggio di password.

Indirizzo di acquisizione
Sicurezza a doppia consegna

Configura la regola di inoltro attivando «Conserva una copia nella posta in arrivo». Le caselle aziendali ([email protected], [email protected], [email protected]) mantengono ogni messaggio originale come archivio primario mentre DING OS elabora una copia in parallelo.

  1. Apri Impostazioni Gmail ➔ Visualizza tutte le impostazioni ➔ Inoltro e POP/IMAP.
  2. Seleziona Aggiungi un indirizzo di inoltro e inserisci [slug]@getding.io.
  3. Google invia un’email di verifica al tuo spazio. Apri la vista Posta in DING OS per recuperare il link di conferma e approvare.
  4. Apri Filtri e indirizzi bloccati ➔ Crea un nuovo filtro e imposta il campo Contiene le parole su subject:(Order OR Quote OR Booking OR Reservation OR Confirmation).
  5. Attiva Inoltra a [slug]@getding.io, lascia deselezionato Ignora Posta in arrivo per conservare l’originale e salva il filtro.
Prevenzione loop a 3 livelli
1. Soppressione tramite header

Le notifiche inviate da api.getding.io includono X-Ding-Generated: true e Auto-Submitted: auto-generated. Il worker SMTP scarta ogni messaggio con queste intestazioni.

2. Impronta di riferimento

I ticket in entrata sono indicizzati tramite sha256(organization_id + ":" + reference) per 30 giorni. Gli invii ripetuti aggiornano lo stato senza duplicare la scheda.

3. Filtro mittenti di sistema

I messaggi con Return-Path o From corrispondenti a *@getding.io o @trip.express vengono scartati prima dell’analisi IA.


Integrazioni canali

Guide operative passo passo per Zalo Official Account (ZBS e ZNS), Telegram Bot, WhatsApp Cloud API, Messenger, Open Banking (VietQR, SePay), Stripe, PayPal e portali OTA.

Fase 1: Attivazione applicazione Zalo

developers.zalo.me
  1. Apri developers.zalo.me, seleziona la tua applicazione e porta l’interruttore in alto a destra su Active affinché Zalo non restituisca più l’errore -209.
  2. In Domain verification, inserisci workspace.getding.io, copia il meta tag zalo-platform-site-verification, incollalo in Spazio ➔ Tracciamento e conferma la verifica.
  3. In Products ➔ Official Account API ➔ General settings, richiedi i permessi per gestione profilo OA e messaggi utenti.
  4. In Webhooks, imposta l’URL di callback su e attiva gli eventi user_send_text, user_send_image e oa_send_text.

Fase 2: Rinnovo automatico token OAuth

API Explorer
  1. Apri developers.zalo.me/tools/explorer, seleziona l’app, scegli OA Access Token e autorizza il tuo Official Account.
  2. Copia OA Access Token (valido 25 ore), Refresh Token (valido 3 mesi), oltre ad App ID e App Secret dalle impostazioni.
  3. Incolla tutti e quattro i valori in Integrazioni ➔ Zalo OA ➔ Connessione. DING OS rinnova automaticamente il token in background ogni 25 ore.

Fase 3: Collegamento account aziendale ZCA

business.zalo.me
  1. Se il menu applicazione durante la creazione template ZBS è vuoto, apri business.zalo.me ➔ seleziona Account ZCA ➔ Settings ➔ Applications ➔ Link application e inserisci il tuo Zalo App ID.
  2. Nota API chat bidirezionale OA (Errore -224): Zalo richiede una prova attiva di 1 mese o un piano OA a pagamento (zalo.cloud/oa/pricing) per inviare risposte tramite openapi.zalo.me/v3.0/oa/message/cs. Sul piano gratuito, DING OS copia la bozza IA negli appunti e apre oa.zalo.me/chatv2 con 1 clic.

Fase 4: Parametri template ZNS

account.zalo.cloud

Zalo ZNS richiede due loghi PNG orizzontali trasparenti (modalità chiara e scura) da 400 x 96 px (proporzione 50:12, centrati). Crea quattro modelli dalla libreria Zalo (Order, Transfer, Rating, Voucher) e associa i parametri secondo la tabella seguente:

ModelloChiave parametroTipo tecnico ZaloValore di esempio
Order, Ratingorder_codeMã số (30)
Order (Link CTA)order_idURL (200)
Orderphone_numberThông tin liên hệ (50)
Order, TransferpriceSố lượng / Số tiền (20)
OrderstatusTrạng thái giao dịch (30)
OrderdateThời gian (20)
OrdernameTên khách hàng (30)
Transfer, Rating, Vouchercustomer_nameTên khách hàng (30)
Transfercontract_numberMã số (30)
Transfertransfer_amountTiền tệ (VNĐ) (12)
Transferbank_transfer_noteBank Transfer Note (90)
Ratingorder_dateThời gian (20)
Vouchercustomer_idMã số (30)
Vouchervoucher_codeMã số (30)
Voucherstart_dateThời gian (20)
VoucherexpireThời gian (20)
Nota standard per il revisore (sotto 140 caratteri)
Gửi tự động xác nhận mã đơn, tổng tiền và trạng thái ngay khi khách đặt dịch vụ thành công. Không chứa quảng cáo.

Record DNS dominio personalizzato

Pubblica questi due record DNS presso il tuo registrar (Cloudflare, Route 53, GoDaddy) per instradare ding.yourbrand.com attraverso il proxy edge.

TipoHostValore richiestoTTLStato
CNAMEAutoIn attesa
TXT
AutoIn attesa
Se la tua zona usa Cloudflare DNS, imposta lo stato proxy del CNAME su Solo DNS (nuvola grigia) durante la verifica iniziale.Impostazioni dominio

Gestione al banco

I terminali al banco mantengono una sessione WebSocket continua (wss://api.getding.io/v1/ws) dedicata al tuo spazio. All’arrivo di un nuovo ordine, prenotazione o preventivo viene attivato un doppio avviso: segnale audio Web Audio a 880Hz e banner visivo persistente.

Avviso acustico

Concedi il permesso audio del sito sui tablet di cassa affinché le schede in background riproducano il tono 880Hz A5 e 1318.5Hz E6 senza tocco manuale, quindi prova l’altoparlante qui sotto.

ChromiumImpostazioni sito ➔ Audio ➔ Consenti
SafariImpostazioni ➔ Siti web ➔ Riproduzione automatica ➔ Consenti tutto
Banner visivo

Ogni ticket in arrivo mostra un banner di notifica persistente con unità, nome cliente, categoria e azione richiesta, pienamente visibile anche con audio disattivato.

Canale WebSocketwss://api.getding.io/v1/ws
Protezione mutoScheda visiva persistente

Associazione unità

I punti di servizio fisici e virtuali utilizzano l’entità Unit in tutte le 13 categorie: spaces, realty, events, appointments, travel, mobility, retail, sports, spa, amenities, dining, drinks e takeaway. La creazione di codici QR è illimitata su tutti i piani.

Blocco in sola lettura della posizione

Ogni supporto QR codifica l’identificativo dell’unità (UNIT #04 o REF #12). Dopo la scansione, il badge viene bloccato in sola lettura impedendo cambi involontari di tavolo, campo o camera.

Riconciliazione conti aperti

Le unità in modalità conto aperto consentono aggiunte continue durante la sessione. Prima della chiusura, il personale esegue reconcile_order per verificare le quantità effettivamente consumate e stornare i resi.


Attribuzione del personale

Ogni ordine, prenotazione diretta e conto riconciliato registra un identificativo immutabile in booking.owner. Gli ordini automatici riportano System AI Ingest finché un operatore non li prende in carico.

Bacheca delle performance

DING OS non applica mai percentuali di commissione fisse predefinite. Ogni ordine, prenotazione e attività registra i ruoli operativi (SALES, OPERATIONS, FINANCE, MANAGER, OBSERVER) sulla bacheca live così che l’amministrazione calcoli i premi a fine mese secondo il regolamento interno, mantenendo riservati gli importi sugli schermi condivisi.


Isolamento dei dati

La separazione tra organizzazioni è applicata direttamente a livello di query nel database di api.getding.io. Ogni richiesta è vincolata al organization_id autenticato.

Autenticazione OneUID

Le sessioni operatore vengono autenticate tramite OneUID (uid.one) con protocolli OIDC e token vincolati DPoP. OneUID verifica esclusivamente l’identità (sub) senza archiviare dati CRM o transazioni.

Titolarità autonoma dei dati

Ogni attività opera come titolare autonomo del trattamento per anagrafiche clienti, recapiti e portafogli cashback ai sensi del GDPR, con zero condivisione di dati tra esercenti.


Domande frequenti

Riferimento tecnico e operativo per titolari, responsabili operativi e team IT.

Sia i KR sia i KPI utilizzano valori numerici, motivo per cui vengono spesso confusi. La differenza sta nello scopo: un KPI misura la salute operativa continua da mantenere mese dopo mese (ad esempio occupazione camere oltre il 75%, ricavi mensili a $50,000 o annullamenti sotto il 2%). Un Key Result (KR) vive sempre dentro un Objective strategico (OKR) e misura un balzo temporizzato dalla base X al target Y (ad esempio far crescere i banchetti aziendali da $15,000 a $40,000 nel Q4). Quando un KPI cala e richiede un rilancio mirato, diventa un KR dentro un Objective.
Ultimo aggiornamento: novembre 2026Contatta il supporto →