Documentation

Guide opérationnel pour le pilotage des objectifs OKR et KPI, la distinction entre KR et KPI, la répartition des quotas, la liaison bidirectionnelle Kanban, le transfert e-mail sans API, les DNS personnalisés et la réception comptoir.

Gouvernance des objectifs

Dans la gestion quotidienne d’un hôtel, restaurant, salon, agence de voyages ou commerce, les objectifs échouent lorsque les équipes confondent les Objectives directionnels (O), les résultats clés de percée (KR), les indicateurs courants (KPI) et les tâches quotidiennes. DING OS sépare ces quatre niveaux et les relie en temps réel au chiffre d’affaires, aux réservations, à l’attribution du personnel et au tableau Kanban.

Ouvrir Objectifs

1. Matrice hiérarchique des objectifs

Standard entreprise
NiveauLimite recommandéeQuestion centraleNature de mesureExemple concret
OKR · Objective
Objectif stratégique
3 - 5 par trimestre
Par établissement ou service
Quelle percée voulons-nous réaliser ce trimestre ?Cap qualitatif sur un trimestre ou une année. La progression (0-100 %) remonte automatiquement depuis ses Key Results associés.Devenir la destination de référence pour les banquets d’entreprise et le bien-être au T4.
KR · Key Result
Résultat clé
3 - 5 KR par Objective
Maximum 5 KR
Quel chiffre prouve que nous avons atteint l’Objective ?Jalon quantitatif (du niveau initial X vers la cible Y) rattaché à un Objective. Mesure une transformation nette.Porter le chiffre d’affaires banquets B2B de $15,000 à $40,000 ; faire passer le taux de réachat membre de 18 % à 35 %.
KPI · Metric
KPI opérationnel
3 - 5 KPI par mois
Par équipe ou collaborateur
Les opérations mensuelles tournent-elles au niveau attendu ?Indicateur quantitatif autonome suivi mois après mois pour maintenir les quotas de ventes, le taux d’occupation et la qualité de service.Quota mensuel de $50,000 ; taux d’occupation des chambres supérieur à 75 % ; taux d’annulation inférieur à 2 %.
Task · Kanban
Tâche d’exécution
Illimité
Liée à 3 - 5 objectifs
Quelle action concrète exécuter aujourd’hui pour faire progresser les chiffres ?Carte d’action sur le tableau Kanban avec responsable, échéance et statut (À faire ➔ En cours ➔ Revue ➔ Terminé).Envoyer les offres de banquet de fin d’année à 30 entreprises partenaires ; appeler 50 membres VIP pour leur remise anniversaire.
Règle 1

Pourquoi les équipes confondent KR et KPI

Les KR comme les KPI s’expriment en chiffres ($40,000, 300 réservations, 85 %). Pour les distinguer en 3 secondes, pensez à une voiture : le KPI est le tableau de bord (température moteur, jauge de carburant, vitesse de croisière) qui doit rester sain chaque mois. L’OKR est l’itinéraire GPS vers un nouveau sommet, et les KR sont les bornes kilométriques qui attestent votre avancée.

Règle 2

Quand un KPI opérationnel devient un KR

Si un indicateur est stable et que vous fixez simplement une cible mensuelle régulière (par exemple $20,000 de ventes bar par mois), créez un KPI autonome. En revanche, si ce KPI décroche ou que vous lancez une campagne pour le doubler au trimestre suivant (passer de $20,000 à $45,000 grâce à des soirées acoustiques), il devient un Key Result (KR) au sein d’un Objective stratégique.

Règle 3

Limite anti-dispersion de 3 à 5 priorités

L’erreur classique consiste à créer 10 à 15 objectifs simultanés ou à glisser des tâches courantes dans les KR pour gonfler artificiellement les scores. Limitez chaque trimestre à 3-5 Objectives dotés de 3-5 KR orientés résultats, et suivez 3-5 KPI mensuels par collaborateur reliés aux commandes encaissées (booking.owner). Placez les actions quotidiennes sur le tableau Kanban.

2. Déploiement des objectifs en quatre étapes

Étape 1 : Choisir la classification de l’objectif

