CheckYout + Home Assistant: o check-out aciona as tuas areas e automações.
No check-out, o CheckYout aciona as ações que escolheres – luzes apagadas, automações em pausa e automações disparadas ativamente, como uma automação de «baixar o aquecimento» para os teus termostatos FRITZ!DECT ou Zigbee. Antes da próxima chegada volta a aquecer e reativa tudo sozinho (ligação PMS incluída). O Home Assistant é uma função Pro, configuração cerca de 5 minutos.
Para anfitriões que já usam Home Assistant + Nabu Casa. Precisas de HA OS/Container/Supervised ≥ 2024.x, Nabu Casa (~6,50 €/mês) e um Long-Lived Access Token. Self-hosted tunnels não são suportados.
Pro · CHF 9.90/mês – seleção de area e reativação automática antes da chegada incluídas.
Luzes por área ou todas de uma vez
No painel escolhes a área HA que se desliga no check-out. Por exemplo só o rés-do-chão, ou toda a casa. O CheckYout lê para isso o registo de áreas do teu Home Assistant.
Pausar e retomar automações
Marcas quais automações HA pausam no check-out, por exemplo a rega ou os sensores de movimento. O CheckYout volta a ligá-las antes da próxima chegada. Precisas para isso de um PMS ligado.
Baixar o aquecimento no check-out
Escolhe uma automação HA que o CheckYout dispara ativamente no check-out – por exemplo os teus termostatos FRITZ!DECT em modo eco. Antes da próxima chegada, uma segunda automação volta a aquecer. Para FRITZ!DECT há um blueprint pronto a importar.
Uma ligação para todo o teu setup
Em vez de configurares uma integração por cada marca smart home, ao CheckYout basta a ligação ao Home Assistant. O HA trata da tradução para Hue, Shelly, Tuya, Zigbee ou Matter.
O que o CheckYout chama no HA
service: light.turn_off→ no check-out, na area selecionadaservice: automation.turn_off→ no check-out, por cada automação marcadaservice: automation.turn_on→ 6 h antes do check-in (trigger PMS)service: automation.trigger→ no check-out, por ação escolhida (ex. baixar o aquecimento)service: automation.trigger→ 6 h antes do check-in, por ação de chegada (ex. aquecimento conforto)O que não é
Esta integração foca-se na troca de hóspede: luzes apagadas, automações em pausa ou disparadas ativamente (como baixar o aquecimento), de novo em cima antes da chegada. Um webhook livremente programável sobre eventos CheckYout arbitrários corre separadamente via Partner API.
Gestão do token
- • AES-256-GCM cifrado em Supabase UE/Frankfurt.
- • Revoga no HA → o CheckYout perde acesso de imediato.
- • Read-only não é possível (limitação do HA); restringimos via service whitelist.
Como funciona
Home Assistant: Profile → Security → „Long-Lived Access Tokens" → criar novo token.
Cola o URL remoto Nabu Casa (https://<id>.ui.nabu.casa) + o token em CheckYout → Definições → Integrações → Home Assistant.
Escolhe area + automações no dropdown.
O que precisas
Instância Home Assistant
Home Assistant OS, Container ou Supervised, versão 2024.x ou mais recente.
Nabu Casa Cloud (cerca de 6,50 €/mês)
Ativa o acesso remoto. Instâncias auto-hospedadas ou expostas manualmente não são suportadas.
Long-Lived Access Token
Crias no perfil HA em Security com um clique. O token mantém-se válido até o revogares.
PMS ligado (opcional)
Só é necessário se quiseres que as automações retomem automaticamente antes da chegada.
O que o CheckYout controla no HA
Controlado
- →
light.*– todas as luzes - →
automation.*– todas as automações
Não diretamente – só via automações
switch.*, cover.*, climate.*, media_player.*
Uma automação disparada pelo CheckYout alcança-as à mesma – é exatamente assim que funciona a redução do aquecimento.
Independente do protocolo
Zigbee (ZHA / Z2M), Z-Wave, Matter, Wi-Fi, Cloud – p. ex. Hue, IKEA Tradfri/Dirigera, Tuya/Smart Life, Shelly, Aqara, Sonoff.
O CheckYout comunica apenas com a tua instância HA. O Home Assistant trata da tradução para o protocolo de cada fabricante.
O que acontece no check-out – e antes da chegada
O hóspede digitaliza o QR ao sair
Equipa de limpeza recebe imediatamente uma notificação WhatsApp
O Home Assistant desliga luzes, pausa automações
→ No dia de chegada: automações reativadas 6 h antes do check-in (requer PMS)
Equipa de limpeza chega (cerca de 30 min de viagem)
Limpeza concluída, anfitrião informado
Equipa arranca com o próximo trabalho
3 h mais cedo→ Mais alojamentos por dia, sobretudo na alta época
Próximo hóspede pode entrar
2 h mais cedo→ Em vez do check-in padrão às 16:00
Ao longo da época corre tudo sozinho: o check-out aciona as tuas areas e automações no Home Assistant – luzes, aquecimento, estores, o que tiveres configurado. Um scan e todo o alojamento passa a modo de troca.
A reativação requer um PMS ligado.
Mais integrações
Se só usas Hue, a integração nativa é suficiente. Dispensa a subscrição Nabu Casa e fala diretamente com o Bridge.
Descobrir Philips Hue →Com apenas alguns Shellys instalados, a integração direta é suficiente. Assim podes dispensar o Home Assistant por completo.
Descobrir Shelly →Como ligo o Home Assistant ao CheckYout?
Precisas de uma instância HA (OS, Container ou Supervised, versão 2024.x ou mais recente), Nabu Casa Cloud (~6,50 €/mês) para acesso remoto e um Long-Lived Access Token do teu perfil HA. Introduzes o token e o URL do Nabu Casa no CheckYout e depois escolhes a area do alojamento.
Que service-calls é que o CheckYout executa no Home Assistant?
No check-out: light.turn_off na area selecionada, automation.turn_off por cada automação em pausa e automation.trigger por cada ação escolhida (ex. baixar o aquecimento). Seis horas antes do check-in: automation.turn_on ou automation.trigger para as ações de chegada. O CheckYout nunca chama climate.*, switch.* ou cover.* diretamente – esses são definidos pela tua própria automação HA, que nós disparamos.
Preciso do Nabu Casa para a integração?
Sim. O CheckYout liga-se exclusivamente via Nabu Casa Cloud – sem túnel auto-hospedado, sem abertura de portas. A subscrição (~6,50 €/mês) é paga diretamente à Nabu Casa e apoia a fundação Home Assistant.
Que versões do Home Assistant são suportadas?
Home Assistant OS, Container e Supervised, a partir da versão 2024.x. Versões mais antigas podem não ter alguns service-calls ou campos de API. Depois de uma atualização não precisas de fazer nada – o Long-Lived Token mantém-se válido.
Como é guardado o Long-Lived Access Token?
AES-256-GCM cifrado na base CheckYout em Frankfurt (Supabase UE). Podes revogar o token a qualquer altura no teu perfil HA – o CheckYout perde acesso de imediato. Read-only não é possível do lado do HA (limitação do HA); restringimos via service whitelist.
Perguntas frequentes
Vários alojamentos? Cada um ligado individualmente.
Vários alojamentos numa única instância Home Assistant? Cada alojamento recebe a sua própria area. No check-out, as service-calls (light.turn_off, automation.turn_off) afetam apenas entidades da area correspondente – o alojamento vizinho fica intacto.
- Uma única conta CheckYout cobre todo o teu portfólio
- Por alojamento, a sua própria area, as suas luzes, as suas automações
- As configurações não interferem entre si
Cinco minutos de setup, cada check-out automático.
Smart Home add-on, Long-Lived Token, escolhe area , pronto.
Leituras adicionais
- Home AssistantOpen-Source-Smart-Home-Plattform mit über 2 Mio. aktiven Installationen weltweit.home-assistant.io
- Nabu CasaOffizieller Cloud-Service für Home Assistant – Fernzugriff + Alexa/Google.nabucasa.com
- Alle CheckYout-RessourcenKuratierte Links zu Plattformen, Smart-Home-Tools und mehr.checkyout.app
Conheces outros anfitriões com Home Assistant?
Partilha a página – para que usem o seu setup Home Assistant também nos check-outs de hóspedes.