PeekSeguimiento universal de paquetesSeguir tu paquete
Guías

Sigue tus paquetes en Home Assistant

7 min de lectura

Para seguir tus paquetes en Home Assistant, instala Peek for Home Assistant: trae tu lista de paquetes de Peek como sensores, un calendario de entregas, una tarjeta para tus paneles y una herramienta para Assist. Necesitas una cuenta gratuita de Peek y Home Assistant 2026.11 o posterior, donde buscas Peek en el Marketplace; en la versión 2026.10, lo buscas en HACS.

¿Qué muestra Peek en Home Assistant?

Tus paquetes de Peek, en las formas que usa Home Assistant:

QuéPara qué sirve
SensoresCuentan los paquetes en camino, los que llegan hoy, los que te necesitan (esperando en un punto de recogida, una entrega fallida, aduanas) y las entregas de hoy, y dan el próximo día de entrega
Un calendario «Deliveries»Eventos de día completo: cada paquete en camino en su día previsto, cada entrega el día en que llegó
Un evento «Parcel updates»Se dispara cuando se añade un paquete, cambia de estado, sale a reparto, te necesita, se entrega o cambia su día previsto
Tres accionesAñadir paquetes a partir de un texto, archivar un paquete o leer la lista
La tarjeta «Peek parcels»Tus paquetes en un panel, como lista o como tarjetas con Pip
Una herramienta para AssistResponde a preguntas como «¿qué llega hoy?»

Home Assistant consulta Peek cada 30 minutos, cada 10 minutos los días en que un paquete está en reparto o previsto, y justo después de añadir o archivar un paquete. Para consultarlo en el momento, llama a homeassistant.update_entity sobre cualquier entidad de Peek. «Hoy» es el día en la zona horaria de Home Assistant.

¿Qué necesito?

  • Home Assistant 2026.11 o posterior, como dice la página de Peek, y una cuenta de administrador: el Marketplace de Home Assistant es solo para administradores. En la versión 2026.10, instálala desde HACS.
  • Una cuenta de Peek. Al configurar la integración, se abre Peek para que inicies sesión, con un código de seis cifras que Peek te envía por correo, o con Google o Apple si la pantalla lo ofrece. Tu primer inicio de sesión crea la cuenta; un invitado no puede conectar Home Assistant.
  • Nada más. Peek es gratis, y no hay que escribir ningún ID de cliente, secreto ni «Application Credentials». Cada Home Assistant puede conectarse a una sola cuenta de Peek.

La integración se conecta como lo hacen los asistentes, y las conexiones de Peek para asistentes están en beta. Si Peek dice «Peek aún no puede conectar asistentes a esta cuenta.», todavía no se puede configurar la integración.

¿Cómo instalo la integración de Peek?

Busca Peek en el Marketplace de Home Assistant. En la versión 2026.10, búscalo en HACS o instala la integración a mano.

Desde el Marketplace (Home Assistant 2026.11 y posteriores)

  1. Abre «Settings › Marketplace»Busca «Peek» y ábrelo.
  2. Instala PeekSelecciona «Install» y luego «Set up».
  3. Inicia sesión en PeekTu navegador abre Peek. Comprueba lo que pide Home Assistant (ver tus paquetes, y añadirlos y archivarlos) y selecciona «Permitir».
  4. Vuelve a Home AssistantPeek te devuelve a través de My Home Assistant (my.home-assistant.io). La primera vez, te pide la dirección de tu Home Assistant.

Con HACS (Home Assistant 2026.10)

  1. Busca PeekEn HACS, busca «Peek» y ábrelo.
  2. Descarga PeekLuego reinicia Home Assistant.
  3. Añade la integraciónVe a «Settings › Devices & services › Add integration», elige Peek, inicia sesión en Peek y selecciona «Permitir».

Si Peek no aparece, añade https://github.com/plhery/peek-ha con su enlace: con «Add from link» en el Marketplace, que la primera vez te pide que conectes GitHub, o como repositorio personalizado de tipo «Integration» en HACS.

