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.
1. Matriz jerárquica de objetivos
Estándar empresarial| Nivel | Límite recomendado | Pregunta central | Naturaleza de medición | Ejemplo 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. |
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.
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.
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
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.
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.
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.
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.
| Subsistema | Punto de enlace | Especificación operativa |
|---|---|---|
| Analizador MIME entrante | POST /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 borde | proxy.getding.io | Conecta 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 mostrador | wss://api.getding.io/v1/ws | Transmite 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 cuentas | POST /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.
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.
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.
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.
- Abra Configuración de Gmail ➔ Ver todos los ajustes ➔
Reenvío y correo POP/IMAP. - Seleccione Añadir una dirección de reenvío e ingrese
[slug]@getding.io. - 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.
- Abra Filtros y direcciones bloqueadas ➔ Crear un filtro y escriba en Contiene las palabras:
subject:(Order OR Quote OR Booking OR Reservation OR Confirmation). - Active Reenviar a
[slug]@getding.io, deje Omitir Recibidos sin marcar para conservar la copia original y guarde el filtro.
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.
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.
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- 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. - En Domain verification, ingrese
workspace.getding.io, copie la etiqueta metazalo-platform-site-verification, péguela en Espacio ➔ Seguimiento y confirme la verificación. - En Products ➔ Official Account API ➔ General settings, solicite permisos de administración de información OA y mensajes de usuarios.
- En Webhooks, configure la URL de retorno en y habilite los eventos
user_send_text,user_send_imageyoa_send_text.
Etapa 2: Renovación automática de tokens OAuth
API Explorer- Abra
developers.zalo.me/tools/explorer, elija su aplicación, seleccione OA Access Token y autorice su cuenta oficial. - 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.
- 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- 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.
- 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 medianteopenapi.zalo.me/v3.0/oa/message/cs. En el plan gratuito, DING OS copia el borrador IA al portapapeles y abreoa.zalo.me/chatv2en 1 clic.
Etapa 4: Parámetros de plantillas ZNS
account.zalo.cloudZalo 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:
| Plantilla | Clave de parámetro | Tipo técnico Zalo | Valor de ejemplo |
|---|---|---|---|
| Order, Rating | order_code | Mã số (30) | |
| Order (Enlace 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.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.
| Tipo | Host | Valor requerido | TTL | Estado |
|---|---|---|---|---|
| CNAME | Auto | Pendiente | ||
| TXT | Auto | Pendiente |
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.
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.
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.
wss://api.getding.io/v1/wsVinculació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.
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.
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.
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.
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.
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.