Documentação

Guia operacional para governança de metas OKR e KPI, diferença entre KR e KPI, planeamento de quotas, ligação bidirecional Kanban, reencaminhamento de e-mail sem API, DNS personalizado e atendimento no balcão.

Governança de metas

Na operação diária de hotéis, restaurantes, estúdios, operadores turísticos e lojas, as metas falham quando a equipa confunde Objectives direcionais (O), Key Results de avanço (KR), indicadores contínuos (KPI) e tarefas diárias. O DING OS separa as quatro camadas e liga-as em tempo real à faturação, reservas, atribuição da equipa e quadros Kanban.

Abrir Metas

1. Matriz hierárquica de metas

Padrão empresarial
CamadaLimite recomendadoPergunta centralNatureza da mediçãoExemplo real
OKR · Objective
Objetivo estratégico
3 - 5 por trimestre
Por unidade ou departamento
Que avanço estratégico queremos alcançar neste trimestre?Direção qualitativa trimestral ou anual. O progresso (0-100%) soma automaticamente a partir dos Key Results associados.Tornar-se o principal destino para eventos corporativos e bem-estar no 4.º trimestre.
KR · Key Result
Resultado-chave
3 - 5 KR por Objective
Máximo 5 KR
Com que número provamos que atingimos o Objective?Marco quantitativo (da base X até à meta Y) dentro de um Objective. Mede transformação líquida.Aumentar a receita de banquetes B2B de $15,000 para $40,000; elevar a recompra de membros de 18% para 35%.
KPI · Metric
KPI operacional
3 - 5 KPI por mês
Por equipa ou colaborador
A operação mensal está a funcionar dentro do padrão?Indicador quantitativo autónomo acompanhado todos os meses para sustentar quotas de vendas, ocupação e nível de serviço.Meta mensal de $50,000; ocupação de quartos acima de 75%; taxa de cancelamento abaixo de 2%.
Task · Kanban
Tarefa de execução
Ilimitadas
Ligadas a 3 - 5 metas
Que ação concreta executamos hoje para mover os indicadores?Cartão prático no quadro Kanban com responsável, prazo e estado (A fazer ➔ Em curso ➔ Revisão ➔ Concluído).Enviar pacotes de eventos de fim de ano a 30 empresas parceiras; ligar a 50 clientes VIP com cupão de aniversário.
Regra 1

Porque é que as equipas confundem KR com KPI

Tanto KR como KPI usam números ($40,000, 300 reservas, 85%). Para distinguir em 3 segundos, imagine conduzir um automóvel: o KPI é o painel do veículo (temperatura do motor, combustível, velocidade estável) que deve manter-se saudável todos os meses. O OKR é a rota GPS até um novo destino, e os KR são os marcos quilométricos pelo caminho.

Regra 2

Quando um KPI operacional se torna um KR

Se um indicador está estável e apenas define quotas mensais regulares (como $20,000 mensais no bar), crie um KPI autónomo. Porém, se esse indicador cair ou se lançar uma campanha para o duplicar no próximo trimestre (passar de $20,000 para $45,000 com noites de música ao vivo), ele passa a ser um Key Result (KR) dentro de um Objective estratégico.

Regra 3

Limite de foco 3-5 contra métricas artificiais

O erro mais comum é criar 10-15 metas em simultâneo ou colocar tarefas banais dentro dos KR para inflacionar resultados. Limite cada trimestre a 3-5 Objectives com 3-5 KR orientados a resultados e defina 3-5 KPI mensais por colaborador ligados a pedidos pagos (booking.owner). Coloque as tarefas diárias no quadro Kanban.

2. Implementação de metas em quatro passos

Passo 1: Selecionar a classificação da meta

Em Tarefas ➔ Metas, clique em Criar meta. Escolher OKR · Objetivo estratégico abre o construtor rápido para definir 2-4 Key Results mensuráveis. Escolher KPI · Métrica operacional apresenta os campos Base inicial, Alvo e Unidade.

Passo 2: Ligar fontes de dados em tempo real

Associe cada KR ou KPI a uma de cinco fontes: Receita (somada das contas liquidadas), Reservas (pedidos concluídos), Atribuição (desempenho em direto via booking.owner), Tarefas concluídas (cartões Kanban em Concluído) ou Registo manual.

Passo 3: Distribuir metas com Quota Planner

Clique em Quota Planner, indique a meta global do espaço (por exemplo, $60,000 mensais), selecione a equipa participante e escolha divisão igual ou ponderada. O DING OS gera os KPI individuais ligados e acompanha o progresso em direto.

Passo 4: Enviar ações corretivas para o Kanban

O DING OS compara o progresso real com o tempo decorrido do período para sinalizar metas Atrasadas ou Em risco. Abra a gaveta Check-in e clique em + Adicionar tarefa ao Board para lançar de imediato um cartão de execução.


Arquitetura do sistema

O DING OS é um sistema operativo multitenant de comércio, reservas e atendimento no balcão. Funciona de forma autónoma ou em paralelo com o seu software contabilístico e hoteleiro existente, unificando mensagens recebidas, pedidos QR locais e contas abertas numa fila única em tempo real.

