PeekUniwersalne śledzenie przesyłekŚledź swoją paczkę
Poradniki

Śledź swoje przesyłki w Home Assistant

6 min czytania

Żeby śledzić przesyłki w Home Assistant, zainstaluj Peek for Home Assistant: integracja przenosi Twoją listę przesyłek z Peek do Home Assistant jako czujniki, kalendarz dostaw, kartę na pulpit i narzędzie dla Assist. Potrzebujesz darmowego konta Peek i Home Assistant 2026.11 lub nowszego, gdzie wyszukujesz Peek w Marketplace; w wersji 2026.10 wyszukujesz go w HACS.

Co Peek pokazuje w Home Assistant?

Twoje przesyłki z Peek, w formach, których używa Home Assistant:

CoDo czego służy
CzujnikiLiczą przesyłki w drodze, te, które docierają dzisiaj, te, które wymagają Twojej uwagi (czekają w punkcie odbioru, nieudane doręczenie, cło), i dzisiejsze doręczenia, a także podają najbliższy dzień dostawy
Kalendarz „Deliveries”Wydarzenia całodniowe: każda przesyłka w drodze w przewidywanym dniu, każde doręczenie w dniu, w którym nastąpiło
Zdarzenie „Parcel updates”Uruchamia się, gdy przesyłka zostanie dodana, zmieni status, wyjedzie do doręczenia, zacznie wymagać Twojej uwagi, zostanie doręczona albo zmieni się jej przewidywany dzień
Trzy akcjeDodawanie przesyłek z tekstu, archiwizowanie przesyłki albo odczyt listy
Karta „Peek parcels”Twoje przesyłki na pulpicie, jako lista albo karty z Pipem
Narzędzie dla AssistOdpowiada na pytania typu „co dziś dotrze?”

Home Assistant odczytuje dane z Peek co 30 minut, co 10 minut w dniu, w którym przesyłka jest w doręczeniu albo ma dotrzeć, i zaraz po dodaniu lub zarchiwizowaniu przesyłki. Żeby odczytać je od razu, wywołaj homeassistant.update_entity dla dowolnej encji Peek. „Dzisiaj” to dzień w strefie czasowej Home Assistant.

Czego potrzebuję?

  • Home Assistant 2026.11 lub nowszego, jak podaje strona Peek, i konta administratora: Marketplace w Home Assistant jest tylko dla administratorów. W wersji 2026.10 zainstaluj ją z HACS.
  • Konta Peek. Konfiguracja otwiera logowanie do Peek: sześciocyfrowym kodem, który Peek wysyła Ci e-mailem, albo przez Google lub Apple, jeśli ekran to proponuje. Pierwsze logowanie tworzy konto; gość nie może połączyć Home Assistant.
  • Niczego więcej. Peek jest darmowy i nie trzeba wpisywać żadnego identyfikatora klienta, sekretu ani „Application Credentials”. Z każdym Home Assistant można połączyć jedno konto Peek.

Integracja łączy się tak samo jak asystenci, a połączenia Peek dla asystentów są w wersji beta. Jeśli Peek wyświetli komunikat „Peek nie może jeszcze łączyć asystentów z tym kontem.”, integracji nie da się jeszcze skonfigurować.

Jak zainstalować integrację Peek?

Wyszukaj Peek w Marketplace w Home Assistant. W wersji 2026.10 wyszukaj go w HACS albo zainstaluj integrację ręcznie.

Z Marketplace (Home Assistant 2026.11 i nowsze)

  1. Otwórz „Settings › Marketplace”Wyszukaj „Peek” i otwórz go.
  2. Zainstaluj PeekWybierz „Install”, a potem „Set up”.
  3. Zaloguj się do PeekPrzeglądarka otworzy Peek. Sprawdź, o co prosi Home Assistant (widzieć Twoje przesyłki oraz dodawać je i archiwizować), i wybierz „Zezwól”.
  4. Wróć do Home AssistantPeek przekieruje Cię z powrotem przez My Home Assistant (my.home-assistant.io). Za pierwszym razem zapyta o adres Twojego Home Assistant.

Przez HACS (Home Assistant 2026.10)

  1. Wyszukaj PeekW HACS wyszukaj „Peek” i otwórz go.
  2. Pobierz PeekPotem uruchom ponownie Home Assistant.
  3. Dodaj integracjęPrzejdź do „Settings › Devices & services › Add integration”, wybierz Peek, zaloguj się do Peek i wybierz „Zezwól”.

Jeśli Peek nie ma na liście, dodaj https://github.com/plhery/peek-ha przez link: w Marketplace przez „Add from link” (za pierwszym razem Marketplace poprosi o połączenie z GitHubem) albo w HACS jako własne repozytorium typu „Integration”.

