Documentación

Guía operativa para el gobierno de objetivos OKR y KPI, diferenciación entre KR y KPI, planificación de cuotas, enlace bidireccional con Kanban, reenvío de correo sin API, DNS de dominios propios y despacho en mostrador.

Gobierno de objetivos

En la operación diaria de hoteles, restaurantes, estudios, agencias de viajes y comercios, las metas fracasan cuando el equipo confunde Objetivos direccionales (O), Resultados clave de avance (KR), indicadores operativos continuos (KPI) y tareas diarias. DING OS separa las cuatro capas y las conecta en vivo con ingresos, reservas, atribución de personal y tableros Kanban.

Abrir Objetivos

1. Matriz jerárquica de objetivos

Estándar empresarial
NivelLímite recomendadoPregunta centralNaturaleza de mediciónEjemplo real
OKR · Objective
Objetivo estratégico
3 - 5 por trimestre
Por sede o departamento
¿Qué salto estratégico queremos lograr este trimestre?Meta cualitativa e inspiradora trimestral o anual. El avance (0-100 %) se calcula automáticamente a partir de sus Key Results asociados.Convertirse en el destino líder de banquetes corporativos y bienestar en el T4.
KR · Key Result
Resultado clave
3 - 5 KR por Objective
Máximo 5 KR
¿Con qué cifra medimos que alcanzamos el Objective?Hito cuantitativo (desde la base X hasta la meta Y) anidado bajo un Objective. Mide una transformación o cambio neto.Elevar los ingresos de banquetes B2B de $15,000 a $40,000; subir la tasa de recompra de socios del 18 % al 35 %.
KPI · Metric
KPI operativo
3 - 5 KPI por mes
Por equipo o empleado
¿Están funcionando al nivel estándar las operaciones mensuales?Métrica cuantitativa independiente medida mes tras mes para sostener cuotas de ventas, ocupación y calidad de servicio.Cuota mensual de ingresos de $50,000; ocupación de habitaciones superior al 75 %; tasa de anulación menor al 2 %.
Task · Kanban
Tarea de ejecución
Ilimitadas
Vinculadas a 3 - 5 metas
¿Qué acción concreta ejecutamos hoy para mover los indicadores?Tarjeta accionable en el tablero Kanban con responsable, fecha límite y estado (Pendiente ➔ En curso ➔ Revisión ➔ Completado).Enviar paquetes de banquetes de fin de año a 30 empresas aliadas; llamar a 50 miembros VIP con cupones de cumpleaños.
Regla 1

Por qué los equipos confunden KR con KPI

Tanto los KR como los KPI usan números ($40,000, 300 reservas, 85 %). Para distinguirlos en 3 segundos, imagine conducir un automóvil: el KPI es el tablero de instrumentos (temperatura del motor, nivel de combustible, velocidad estable) que debe mantenerse saludable cada mes. El OKR es la ruta GPS hacia un nuevo destino y los KR son los hitos kilométricos que demuestran el avance.

Regla 2

Cuándo un KPI operativo pasa a ser un KR

Si un indicador es estable y solo asigna cuotas mensuales regulares (por ejemplo, $20,000 mensuales en barra), créelo como un KPI independiente. Pero si el KPI cae o lanza una campaña para duplicarlo el próximo trimestre (pasar de $20,000 a $45,000 lanzando noches acústicas en vivo), esa métrica se convierte en un Key Result (KR) dentro de un Objective estratégico.

Regla 3

Límite de enfoque 3-5 contra métricas infladas

El fallo más común es crear 10-15 metas simultáneas o cargar tareas cotidianas como KR para inflar el porcentaje de logro. Limite cada trimestre a 3-5 Objectives con 3-5 KR basados en resultados y asigne 3-5 KPI mensuales por colaborador vinculados a pedidos cobrados (booking.owner). Lleve las actividades diarias al tablero Kanban.

2. Despliegue de objetivos en cuatro pasos

Paso 1: Elegir la clasificación del objetivo