Dans Tâches ➔ Objectifs, cliquez sur Créer un objectif. Le choix OKR · Objectif stratégique ouvre directement le générateur de 2 à 4 Key Results mesurables. Le choix KPI · Indicateur opérationnel affiche les champs Valeur initiale, Cible et Unité.

Étape 2 : Relier les sources de mesure en direct

Associez chaque KR ou KPI à l’une des cinq sources : Chiffre d’affaires (calculé sur les notes réglées), Réservations (commandes terminées), Attribution (performance temps réel via booking.owner), Tâches terminées (cartes Kanban passées en Terminé) ou Suivi manuel.

Étape 3 : Répartir les cibles avec Quota Planner

Cliquez sur Quota Planner, saisissez la cible globale de l’établissement (par exemple $60,000 mensuels), sélectionnez les collaborateurs concernés et choisissez une répartition égale ou pondérée. DING OS génère les KPI individuels liés et suit leur avancement en direct.

Étape 4 : Envoyer des tâches correctives vers Kanban

DING OS compare l’avancement réel au temps écoulé de la période pour signaler les objectifs En retard ou À risque. Ouvrez le tiroir Suivi et cliquez sur + Ajouter une tâche au Board pour créer immédiatement une carte d’action reliée.


Architecture système

DING OS est un système d’exploitation multi-locataire dédié au commerce, à la réservation et à la réception comptoir. Il fonctionne de manière autonome ou en façade de votre logiciel comptable ou hôtelier existant, en normalisant les e-mails entrants, les commandes QR sur place et les notes ouvertes dans une file temps réel unique.

Sous-systèmePoint d’accèsSpécification opérationnelle
Analyseur MIME entrantPOST /v1/email/ingest/Termine le trafic SMTP adressé à [slug]@getding.io sur le worker périphérique Cloudflare, extrait les entités structurées (client, articles, horaire, référence, total) et applique une fenêtre d’idempotence SHA-256 de 30 jours.
Proxy d’hôte périphériqueproxy.getding.ioAssocie les sous-domaines personnalisés (ding.yourbrand.com) et les identifiants génériques ([slug].getding.io) à des conteneurs isolés avec gestion automatique des certificats DV TLS 1.3.
Bus de réception comptoirwss://api.getding.io/v1/wsDiffuse les changements d’état des tickets (pending, confirmed, ready, completed) sur tous les terminaux jumelés avec bannière visuelle et alerte sonore 880Hz.
Moteur de facturation multimodalPOST /v1/counter/Exécute l’encaissement immédiat, la réservation par créneau et le rapprochement après contrôle des notes ouvertes (reconcile_order) avec attribution obligatoire (booking.owner).

Coexistence avec vos logiciels existants

DING OS s’utilise seul ou en parallèle de votre comptabilité existante sans modifier votre plan comptable ni votre journal fiscal.

Opérations de réception et vente (DING OS)

Extraction d’e-mails de commandes et réservations, boutique QR en 14 langues, capture de devis conversationnels (capture_inquiry), pointage des quantités consommées et réception comptoir en direct.

Système comptable de référence (ERP, POS, PMS)

Facturation électronique TVA réglementaire, écritures au grand livre, clôture fiscale journalière, encodage des clés de chambre et déstockage par export CSV ou synchronisation webhook.


Ingestion e-mail

Transférez vos notifications de commandes, confirmations OTA et demandes de devis B2B depuis votre serveur mail vers l’adresse d’ingestion de votre espace sans configuration d’API. Les messages MIME entrants sont analysés directement dans la file de réception sans interroger IMAP ni stocker vos mots de passe.

Adresse d’ingestion cible
Sécurité par double remise

Activez l’option « Conserver une copie dans la boîte de réception » dans votre règle de transfert. Vos boîtes professionnelles ([email protected], [email protected], [email protected]) conservent chaque message original comme archive principale tandis que DING OS traite une copie en parallèle.

  1. Ouvrez Paramètres Gmail ➔ Voir tous les paramètres ➔ Transfert et POP/IMAP.
  2. Sélectionnez Ajouter une adresse de transfert et saisissez [slug]@getding.io.
  3. Google envoie un message de vérification à votre espace. Ouvrez la Boîte de réception DING OS pour récupérer le lien de confirmation et valider.
  4. Ouvrez Filtres et adresses bloquées ➔ Créer un filtre et définissez le champ Contient les mots sur subject:(Order OR Quote OR Booking OR Reservation OR Confirmation).
  5. Activez Transférer à [slug]@getding.io, laissez Ignorer la boîte de réception décoché afin de conserver la copie originale, puis enregistrez.
