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.
1. Matrice hiérarchique des objectifs
Standard entreprise| Niveau | Limite recommandée | Question centrale | Nature de mesure | Exemple 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. |
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.
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.
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
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é.
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.
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.
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ème | Point d’accès | Spécification opérationnelle |
|---|---|---|
| Analyseur MIME entrant | POST /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érique | proxy.getding.io | Associe 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 comptoir | wss://api.getding.io/v1/ws | Diffuse 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 multimodal | POST /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.
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.
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.
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.
- Ouvrez Paramètres Gmail ➔ Voir tous les paramètres ➔
Transfert et POP/IMAP. - Sélectionnez Ajouter une adresse de transfert et saisissez
[slug]@getding.io. - 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.
- 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). - Activez Transférer à
[slug]@getding.io, laissez Ignorer la boîte de réception décoché afin de conserver la copie originale, puis enregistrez.
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.
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.
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- Ouvrez developers.zalo.me, sélectionnez votre application et basculez le bouton en haut à droite sur Active pour éviter le code d’erreur
-209. - Dans Domain verification, saisissez
workspace.getding.io, copiez la balise metazalo-platform-site-verification, collez-la dans Espace ➔ Suivi et validez la vérification. - Dans Products ➔ Official Account API ➔ General settings, demandez les autorisations de gestion des informations OA et des messages utilisateurs.
- Dans Webhooks, définissez l’URL de rappel sur et activez les événements
user_send_text,user_send_imageetoa_send_text.
Étape 2 : Renouvellement automatique des jetons OAuth
API Explorer- Ouvrez
developers.zalo.me/tools/explorer, sélectionnez votre application, choisissez OA Access Token et autorisez votre compte officiel. - 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.
- 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- 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.
- 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 viaopenapi.zalo.me/v3.0/oa/message/cs. Sur l’offre gratuite, DING OS copie automatiquement le brouillon IA et ouvreoa.zalo.me/chatv2en un clic.
Étape 4 : Paramètres des modèles ZNS
account.zalo.cloudZalo 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èle | Clé du paramètre | Type technique Zalo | Valeur d’exemple |
|---|---|---|---|
| Order, Rating | order_code | Mã số (30) | |
| Order (Lien 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.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.
| Type | Hôte | Valeur requise | TTL | Statut |
|---|---|---|---|---|
| CNAME | Auto | En attente | ||
| TXT | Auto | En attente |
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.
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.
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é.
wss://api.getding.io/v1/wsLiaison 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.
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.
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.
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.
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.
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.