PeekTracciamento pacchi universaleTraccia il tuo pacco
Guide

Tracciare i pacchi in Home Assistant

6 min di lettura

Per tracciare i tuoi pacchi in Home Assistant, installa Peek per Home Assistant: l'integrazione porta il tuo elenco di pacchi di Peek in Home Assistant sotto forma di sensori, di un calendario delle consegne, di una scheda per la dashboard e di uno strumento per Assist. Ti servono un account Peek gratuito e Home Assistant 2026.11 o successivo, dove cerchi Peek nel Marketplace; con la versione 2026.10, lo cerchi in HACS.

Cosa mostra Peek in Home Assistant?

I tuoi pacchi di Peek, nelle forme che usa Home Assistant:

CosaCosa fa
SensoriContano i pacchi in viaggio, quelli che arrivano oggi, quelli che hanno bisogno di te (in attesa in un punto di ritiro, una consegna mancata, la dogana) e le consegne di oggi, e indicano il prossimo giorno di consegna
Un calendario «Deliveries»Eventi di un'intera giornata: ogni pacco in viaggio nel suo giorno previsto, ogni consegna nel giorno in cui è arrivata
Un evento «Parcel updates»Si attiva quando un pacco viene aggiunto, cambia stato, parte per la consegna, ha bisogno di te, viene consegnato o cambia il suo giorno previsto
Tre azioniAggiungere pacchi da un testo, archiviare un pacco o leggere l'elenco
La scheda «Peek parcels»I tuoi pacchi su una dashboard, come elenco o come schede con Pip
Uno strumento per AssistRisponde a domande come «Cosa arriva oggi?»

Home Assistant interroga Peek ogni 30 minuti, ogni 10 minuti in un giorno in cui un pacco è in consegna o previsto, e subito dopo aver aggiunto o archiviato un pacco. Per interrogarlo subito, chiama homeassistant.update_entity su una qualsiasi entità di Peek. «Oggi» è il giorno nel fuso orario di Home Assistant.

Cosa mi serve?

  • Home Assistant 2026.11 o successivo, come dice la pagina di Peek, e un accesso da amministratore: il Marketplace di Home Assistant è solo per gli amministratori. Con la versione 2026.10, installala da HACS.
  • Un account Peek. La configurazione apre Peek per farti accedere, con un codice di sei cifre che Peek ti manda per e-mail, oppure con Google o Apple dove la schermata lo propone. Il tuo primo accesso crea l'account; un ospite non può collegare Home Assistant.
  • Nient'altro. Peek è gratuito, e non c'è nessun client id, secret o Application Credentials da digitare. A ogni Home Assistant si può collegare un solo account Peek.

L'integrazione si collega come fanno gli assistenti, e i collegamenti di Peek per gli assistenti sono in beta. Se Peek dice «Peek non può ancora collegare assistenti a questo account.», l'integrazione non si può ancora configurare.

Come installo l'integrazione Peek?

Cerca Peek nel Marketplace di Home Assistant. Con la versione 2026.10, cercalo in HACS o installa l'integrazione a mano.

Dal Marketplace (Home Assistant 2026.11 e successivi)

  1. Apri «Settings › Marketplace»Cerca «Peek» e aprilo.
  2. Installa PeekSeleziona «Install», poi «Set up».
  3. Accedi a PeekIl browser apre Peek. Controlla cosa chiede Home Assistant (vedere i tuoi pacchi, aggiungerli e archiviarli), poi seleziona «Consenti».
  4. Torna a Home AssistantPeek ti riporta indietro tramite My Home Assistant (my.home-assistant.io). La prima volta, ti chiede l'indirizzo del tuo Home Assistant.

Con HACS (Home Assistant 2026.10)

  1. Cerca PeekIn HACS, cerca «Peek» e aprilo.
  2. Scarica PeekPoi riavvia Home Assistant.
  3. Aggiungi l'integrazioneVai in «Settings › Devices & services › Add integration», scegli Peek, accedi a Peek e seleziona «Consenti».

Se Peek non compare, aggiungi https://github.com/plhery/peek-ha tramite il suo link: con «Add from link» nel Marketplace, che la prima volta ti chiede di collegare GitHub, oppure come repository personalizzato di tipo «Integration» in HACS.

