Bentornati nella serie di Domotica con Hass.io, il software di casa Google per la gestione della vostra smart home. 

Nello scorso articolo abbiamo visto come configurare il protocollo HTTPS con il plugin "Let's Encrypt", quindi adesso siamo pronti per collegare Hassio a Google Assistant, in modo che possiate controllare con la voce tutti i dispositivi smart.

 

 

Non partiremo come al solito dal pannello di controllo su Hassio, ma ci colleghiamo alla pagina https://console.actions.google.com e creiamo un nuovo progetto.

Dal coloratissimo pannello di controllo, completamente integrato con Google Assistant, clicchiamo su Home Control e poi Smart Home. Nella nuova scheda, seguiamo Build Your Action > Add Action(s), poi nel campo apposito inseriamo l'URL della nostra domotica, formattato nel seguente modo:  https://nomedominio:porta/api/google_assistant. In questo modo potremo mandare richieste alle API di Google Assistant, che naturalmente sono integrate anche in Hassio. Dopo aver confermato, torniamo sulla nostra Overview e scegliamo Add account linking: adesso c'è da settare varie configurazioni, seguitele passo passo aiutandovi con le immagini.

Account Creation: come da default, lasciamo No.

Linking type: selezioniamo OAuth e Authorization code.

Client Information: qui sotto avete i vari sottocampi.

  •     Client ID issued by your Actions to Google: https://oauth-redirect.googleusercontent.com/
  •     Client secret: inserite un codice a piacere.
  •     Authorization URL: https://nomedominio:porta/auth/authorize
  •     Token URL: https://nomedominio:porta/auth/token

Configure your client: questi sono i permessi a cui l'utente deve aver acconsentito per poter utilizzare il servizio. Inseriamo email e name.

Testing instructions: si tratta di istruzioni che teoricamente dovranno servire ai beta tester delle vostre Actions; dato che per proseguire bisogna scriverci qualcosa, potete lasciare anche un semplice carattere.

Adesso possiamo finalmente fare SAVE.

Dalla sidebar a sinistra rechiamoci su Simulator, impostiamo la lingua ad Italiano e poi diamo START TESTING.

 

Ritorniamo su Hassio e aggiungiamo al file configuration.yaml le seguenti righe:

                     google_assistant:      
                           project_id: YOUR_PROJECT_ID
                           api_key: YOUR_API_KEY

 

 

  • Il campo YOUR_PROJECT_ID va sostituito con la stringa che troviamo sulla scheda Project Settings:

 

  • Il campo YOUR_API_KEY va recuperato invece al seguente indirizzo: https://console.cloud.google.com/apis/api/homegraph.googleapis.com/overview. Creiamo un nuovo progetto dalla Dashboard e clicchiamo "Abilita API e Servizi": vanno abilitate Google Assistant API e HomeGraph API (cercandole sull'apposita barra). A questo punto dalla sidebar a sinistra rechiamoci su Credenziali e generiamo la nostra API key:

Attenzione: una volta creata la chiave, bisogna aprirla e impostare le restrizioni a "Google Assistant API" dalla tab Restrizioni delle API:

A questo punto possiamo finalmente aggiornare il file configuration.yaml con la chiave appena generata e modificata. 

 

Adesso arriva la parte più interessante. Apriamo Google Assistant dallo smartphone, accediamo alle impostazioni e dalla tab Casa facciamo Aggiungi > Configura Dispositivo > Hai già configurato qualcosa?; a questo punto dovrebbe comparire anche il progetto che abbiamo creato nella console di Google:

Basta loggarsi con Hassio e magicamente compariranno tutti i dispositivi collegati al nostro ambiente domotico da selezionare e aggiungere ad una stanza.

PERFETTO, adesso il vostro assistente Google potrà interfacciarsi con tutti i dispositivi collegati al vostro Hassio!