SubsistemaEndpointEspecificação operacional
Analisador MIME de entradaPOST /v1/email/ingest/Termina o tráfego SMTP enviado para [slug]@getding.io no worker Cloudflare, extrai entidades estruturadas (cliente, itens, horário, referência, total) e aplica idempotência SHA-256 durante 30 dias.
Proxy edge de domíniosproxy.getding.ioMapeia subdomínios personalizados (ding.yourbrand.com) e identificadores ([slug].getding.io) para contentores isolados com certificados DV TLS 1.3 automáticos.
Barramento de balcãowss://api.getding.io/v1/wsTransmite transições de estado (pending, confirmed, ready, completed) a todos os terminais emparelhados com aviso visual fixo e alerta sonoro de 880Hz.
Motor multimodal de contasPOST /v1/counter/Executa pagamento imediato, reservas por horário e reconciliação auditada de contas abertas (reconcile_order) com atribuição obrigatória (booking.owner).

Coexistência com software administrativo

O DING OS pode operar sozinho ou ao lado do seu software contabilístico atual sem alterar o plano de contas nem o registo fiscal.

Operação de atendimento (DING OS)

Extração automática de encomendas por e-mail, loja QR em 14 idiomas, recolha conversacional de orçamentos (capture_inquiry), conferência de contas abertas e despacho em direto.

Contabilidade e registo fiscal (ERP, POS, PMS)

Faturação eletrónica com IVA, lançamentos no razão geral, fecho fiscal diário, codificação de chaves de quarto e abate de stock por CSV ou webhook.


Ingestão de e-mail

Reencaminhe notificações de encomendas, confirmações OTA e pedidos de orçamento B2B do seu servidor de correio para o endereço do espaço sem configurar API. Os pacotes MIME entram diretamente na fila de atendimento sem leitura IMAP nem armazenamento de palavras-passe.

Endereço de ingestão do espaço
Segurança de dupla entrega

Configure a regra de reencaminhamento com a opção «Manter uma cópia na caixa de entrada» ativa. As caixas da empresa ([email protected], [email protected], [email protected]) guardam sempre o original como arquivo principal enquanto o DING OS processa uma cópia em paralelo.

  1. Abra Definições do Gmail ➔ Ver todas as definições ➔ Reencaminhamento e POP/IMAP.
  2. Selecione Adicionar um endereço de reencaminhamento e introduza [slug]@getding.io.
  3. A Google envia uma mensagem de confirmação ao seu espaço. Abra a Caixa de entrada no DING OS para obter a ligação e aprovar.
  4. Abra Filtros e endereços bloqueados ➔ Criar um novo filtro e defina Contém as palavras como subject:(Order OR Quote OR Booking OR Reservation OR Confirmation).
  5. Ative Reencaminhar para [slug]@getding.io, deixe Ignorar a Caixa de entrada desmarcado para manter o original e guarde o filtro.
Prevenção de ciclos em 3 níveis
1. Supressão por cabeçalho

As notificações enviadas por api.getding.io incluem X-Ding-Generated: true e Auto-Submitted: auto-generated. O worker SMTP descarta qualquer mensagem com estes cabeçalhos.

2. Resumo criptográfico de referência

Os pedidos recebidos são indexados por sha256(organization_id + ":" + reference) durante 30 dias. Envios repetidos atualizam o estado sem duplicar registos.

3. Filtro de remetentes de sistema

Mensagens com Return-Path ou From correspondentes a *@getding.io ou @trip.express são rejeitadas antes da análise por IA.


Integrações de canais

Guias passo a passo para Zalo Official Account (ZBS e ZNS), Telegram Bot, WhatsApp Cloud API, Messenger, Open Banking (VietQR, SePay), Stripe, PayPal e canais OTA.

Etapa 1: Ativação da aplicação Zalo

developers.zalo.me
  1. Abra developers.zalo.me, selecione a sua aplicação e mude o seletor superior direito para Active para evitar o erro -209.
  2. Em Domain verification, introduza workspace.getding.io, copie a meta tag zalo-platform-site-verification, cole-a em Espaço ➔ Rastreamento e valide a verificação.
  3. Em Products ➔ Official Account API ➔ General settings, solicite permissões de gestão de perfil OA e mensagens de utilizadores.
  4. Em Webhooks, defina o URL de callback como e ative os eventos user_send_text, user_send_image e oa_send_text.

Etapa 2: Renovação automática de tokens OAuth

API Explorer
  1. Abra developers.zalo.me/tools/explorer, selecione a aplicação, escolha OA Access Token e autorize a sua conta oficial.
  2. Copie o OA Access Token gerado (válido 25 horas), o Refresh Token (válido 3 meses), além do App ID e App Secret nas definições.
  3. Cole os quatro valores em Integrações ➔ Zalo OA ➔ Ligação. O DING OS renova o token automaticamente em segundo plano a cada 25 horas.

Etapa 3: Ligação à conta empresarial ZCA