En Tareas ➔ Objetivos, haga clic en Crear objetivo. Elegir OKR · Objetivo estratégico abre el generador directo de 2 a 4 Key Results medibles. Elegir KPI · Métrica operativa muestra los campos Línea base, Meta y Unidad.

Paso 2: Conectar fuentes de medición en vivo

Vincule cada KR o KPI con una de cinco fuentes: Ingresos (sumados de cuentas cobradas), Reservas (pedidos completados), Atribución (desempeño en vivo mediante booking.owner), Tareas completadas (tarjetas Kanban en Completado) o Registro manual.

Paso 3: Distribuir metas con Quota Planner

Haga clic en Quota Planner, ingrese la meta total del local (por ejemplo, $60,000 mensuales), seleccione al personal participante y elija reparto equitativo o ponderado. DING OS crea los KPI individuales vinculados y mide el progreso en tiempo real.

Paso 4: Despachar tareas correctivas a Kanban

DING OS compara el avance real frente al tiempo transcurrido del periodo para señalar metas Atrasadas o En riesgo. Abra el panel Seguimiento y pulse + Añadir tarea al Board para enviar una tarjeta de acción directa al tablero Kanban.


Arquitectura del sistema

DING OS es un sistema operativo multisede de comercio, reservas y despacho en mostrador. Opera de forma autónoma o junto a su software contable o de gestión hotelera existente, normalizando correos entrantes, pedidos QR en el local y cuentas abiertas dentro de una única cola en tiempo real.

SubsistemaPunto de enlaceEspecificación operativa
Analizador MIME entrantePOST /v1/email/ingest/Recibe el tráfico SMTP dirigido a [slug]@getding.io en el borde de Cloudflare, extrae datos estructurados (cliente, artículos, horario, referencia, importe) y aplica una ventana de idempotencia SHA-256 de 30 días.
Proxy de dominios en el bordeproxy.getding.ioConecta subdominios propios (ding.yourbrand.com) e identificadores ([slug].getding.io) con contenedores aislados y gestión automática de certificados DV TLS 1.3.
Bus de despacho en mostradorwss://api.getding.io/v1/wsTransmite transiciones de estado (pending, confirmed, ready, completed) a todos los terminales vinculados mediante alerta visual persistente y tono acústico de 880Hz.
Motor multimodal de cuentasPOST /v1/counter/Ejecuta cobro inmediato, reservas por franja horaria y conciliación auditada de cuentas abiertas (reconcile_order) con atribución obligatoria (booking.owner).

Convivencia con software contable existente

DING OS funciona de forma independiente o en paralelo con su software administrativo sin alterar su catálogo contable ni su libro fiscal.

Operación de atención y venta (DING OS)

Extracción automática de pedidos por correo, tienda QR en 14 idiomas, captura conversacional de cotizaciones (capture_inquiry), auditoría de consumo en cuentas abiertas y despacho en vivo.

Registro contable administrativo (ERP, POS, PMS)

Facturación electrónica fiscal con IVA, asientos en el libro mayor, cierre diario de caja fiscal, codificación de llaves de habitación y descuento de almacén por CSV o webhook.


Ingesta de correo electrónico

Reenvíe notificaciones de pedidos, confirmaciones de reservas OTA y solicitudes de cotización B2B desde su servidor de correo hacia la dirección de su espacio sin configurar API. Los mensajes MIME se procesan directamente en la cola de despacho sin consultar IMAP ni guardar contraseñas.

Dirección de ingesta del espacio
Respaldo seguro de doble entrega

Configure la regla de reenvío activando «Conservar una copia en la bandeja de entrada». Sus buzones corporativos ([email protected], [email protected], [email protected]) conservan cada correo original como archivo principal mientras DING OS procesa una copia en paralelo.

  1. Abra Configuración de Gmail ➔ Ver todos los ajustes ➔ Reenvío y correo POP/IMAP.
  2. Seleccione Añadir una dirección de reenvío e ingrese [slug]@getding.io.
  3. Google enviará un mensaje de verificación a su espacio. Abra la Bandeja en DING OS para obtener el enlace de confirmación y autorizar el reenvío.
  4. Abra Filtros y direcciones bloqueadas ➔ Crear un filtro y escriba en Contiene las palabras: subject:(Order OR Quote OR Booking OR Reservation OR Confirmation).
  5. Active Reenviar a [slug]@getding.io, deje Omitir Recibidos sin marcar para conservar la copia original y guarde el filtro.