Suppression des boucles à 3 niveaux
1. Filtrage par en-têtes

Les notifications sortantes de api.getding.io incluent X-Ding-Generated: true et Auto-Submitted: auto-generated. Le worker SMTP ignore tout message portant ces en-têtes.

2. Empreinte de référence

Les tickets entrants sont indexés via sha256(organization_id + ":" + reference) durant 30 jours. Les renvois mettent à jour le statut sans créer de doublons.

3. Filtre d’enveloppe système

Les messages dont le Return-Path ou From correspond à *@getding.io ou @trip.express sont rejetés avant l’analyse IA.


Intégrations canaux

Guides pas à pas pour Zalo Official Account (ZBS et ZNS), Telegram Bot, WhatsApp Cloud API, Messenger, Open Banking (VietQR, SePay), Stripe, PayPal et les plateformes OTA.

Étape 1 : Activation de l’application Zalo

developers.zalo.me
  1. Ouvrez developers.zalo.me, sélectionnez votre application et basculez le bouton en haut à droite sur Active pour éviter le code d’erreur -209.
  2. Dans Domain verification, saisissez workspace.getding.io, copiez la balise meta zalo-platform-site-verification, collez-la dans Espace ➔ Suivi et validez la vérification.
  3. Dans Products ➔ Official Account API ➔ General settings, demandez les autorisations de gestion des informations OA et des messages utilisateurs.
  4. Dans Webhooks, définissez l’URL de rappel sur et activez les événements user_send_text, user_send_image et oa_send_text.

Étape 2 : Renouvellement automatique des jetons OAuth

API Explorer
  1. Ouvrez developers.zalo.me/tools/explorer, sélectionnez votre application, choisissez OA Access Token et autorisez votre compte officiel.
  2. Copiez le OA Access Token généré (valide 25 heures), le Refresh Token (valide 3 mois), ainsi que votre App ID et votre App Secret depuis les paramètres.
  3. Collez ces quatre valeurs dans Intégrations ➔ Zalo OA ➔ Connexion. DING OS renouvelle automatiquement le jeton en arrière-plan toutes les 25 heures.

Étape 3 : Liaison du compte professionnel ZCA

business.zalo.me
  1. Si le menu déroulant d’applications lors de la création d’un modèle ZBS est vide, ouvrez business.zalo.me ➔ votre Compte ZCA ➔ Settings ➔ Applications ➔ Link application et renseignez votre Zalo App ID.
  2. Note sur l’API de discussion OA bidirectionnelle (Erreur -224) : Zalo exige une offre d’essai d’un mois ou un forfait OA payant (zalo.cloud/oa/pricing) pour envoyer des réponses via openapi.zalo.me/v3.0/oa/message/cs. Sur l’offre gratuite, DING OS copie automatiquement le brouillon IA et ouvre oa.zalo.me/chatv2 en un clic.

Étape 4 : Paramètres des modèles ZNS

account.zalo.cloud

Zalo ZNS requiert deux logos PNG transparents horizontaux (modes clair et sombre) au format 400 x 96 px (ratio 50:12, centrés). Créez quatre modèles depuis la bibliothèque Zalo (Order, Transfer, Rating, Voucher) et associez les paramètres selon le tableau ci-dessous :

ModèleClé du paramètreType technique ZaloValeur d’exemple
Order, Ratingorder_codeMã số (30)
Order (Lien 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)
Note standard pour le vérificateur (moins de 140 caractères)
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.

Enregistrements DNS du domaine personnalisé

Publiez ces deux enregistrements DNS chez votre bureau d’enregistrement (Cloudflare, Route 53, GoDaddy) afin de router ding.yourbrand.com via le proxy périphérique.