business.zalo.me
  1. Se a lista de aplicações na criação de modelos ZBS estiver vazia, abra business.zalo.me ➔ Conta ZCA ➔ Settings ➔ Applications ➔ Link application e indique o seu Zalo App ID.
  2. Nota sobre API de chat bidirecional OA (Erro -224): O Zalo exige avaliação ativa de 1 mês ou pacote OA pago (zalo.cloud/oa/pricing) para responder via openapi.zalo.me/v3.0/oa/message/cs. No plano gratuito, o DING OS copia o rascunho IA e abre oa.zalo.me/chatv2 num clique.

Etapa 4: Parâmetros de modelos ZNS

account.zalo.cloud

O Zalo ZNS requer dois logótipos PNG horizontais transparentes (modos claro e escuro) com 400 x 96 px (proporção 50:12, centrados). Crie quatro modelos na biblioteca Zalo (Order, Transfer, Rating, Voucher) e associe os parâmetros conforme a tabela abaixo:

ModeloChave do parâmetroTipo técnico ZaloValor de exemplo
Order, Ratingorder_codeMã số (30)
Order (Ligação 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 padrão para aprovação (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.

Registos DNS de domínio próprio

Publique estes dois registos DNS no seu fornecedor (Cloudflare, Route 53, GoDaddy) para encaminhar ding.yourbrand.com através do proxy edge.

TipoHostValor obrigatórioTTLEstado
CNAMEAutoPendente
TXT
AutoPendente
Se a sua zona utilizar Cloudflare DNS, mantenha o proxy CNAME em Apenas DNS (nuvem cinzenta) durante a verificação inicial.Definições de domínio

Atendimento no balcão

Os terminais de balcão mantêm uma ligação WebSocket contínua (wss://api.getding.io/v1/ws) associada ao seu espaço. Ao chegar um novo pedido, reserva ou pedido de orçamento, o terminal emite um sinal Web Audio de 880Hz em conjunto com um banner visual persistente.

Alerta sonoro

Autorize o som do site nos tablets de balcão para que os separadores em segundo plano reproduzam o tom 880Hz A5 e 1318.5Hz E6 sem toque prévio, e teste a coluna abaixo.

ChromiumDefinições do site ➔ Som ➔ Permitir
SafariDefinições ➔ Sites ➔ Reprodução automática ➔ Permitir tudo
Banner visual

Cada pedido recebido apresenta um aviso visual persistente com referência da unidade, nome do cliente, categoria e ação necessária, funcionando mesmo quando o som está desligado.

Ligação WebSocketwss://api.getding.io/v1/ws
Modo sem somCartão visual persistente

Vinculação de unidades

Os pontos de atendimento físicos e virtuais usam a entidade Unit nas 13 categorias: spaces, realty, events, appointments, travel, mobility, retail, sports, spa, amenities, dining, drinks e takeaway. Os códigos QR são ilimitados em todos os planos.

Bloqueio do parâmetro de localização

Cada suporte QR codifica o identificador da unidade (UNIT #04 ou REF #12). Após a leitura, o identificador fica bloqueado em modo só de leitura para evitar trocas acidentais de mesa, campo ou quarto.

Reconciliação de conta aberta

As unidades em conta aberta permitem adições contínuas ao longo da sessão. Antes de fechar a conta, a equipa executa reconcile_order para confirmar quantidades consumidas e creditar devoluções.


Atribuição da equipa

Cada pedido, reserva presencial e conta reconciliada grava um identificador imutável em booking.owner. Os pedidos automáticos assumem System AI Ingest até serem assumidos no balcão.

Quadro de desempenho

O DING OS não aplica qualquer taxa fixa predefinida de comissão. Cada pedido, reserva e tarefa regista os papéis (SALES, OPERATIONS, FINANCE, MANAGER, OBSERVER) no quadro de desempenho para que a contabilidade apure prémios no final do mês segundo a política interna, mantendo os valores individuais privados nos ecrãs partilhados.


Isolamento de dados

As fronteiras entre empresas são aplicadas diretamente na camada de consulta da base de dados em api.getding.io. Cada pedido é filtrado pelo organization_id autenticado.

Autenticação OneUID

As sessões dos operadores autenticam-se via OneUID (uid.one) através de OIDC e tokens vinculados DPoP. O OneUID valida apenas a identidade (sub) sem guardar dados CRM ou históricos de vendas.

Titularidade própria dos dados

Cada comerciante atua como responsável autónomo pelo tratamento dos perfis de clientes, contactos e saldos cashback ao abrigo do RGPD, sem qualquer partilha cruzada entre espaços.


Perguntas frequentes

Referência técnica e operacional para proprietários, gestores de operações e equipas de TI.

Tanto os KR como os KPI usam métricas numéricas, o que gera confusão frequente. A diferença reside na finalidade: um KPI mede a saúde operacional contínua que deve manter todos os meses (como ocupação acima de 75%, faturação mensal de $50,000 ou cancelamentos abaixo de 2%). Um Key Result (KR) pertence sempre a um Objective estratégico (OKR) e mede um salto temporal da base X até à meta Y (como elevar os banquetes empresariais de $15,000 para $40,000 no 4.º trimestre). Quando um KPI cai e exige recuperação estratégica, entra como KR num Objective.
Última atualização: novembro de 2026Contactar suporte →