También puedes instalarla a mano: copia la carpeta custom_components/peek en la carpeta custom_components de tu configuración, reinicia y añade la integración como arriba.

¿Cómo añado la tarjeta Peek parcels a mi panel?

La integración carga por sí sola su tarjeta en todos los paneles: no hay ningún recurso que añadir. Una página que ya estaba abierta mientras configurabas Peek aún no tiene la tarjeta: recárgala antes, o cierra la app de Home Assistant y vuelve a abrirla.

  1. Edita un panelÁbrelo y selecciona el lápiz. En un panel que Home Assistant creó por ti, primero te pide que tomes el control.
  2. Selecciona «Add card»Luego la pestaña «By card». La pestaña «By entity» busca entidades, no tarjetas.
  3. Elige «Peek parcels»Busca «Peek», elige «Peek parcels» y guarda.

La tarjeta tiene dos estilos: una lista, el predeterminado, con una fila por paquete que muestra la furgoneta de su transportista, su etapa y su día; o una tarjeta por paquete con los colores de su transportista, como los widgets de Peek para iPhone y Android, con Pip, la ciudad del último escaneo, el nombre del paquete, su etapa y su día. Los dos siguen las secciones de Peek, empezando por los paquetes que te necesitan, y terminan con «+N more» cuando hay más paquetes que filas.

La tarjeta sigue tu tema, claro u oscuro, y tu idioma, si es inglés o francés. En YAML es type: custom:peek-parcels-card; el README de la integración enumera sus opciones.

¿Puedo usarla en automatizaciones o preguntar a Assist?

Sí. El README trae cuatro automatizaciones listas para usar:

  • una notificación en tu móvil cuando un paquete sale a reparto;
  • añadir los números de seguimiento de tus correos de envío, leídos con la integración IMAP de Home Assistant;
  • un mensaje por la mañana con lo que llega hoy;
  • archivar lo que se ha entregado, cada noche.

Cuando añades paquetes a partir de un texto, Peek añade cada número de seguimiento que encuentra, hasta 10 a la vez, y solo guarda los números y el nombre que le das, así que, cuando puedas, envía solo la parte del correo sobre el envío.

Cuando una de las entidades de Peek está expuesta a Assist («Settings › Voice assistants › Expose»), puedes preguntar «¿qué llega hoy?» o dónde está tu paquete de una tienda. La herramienta de Peek en Assist solo lee: nunca añade ni archiva paquetes. Lo que devuelve (nombres, tiendas, transportistas, etapas, días previstos y el lugar del último escaneo) va al agente de conversación que hayas elegido, que puede ser un servicio en la nube.

¿Qué no puede hacer?

  • Borrar o editar paquetes. Home Assistant solo pide ver tus paquetes, y añadirlos y archivarlos. Puedes restaurar un paquete archivado en Peek.
  • Conectar Claude, ChatGPT o Gemini. Se conectan a Peek por su cuenta: consulta la guía Sigue tus paquetes en ChatGPT, Claude o Gemini.

¿Qué guarda Home Assistant y cómo quito la integración?

Home Assistant solo habla con Peek, en peektracker.com, y guarda los tokens del inicio de sesión en su configuración, como cualquier integración. Su historial registra los recuentos de los sensores y los eventos «Parcel updates», con el nombre del paquete, su transportista, su etapa y su último lugar, pero no las listas de paquetes de los sensores. La tarjeta funciona en tu navegador con los datos del propio Home Assistant y no carga nada de ningún otro sitio.

Para quitarla, borra Peek en «Settings › Devices & services»: Home Assistant le devuelve su acceso a Peek, que olvida la conexión, y tus paquetes siguen en Peek. Si en ese momento no se puede contactar con Peek, o para cortar el acceso de Home Assistant desde el lado de Peek, selecciona «Desconectar» junto a Home Assistant en la web de Peek (no en sus apps), en «Ajustes» → «Entregas» → «Asistentes». Una integración que conserves después muestra «Authentication expired for Peek»; al reconfigurarla empieza el mismo inicio de sesión.

Fuentes