Supresión de bucles en 3 capas
1. Supresión por cabeceras

Las notificaciones enviadas por api.getding.io incluyen X-Ding-Generated: true y Auto-Submitted: auto-generated. El nodo SMTP descarta cualquier mensaje con estas marcas.

2. Huella de referencia

Los tickets entrantes se indexan con sha256(organization_id + ":" + reference) durante 30 días. Los envíos repetidos actualizan el estado en lugar de duplicar tickets.

3. Filtro de remitente

Los correos cuyo Return-Path o From coincide con *@getding.io o @trip.express se rechazan antes del análisis con IA.


Integraciones de canales

Guías paso a paso para Zalo Official Account (ZBS y ZNS), Telegram Bot, WhatsApp Cloud API, Messenger, Open Banking (VietQR, SePay), Stripe, PayPal y canales OTA.

Etapa 1: Activación de la aplicación Zalo

developers.zalo.me
  1. Abra developers.zalo.me, seleccione su aplicación y cambie el interruptor superior derecho a Active para que Zalo deje de devolver el error -209.
  2. En Domain verification, ingrese workspace.getding.io, copie la etiqueta meta zalo-platform-site-verification, péguela en Espacio ➔ Seguimiento y confirme la verificación.
  3. En Products ➔ Official Account API ➔ General settings, solicite permisos de administración de información OA y mensajes de usuarios.
  4. En Webhooks, configure la URL de retorno en y habilite los eventos user_send_text, user_send_image y oa_send_text.

Etapa 2: Renovación automática de tokens OAuth

API Explorer
  1. Abra developers.zalo.me/tools/explorer, elija su aplicación, seleccione OA Access Token y autorice su cuenta oficial.
  2. Copie el OA Access Token generado (válido 25 horas), el Refresh Token (válido 3 meses), junto con su App ID y App Secret desde ajustes.
  3. Pegue los cuatro valores en Integraciones ➔ Zalo OA ➔ Conexión. DING OS renueva el token en segundo plano cada 25 horas automáticamente.

Etapa 3: Vinculación de cuenta empresarial ZCA

business.zalo.me
  1. Si el selector de aplicación al crear plantillas ZBS aparece vacío, abra business.zalo.me ➔ seleccione su Cuenta ZCA ➔ Settings ➔ Applications ➔ Link application e ingrese su Zalo App ID.
  2. Nota sobre API de chat bidireccional OA (Error -224): Zalo exige una prueba activa de 1 mes o paquete OA de pago (zalo.cloud/oa/pricing) para responder mediante openapi.zalo.me/v3.0/oa/message/cs. En el plan gratuito, DING OS copia el borrador IA al portapapeles y abre oa.zalo.me/chatv2 en 1 clic.

Etapa 4: Parámetros de plantillas ZNS

account.zalo.cloud

Zalo ZNS requiere dos logotipos PNG horizontales transparentes (modo claro y oscuro) de 400 x 96 px (proporción 50:12, centrados). Cree cuatro plantillas desde la biblioteca de Zalo (Order, Transfer, Rating, Voucher) y asigne los parámetros según esta tabla:

PlantillaClave de parámetroTipo técnico ZaloValor de ejemplo
Order, Ratingorder_codeMã số (30)
Order (Enlace 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 estándar para revisión (menos de 140 caracteres)
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.

Registros DNS de dominio propio

Publique estos dos registros DNS en su proveedor (Cloudflare, Route 53, GoDaddy) para dirigir ding.yourbrand.com a través del proxy de borde.

TipoHostValor requeridoTTLEstado
CNAMEAutoPendiente
TXT
AutoPendiente
Si su zona usa Cloudflare DNS, ajuste el estado del proxy CNAME en Solo DNS (nube gris) durante la verificación inicial.Ajustes de dominio

Despacho en mostrador

Los terminales de mostrador mantienen una sesión WebSocket persistente (wss://api.getding.io/v1/ws) vinculada a su espacio. Al entrar un nuevo pedido, reserva o solicitud de cotización, se activa una alerta dual: timbre Web Audio de 880Hz y aviso visual fijo en pantalla.

Alerta acústica

Conceda permiso de sonido en las tabletas de mostrador para que las pestañas en segundo plano reproduzcan el timbre de 880Hz A5 y 1318.5Hz E6 sin toque previo, y pruebe el altavoz abajo.

ChromiumConfiguración de sitios ➔ Sonido ➔ Permitir
SafariAjustes ➔ Sitios web ➔ Reproducción automática ➔ Permitir todo
Aviso visual

Cada ticket entrante muestra una tarjeta visual fija con la referencia de unidad, nombre del cliente, categoría y acción requerida, operativa incluso cuando el altavoz está silenciado.

Canal WebSocketwss://api.getding.io/v1/ws
Respaldo en silencioTarjeta de aviso persistente

Vinculación de unidades

Los puntos de atención físicos y virtuales se modelan con la entidad Unit en las 13 categorías: spaces, realty, events, appointments, travel, mobility, retail, sports, spa, amenities, dining, drinks y takeaway. La generación de soportes QR es ilimitada en todos los planes.

Bloqueo de parámetro de ubicación

Cada código QR incorpora el identificador de la unidad (UNIT #04 o REF #12). Al escanearlo, la tienda bloquea la insignia en solo lectura para evitar que el cliente cambie manualmente de mesa, cancha o habitación.

Conciliación de cuenta abierta

Las unidades en modo de cuenta abierta permiten añadir consumos continuos durante la estancia. Antes de cerrar la factura, el personal ejecuta reconcile_order para auditar las cantidades reales consumidas y abonar devoluciones.


Atribución del personal

Todo pedido, reserva directa y cuenta conciliada registra un identificador inmutable en booking.owner. Los ingresos automatizados se marcan como System AI Ingest hasta que un operador los atiende en mostrador.

Tablero de rendimiento

DING OS nunca impone un porcentaje fijo de comisión por defecto. Cada pedido, reserva y tarea registra atribuciones por rol (SALES, OPERATIONS, FINANCE, MANAGER, OBSERVER) en el tablero en vivo para que contabilidad liquide incentivos a fin de mes según su política interna, manteniendo privados los saldos individuales en pantallas compartidas.


Aislamiento de datos

Las fronteras entre organizaciones se aplican directamente en la capa de consultas de api.getding.io. Toda solicitud queda restringida al organization_id autenticado.

Autenticación OneUID

Las sesiones de operadores se autentican mediante OneUID (uid.one) con estándares OIDC y tokens vinculados DPoP. OneUID verifica la identidad (sub) sin almacenar jamás datos CRM ni historiales de clientes.

Propiedad como responsable de datos

Cada comercio actúa como responsable independiente del tratamiento de sus perfiles de clientes, contactos y saldos cashback conforme a GDPR y normativas de privacidad, sin intercambio de datos entre comercios.


Preguntas frecuentes

Referencia técnica y operativa para propietarios, directores de operaciones y equipos de TI.

Tanto los KR como los KPI emplean cifras cuantitativas, por lo que suelen confundirse. La diferencia está en su función: un KPI mide la salud operativa continua que debe mantenerse mes tras mes (como sostener la ocupación sobre el 75 %, ingresos mensuales de $50,000 o cancelaciones bajo el 2 %). Un Key Result (KR) siempre vive dentro de un Objective estratégico (OKR) y mide un salto acotado en el tiempo desde una base X hasta una meta Y (como elevar los banquetes corporativos de $15,000 a $40,000 en el T4). Cuando un KPI cae y requiere un plan de choque, se incorpora como KR dentro de un Objective.
Última actualización: noviembre de 2026Contactar con soporte →