TypeHôteValeur requiseTTLStatut
CNAMEAutoEn attente
TXT
AutoEn attente
Si votre zone utilise Cloudflare DNS, réglez le proxy CNAME sur DNS uniquement (nuage gris) lors de la vérification initiale.Paramètres de domaine

Réception comptoir

Les terminaux comptoir maintiennent une connexion WebSocket permanente (wss://api.getding.io/v1/ws) propre à votre espace. À chaque nouvelle commande, réservation ou demande de devis, le terminal déclenche une double alerte : un carillon Web Audio à 880Hz et une bannière visuelle persistante.

Alerte sonore

Autorisez le son du site sur vos tablettes comptoir afin que les onglets en arrière-plan synthétisent le carillon 880Hz A5 et 1318.5Hz E6 sans interaction préalable, puis testez le haut-parleur ci-dessous.

ChromiumParamètres du site ➔ Son ➔ Autoriser
SafariRéglages ➔ Sites web ➔ Lecture automatique ➔ Tout autoriser
Bannière visuelle

Chaque ticket entrant affiche une bannière de notification persistante indiquant l’unité, le nom du client, la catégorie et l’action requise, fonctionnant même lorsque le son de l’appareil est coupé.

Flux WebSocketwss://api.getding.io/v1/ws
Mode silencieuxCarte d’alerte persistante

Liaison des unités

Les points de service physiques et virtuels reposent sur l’entité canonique Unit à travers les 13 catégories : spaces, realty, events, appointments, travel, mobility, retail, sports, spa, amenities, dining, drinks et takeaway. La création de supports QR est illimitée sur tous les forfaits.

Verrouillage de l’emplacement

Chaque support QR intègre l’identifiant de l’unité cible (UNIT #04 ou REF #12). Une fois scanné, le badge d’emplacement est verrouillé en lecture seule pour empêcher toute erreur de table, de court ou de chambre.

Rapprochement des notes ouvertes

Les unités configurées en note ouverte permettent l’ajout continu d’articles pendant toute la session. Avant d’encaisser, l’équipe exécute reconcile_order pour contrôler les quantités réellement consommées et déduire les retours.


Attribution du personnel

Chaque commande, réservation au comptoir et note rapprochée enregistre un identifiant immuable dans booking.owner. Les flux automatisés reçoivent par défaut System AI Ingest jusqu’à leur prise en charge par un opérateur.

Tableau de performance

DING OS n’impose aucun pourcentage de commission fixe par défaut. Chaque commande, réservation et tâche enregistre les rôles contributeurs (SALES, OPERATIONS, FINANCE, MANAGER, OBSERVER) sur le tableau de performance afin que votre comptabilité calcule les primes en fin de mois selon votre barème interne, tout en préservant la confidentialité sur les écrans partagés.


Isolation des données

Le cloisonnement entre établissements est appliqué directement au niveau des requêtes SQL dans api.getding.io. Chaque requête est strictement filtrée par le organization_id de la session authentifiée.

Authentification OneUID

Les sessions opérateurs sont authentifiées via OneUID (uid.one) selon les standards OIDC et DPoP. OneUID vérifie uniquement l’identité (sub) sans jamais stocker vos données CRM ni l’historique des transactions.

Propriété des données clients

Chaque établissement agit en tant que responsable de traitement indépendant pour ses fiches clients, coordonnées et soldes cashback conformément au RGPD, sans aucun partage croisé entre marchands.


Questions fréquentes

Référence technique et opérationnelle pour les dirigeants, responsables d’exploitation et équipes informatiques.

Les KR et les KPI utilisent tous deux des chiffres, d’où la confusion fréquente. Leur différence tient à leur rôle : un KPI mesure la santé opérationnelle permanente à maintenir chaque mois (par exemple garder le taux d’occupation au-dessus de 75 %, un chiffre d’affaires mensuel de $50,000 ou un taux d’annulation sous 2 %). Un Key Result (KR) appartient toujours à un Objective stratégique (OKR) et mesure une percée datée d’un niveau X vers une cible Y (par exemple faire passer les ventes de banquets B2B de $15,000 à $40,000 au T4). Lorsqu’un KPI faiblit et exige un plan de relance, il devient un KR dans un Objective.
Dernière mise à jour : novembre 2026Contacter le support →