Home Assistant Logo – Open-Source-Smart-Home-Plattform+

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_offno check-out, na area selecionada
service: automation.turn_offno check-out, por cada automação marcada
service: automation.turn_on6 h antes do check-in (trigger PMS)
service: automation.triggerno check-out, por ação escolhida (ex. baixar o aquecimento)
service: automation.trigger6 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

1

Home Assistant: Profile → Security → „Long-Lived Access Tokens" → criar novo token.

2

Cola o URL remoto Nabu Casa (https://<id>.ui.nabu.casa) + o token em CheckYout → Definições → Integrações → Home Assistant.

3

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

07:30 Uhr

O hóspede digitaliza o QR ao sair

07:30 Uhr

Equipa de limpeza recebe imediatamente uma notificação WhatsApp

07:30 Uhr

O Home Assistant desliga luzes, pausa automações

No dia de chegada: automações reativadas 6 h antes do check-in (requer PMS)

08:00 Uhr

Equipa de limpeza chega (cerca de 30 min de viagem)

ca. 10:30 Uhr

Limpeza concluída, anfitrião informado

ca. 11:00 Uhr

Equipa arranca com o próximo trabalho

3 h mais cedo

Mais alojamentos por dia, sobretudo na alta época

ab 14:00 Uhr

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.