Możesz też zainstalować ją ręcznie: skopiuj folder custom_components/peek do folderu custom_components w swojej konfiguracji, uruchom ponownie Home Assistant i dodaj integrację jak wyżej.

Jak dodać kartę Peek parcels do pulpitu?

Integracja sama wczytuje swoją kartę na każdym pulpicie: nie trzeba dodawać żadnego zasobu. Strona otwarta już w trakcie konfiguracji Peek jeszcze tej karty nie ma: najpierw ją odśwież albo zamknij aplikację Home Assistant i otwórz ją ponownie.

  1. Edytuj pulpitOtwórz go i wybierz ołówek. Na pulpicie, który Home Assistant utworzył za Ciebie, najpierw poprosi Cię o przejęcie kontroli.
  2. Wybierz „Add card”Potem zakładkę „By card”. Zakładka „By entity” wyszukuje encje, a nie karty.
  3. Wybierz „Peek parcels”Wyszukaj „Peek”, wybierz „Peek parcels” i zapisz.

Karta ma dwa style: listę, domyślną, z wierszem dla każdej przesyłki, w którym widać furgonetkę jej przewoźnika, etap i dzień; albo osobną kartę dla każdej przesyłki w kolorach przewoźnika, jak widżety Peek na iPhone’a i Androida, z Pipem, miejscowością ostatniego skanu, nazwą przesyłki, etapem i dniem. Oba style trzymają się sekcji Peek, zaczynając od przesyłek, które wymagają Twojej uwagi, i kończą się napisem „+N more”, gdy przesyłek jest więcej niż wierszy.

Karta dopasowuje się do Twojego motywu, jasnego lub ciemnego, i do Twojego języka, jeśli jest to angielski lub francuski. W YAML to type: custom:peek-parcels-card; README integracji wymienia jej opcje.

Czy mogę jej używać w automatyzacjach albo pytać Assist?

Tak. README zawiera cztery gotowe automatyzacje:

  • powiadomienie na telefonie, gdy przesyłka wyjedzie do doręczenia;
  • dodawanie numerów śledzenia z e-maili o wysyłce, odczytywanych przez integrację IMAP w Home Assistant;
  • poranną wiadomość z listą tego, co dziś dotrze;
  • archiwizowanie doręczonych przesyłek co wieczór.

Gdy dodajesz przesyłki z tekstu, Peek dodaje każdy znaleziony numer śledzenia, maksymalnie 10 naraz, i zapisuje tylko numery oraz podaną nazwę, więc w miarę możliwości wysyłaj tylko część e-maila o wysyłce.

Gdy jedna z encji Peek jest udostępniona dla Assist („Settings › Voice assistants › Expose”), możesz zapytać „co dziś dotrze?” albo gdzie jest Twoja przesyłka z jakiegoś sklepu. Narzędzie Peek w Assist tylko odczytuje dane: nigdy nie dodaje ani nie archiwizuje przesyłek. To, co zwraca (nazwy, sklepy, przewoźnicy, etapy, przewidywane dni i miejsce ostatniego skanu), trafia do wybranego przez Ciebie agenta konwersacji, którym może być usługa w chmurze.

Czego nie potrafi?

  • Usuwać ani edytować przesyłek. Home Assistant prosi tylko o to, by widzieć Twoje przesyłki oraz dodawać je i archiwizować. Zarchiwizowaną przesyłkę możesz przywrócić w Peek.
  • Połączyć Claude, ChatGPT ani Gemini. Łączą się z Peek same: zobacz poradnik Śledź swoje przesyłki w ChatGPT, Claude lub Gemini.

Co przechowuje Home Assistant i jak usunąć integrację?

Home Assistant łączy się tylko z Peek, pod adresem peektracker.com, i jak każda integracja przechowuje tokeny logowania w swojej konfiguracji. Jego historia zapisuje liczby z czujników i zdarzenia „Parcel updates” z nazwą przesyłki, przewoźnikiem, etapem i ostatnim miejscem, ale nie listy przesyłek z czujników. Karta działa w Twojej przeglądarce na danych samego Home Assistant i niczego nie wczytuje z innych miejsc.

Aby ją usunąć, skasuj Peek w „Settings › Devices & services”: Home Assistant oddaje Peek swój dostęp, a Peek zapomina to połączenie, przy czym Twoje przesyłki zostają w Peek. Jeśli Peek jest wtedy nieosiągalny albo chcesz odciąć Home Assistant po stronie Peek, wybierz „Odłącz” obok Home Assistant na stronie Peek (nie w aplikacjach), w „Ustawienia” → „Dostawy” → „Asystenci”. Integracja, którą potem zostawisz, pokaże „Authentication expired for Peek”; ponowna konfiguracja uruchamia to samo logowanie.

Źródła