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.
1. Matriz hierárquica de metas
Padrão empresarial| Camada | Limite recomendado | Pergunta central | Natureza da medição | Exemplo 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. |
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.
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.
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
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.
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.
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.
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.
| Subsistema | Endpoint | Especificação operacional |
|---|---|---|
| Analisador MIME de entrada | POST /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ínios | proxy.getding.io | Mapeia 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ão | wss://api.getding.io/v1/ws | Transmite 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 contas | POST /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.
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.
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.
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.
- Abra Definições do Gmail ➔ Ver todas as definições ➔
Reencaminhamento e POP/IMAP. - Selecione Adicionar um endereço de reencaminhamento e introduza
[slug]@getding.io. - 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.
- 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). - Ative Reencaminhar para
[slug]@getding.io, deixe Ignorar a Caixa de entrada desmarcado para manter o original e guarde o filtro.
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.
Os pedidos recebidos são indexados por sha256(organization_id + ":" + reference) durante 30 dias. Envios repetidos atualizam o estado sem duplicar registos.
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- Abra developers.zalo.me, selecione a sua aplicação e mude o seletor superior direito para Active para evitar o erro
-209. - Em Domain verification, introduza
workspace.getding.io, copie a meta tagzalo-platform-site-verification, cole-a em Espaço ➔ Rastreamento e valide a verificação. - Em Products ➔ Official Account API ➔ General settings, solicite permissões de gestão de perfil OA e mensagens de utilizadores.
- Em Webhooks, defina o URL de callback como e ative os eventos
user_send_text,user_send_imageeoa_send_text.
Etapa 2: Renovação automática de tokens OAuth
API Explorer- Abra
developers.zalo.me/tools/explorer, selecione a aplicação, escolha OA Access Token e autorize a sua conta oficial. - 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.
- 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- 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.
- 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 viaopenapi.zalo.me/v3.0/oa/message/cs. No plano gratuito, o DING OS copia o rascunho IA e abreoa.zalo.me/chatv2num clique.
Etapa 4: Parâmetros de modelos ZNS
account.zalo.cloudO 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:
| Modelo | Chave do parâmetro | Tipo técnico Zalo | Valor de exemplo |
|---|---|---|---|
| Order, Rating | order_code | Mã số (30) | |
| Order (Ligação 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.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.
| Tipo | Host | Valor obrigatório | TTL | Estado |
|---|---|---|---|---|
| CNAME | Auto | Pendente | ||
| TXT | Auto | Pendente |
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.
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.
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.
wss://api.getding.io/v1/wsVinculaçã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.
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.
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.
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.
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.
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.