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.
1. Matrice gerarchica degli obiettivi
Standard aziendale| Livello | Limite consigliato | Domanda chiave | Natura della misura | Esempio 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. |
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.
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.
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
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à.
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.
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.
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.
| Sottosistema | Endpoint | Specifica operativa |
|---|---|---|
| Parser MIME in ingresso | POST /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 domini | proxy.getding.io | Mappa 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 banco | wss://api.getding.io/v1/ws | Trasmette le transizioni di stato (pending, confirmed, ready, completed) a tutti i terminali abbinati con avviso visivo persistente e segnale acustico a 880Hz. |
| Motore conti multimodale | POST /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.
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.
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.
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.
- Apri Impostazioni Gmail ➔ Visualizza tutte le impostazioni ➔
Inoltro e POP/IMAP. - Seleziona Aggiungi un indirizzo di inoltro e inserisci
[slug]@getding.io. - Google invia un’email di verifica al tuo spazio. Apri la vista Posta in DING OS per recuperare il link di conferma e approvare.
- 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). - Attiva Inoltra a
[slug]@getding.io, lascia deselezionato Ignora Posta in arrivo per conservare l’originale e salva il filtro.
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.
I ticket in entrata sono indicizzati tramite sha256(organization_id + ":" + reference) per 30 giorni. Gli invii ripetuti aggiornano lo stato senza duplicare la scheda.
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- 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. - In Domain verification, inserisci
workspace.getding.io, copia il meta tagzalo-platform-site-verification, incollalo in Spazio ➔ Tracciamento e conferma la verifica. - In Products ➔ Official Account API ➔ General settings, richiedi i permessi per gestione profilo OA e messaggi utenti.
- In Webhooks, imposta l’URL di callback su e attiva gli eventi
user_send_text,user_send_imageeoa_send_text.
Fase 2: Rinnovo automatico token OAuth
API Explorer- Apri
developers.zalo.me/tools/explorer, seleziona l’app, scegli OA Access Token e autorizza il tuo Official Account. - Copia OA Access Token (valido 25 ore), Refresh Token (valido 3 mesi), oltre ad App ID e App Secret dalle impostazioni.
- 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- 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.
- 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 tramiteopenapi.zalo.me/v3.0/oa/message/cs. Sul piano gratuito, DING OS copia la bozza IA negli appunti e apreoa.zalo.me/chatv2con 1 clic.
Fase 4: Parametri template ZNS
account.zalo.cloudZalo 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:
| Modello | Chiave parametro | Tipo tecnico Zalo | Valore di esempio |
|---|---|---|---|
| Order, Rating | order_code | Mã số (30) | |
| Order (Link CTA) | order_id | URL (200) | |
| Order | phone_number | Thông tin liên hệ (50) | |
| Order, Transfer | price | Số lượng / Số tiền (20) | |
| Order | status | Trạng thái giao dịch (30) | |
| Order | date | Thời gian (20) | |
| Order | name | Tên khách hàng (30) | |
| Transfer, Rating, Voucher | customer_name | Tên khách hàng (30) | |
| Transfer | contract_number | Mã số (30) | |
| Transfer | transfer_amount | Tiền tệ (VNĐ) (12) | |
| Transfer | bank_transfer_note | Bank Transfer Note (90) | |
| Rating | order_date | Thời gian (20) | |
| Voucher | customer_id | Mã số (30) | |
| Voucher | voucher_code | Mã số (30) | |
| Voucher | start_date | Thời gian (20) | |
| Voucher | expire | Thời gian (20) |
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.
| Tipo | Host | Valore richiesto | TTL | Stato |
|---|---|---|---|---|
| CNAME | Auto | In attesa | ||
| TXT | Auto | In attesa |
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.
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.
Ogni ticket in arrivo mostra un banner di notifica persistente con unità, nome cliente, categoria e azione richiesta, pienamente visibile anche con audio disattivato.
wss://api.getding.io/v1/wsAssociazione 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.
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.
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.
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.
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.
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.