Puoi anche installarla a mano: copia la cartella custom_components/peek nella cartella custom_components della tua configurazione, riavvia e aggiungi l'integrazione come sopra.

Come aggiungo la scheda Peek parcels alla mia dashboard?

L'integrazione carica da sola la sua scheda su ogni dashboard: non c'è nessuna risorsa da aggiungere. Una pagina già aperta mentre configuri Peek non ha ancora la scheda: ricaricala prima, oppure chiudi l'app Home Assistant e riaprila.

  1. Modifica una dashboardAprila e seleziona la matita. Su una dashboard che Home Assistant ha creato per te, prima ti chiede di prenderne il controllo.
  2. Seleziona «Add card»Poi la tab «By card». La tab «By entity» cerca entità, non schede.
  3. Scegli «Peek parcels»Cerca «Peek», scegli «Peek parcels» e salva.

La scheda esiste in due stili: un elenco, quello predefinito, con una riga per ogni pacco che mostra il furgone del suo corriere, la sua fase e il suo giorno; oppure una scheda per ogni pacco nei colori del suo corriere, come i widget di Peek per iPhone e Android, con Pip, la città dell'ultima scansione, il nome del pacco, la sua fase e il suo giorno. Entrambi seguono le sezioni di Peek, a partire dai pacchi che hanno bisogno di te, e finiscono con «+N more» quando ci sono più pacchi che righe.

La scheda segue il tuo tema, chiaro o scuro, e la tua lingua, se è l'inglese o il francese. In YAML è type: custom:peek-parcels-card; il README dell'integrazione elenca le sue opzioni.

Posso usarla nelle automazioni o chiedere ad Assist?

Sì. Il README ha quattro automazioni pronte:

  • una notifica sul telefono quando un pacco parte per la consegna;
  • aggiungere i codici tracking dalle tue e-mail di spedizione, lette con l'integrazione IMAP di Home Assistant;
  • un messaggio al mattino con ciò che arriva oggi;
  • archiviare ciò che è stato consegnato, ogni sera.

Quando aggiungi pacchi da un testo, Peek aggiunge ogni codice tracking che trova, al massimo 10 alla volta, e conserva solo i codici e il nome che indichi, quindi invia solo la parte di un'e-mail che riguarda la spedizione, quando puoi.

Una volta che una delle entità di Peek è esposta ad Assist («Settings › Voice assistants › Expose»), puoi chiedere «Cosa arriva oggi?» o dov'è il pacco di un certo negozio. Lo strumento Peek di Assist legge soltanto: non aggiunge né archivia mai pacchi. Ciò che restituisce (nomi, negozi, corrieri, fasi, giorni previsti e luogo dell'ultima scansione) va all'agente di conversazione che hai scelto, che può essere un servizio cloud.

Cosa non può fare l'integrazione?

  • Eliminare o modificare pacchi. Home Assistant chiede solo di vedere i tuoi pacchi, e di aggiungerli e archiviarli. Puoi ripristinare un pacco archiviato in Peek.
  • Collegare Claude, ChatGPT o Gemini. Si collegano a Peek da soli: vedi la guida Tracciare i pacchi con ChatGPT, Claude o Gemini.

Cosa conserva Home Assistant, e come rimuovo l'integrazione?

Home Assistant parla solo con Peek, su peektracker.com, e conserva i token dell'accesso nella sua configurazione, come qualsiasi integrazione. La sua cronologia registra i conteggi dei sensori e gli eventi «Parcel updates», con nome, corriere, fase e ultimo luogo del pacco, ma non gli elenchi di pacchi dei sensori. La scheda gira nel tuo browser con i dati di Home Assistant stesso e non carica nulla da altrove.

Per rimuoverla, elimina Peek in «Settings › Devices & services»: Home Assistant restituisce il suo accesso a Peek, che dimentica il collegamento, e i tuoi pacchi restano in Peek. Se in quel momento Peek non è raggiungibile, o per staccare Home Assistant dal lato di Peek, seleziona «Scollega» accanto a Home Assistant sul sito di Peek (non nelle sue app), in «Impostazioni» → «Consegne» → «Assistenti». Se poi tieni l'integrazione, mostrerà «Authentication expired for Peek»; riconfigurarla avvia lo stesso accesso.

Fonti