Se já utilizas o Home Assistant no teu alojamento, podes ligá-lo ao Roraima e usar os dispositivos que já tens instalados para gerir as tuas estadias. Esta ligação chama-se Roraima for Home Assistant e instala-se a partir do Marketplace do Home Assistant, bastando pesquisar por «Roraima».
O Home Assistant é um programa gratuito muito popular para gerir dispositivos domésticos e, quem o utiliza, já tem as tomadas, luzes, aparelhos de ar condicionado e sensores organizados. O Roraima acrescenta a componente dedicada a quem te visita, ou seja, as reservas, os pagamentos e a página pessoal onde o hóspede utiliza o que lhe disponibilizas. Uma vez ligados, um dispositivo que o Home Assistant já controla pode ligar-se automaticamente à chegada de um hóspede, aparecer como um botão no seu telemóvel ou ser disponibilizado para venda por tempo limitado.
No Home Assistant, abre o Marketplace, que nas versões anteriores à 2026.11 se chama HACS, pesquisa por «Roraima» e instala o Roraima for Home Assistant. Após o reinício, vai a Definições, depois a Dispositivos e serviços, e adiciona a integração Roraima, que te pedirá um código de emparelhamento.
Podes criar esse código no painel do Roraima, a área reservada onde geres os teus anúncios e reservas. Abre a secção Fechaduras e dispositivos, segue para a página Tecnologias e depois para o separador Home Assistant, carregando em «Criar código de emparelhamento». O painel mostra-o apenas uma vez, pelo que convém copiá-lo e colá-lo de imediato na janela do Home Assistant. Se preferires começar pelo painel, no mesmo separador encontras o botão «Adicionar ao Home Assistant», que abre a página da integração diretamente no teu Marketplace.
Logo após inserires o código, o Home Assistant mostra-te a lista dos teus dispositivos e pergunta-te quais queres partilhar. Inicialmente, não está nenhum selecionado, pois a escolha é tua: o Roraima recebe o estado e pode utilizar as funções apenas dos dispositivos que tu indicares, sendo que podes alterar esta seleção em qualquer momento nas opções da integração. Os dispositivos que escolheres aparecem automaticamente no painel do Roraima, com o mesmo nome que têm no Home Assistant.
A ligação parte da tua casa. É o Home Assistant que contacta o Roraima, por isso basta-te a ligação à internet normal do alojamento, sem necessidade de endereços públicos ou de abrir portas no router, e a palavra-passe do Home Assistant continua a ser apenas tua. As informações sobre a tua localização ou a estrutura da tua rede, como a posição e os endereços dos dispositivos, permanecem dentro de casa.
Um dispositivo partilhado funciona como qualquer outro dos teus dispositivos compatíveis. Podes utilizá-lo num cenário, ou seja, uma ação que o Roraima executa quando é necessário, como por exemplo ligar o aquecimento à chegada do hóspede e desligá-lo no momento da partida. Podes transformá-lo num botão na página do hóspede, para que durante a estadia ele possa regular o ar condicionado a partir do seu próprio telemóvel, tal como explicamos no artigo sobre dispositivos com comando à distância.
Também podes vender a sua utilização. Junto a uma tomada ou interruptor partilhado, o painel mostra a opção «Vender a utilização deste dispositivo», e a partir daí nasce um produto por tempo ou por fichas, como a máquina de lavar roupa que o hóspede paga através do telemóvel.
A ligação traz vantagens também na direção oposta. Para cada produto por tempo ou por fichas que utilize um dispositivo partilhado, aparece no Home Assistant uma entrada com três informações: o estado, Livre ou Em utilização, a hora em que ficará livre e a data da última venda. Com base nisto, podes criar as tuas automatizações, uma vez que o Roraima avisa o Home Assistant a cada compra paga, bem como no início e no fim de cada utilização. Quando alguém inicia a máquina de lavar, por exemplo, o Home Assistant pode acender a luz da lavandaria e apagá-la quando o ciclo terminar. Os avisos contêm o produto e os horários, enquanto os dados de quem comprou permanecem no Roraima.
Para começar, precisas do Home Assistant na versão 2026.1 ou superior e de uma conta de vendedor no Roraima, que opera nos 27 países da União Europeia. A ligação é gratuita, enquanto cada dispositivo que partilhas tem a sua mensalidade, tal como qualquer outro dispositivo da tua conta. Se ainda não tens uma montra no Roraima, podes abri-la gratuitamente.
Roraima for Home Assistant é uma integração não oficial. Home Assistant é uma marca da Open Home Foundation.