Conecta Plant Reminder con Home Assistant y Alexa

Qué es

La API de Plant Reminder permite que otras herramientas lean tus plantas y apunten sus cuidados: leer lo que toca y actuar apuntando riegos y abonos o deshaciéndolos. La usan Home Assistant y Alexa, y también cualquier script tuyo.

Está incluida con Premium, o puedes conseguir un pase de 30 días por 30 tokens (los tokens se compran en la app). El pase no se renueva automáticamente.

Crea el token en la app

Cada integración usa un token personal. Para crearlo:

1. Abre la pestaña Más y entra en Home Assistant y Alexa.
2. Pulsa Activar.
3. Pulsa Crear token.
4. Pulsa Copiar.

El token solo se muestra una vez, así que cópialo enseguida. Puedes revocarlo en cualquier momento y crear otro.

La opción Permitir apuntar riegos y abonos viene marcada por defecto. Si la desmarcas, el token pasa a ser de solo lectura y cualquier escritura devuelve insufficient_scope.

Home Assistant

Todo lo que sigue se puede pegar en tu configuration.yaml. Sustituye TU_TOKEN por el token que copiaste.

Sensor: plantas por regar

Un sensor rest que consulta cada 300 segundos. Su estado es el número de plantas que toca regar hoy o van atrasadas. El atributo plants lleva todo lo que toca, cada elemento con su kind: watering (riego), fertilization (abonado) o transplant (trasplante).

rest:
  - resource: https://kerijldtrzlwaawlpdcw.supabase.co/functions/v1/public-api/v1/due?days=1
    scan_interval: 300
    headers:
      Authorization: "Bearer TU_TOKEN"
    sensor:
      - name: "Plantas por regar"
        value_template: "{{ value_json.plants | selectattr('kind', 'eq', 'watering') | list | count }}"
        json_attributes:
          - plants
          - overdue_count
          - today
          - as_of

Comandos: regar, abonar y deshacer

Un rest_command por acción. plant_reminder_water y plant_reminder_fertilize reciben un plant_id; los identificadores salen de GET /v1/plants o del atributo plants del sensor.

rest_command:
  plant_reminder_water:
    url: "https://kerijldtrzlwaawlpdcw.supabase.co/functions/v1/public-api/v1/plants/{{ plant_id }}/water"
    method: POST
    headers:
      Authorization: "Bearer TU_TOKEN"
    content_type: "application/json"
    payload: "{}"
  plant_reminder_fertilize:
    url: "https://kerijldtrzlwaawlpdcw.supabase.co/functions/v1/public-api/v1/plants/{{ plant_id }}/fertilize"
    method: POST
    headers:
      Authorization: "Bearer TU_TOKEN"
    content_type: "application/json"
    payload: "{}"
  plant_reminder_water_all_due:
    url: "https://kerijldtrzlwaawlpdcw.supabase.co/functions/v1/public-api/v1/due/water"
    method: POST
    headers:
      Authorization: "Bearer TU_TOKEN"
    content_type: "application/json"
    payload: "{}"
  plant_reminder_undo:
    url: "https://kerijldtrzlwaawlpdcw.supabase.co/functions/v1/public-api/v1/actions/undo"
    method: POST
    headers:
      Authorization: "Bearer TU_TOKEN"
    content_type: "application/json"
    payload: "{}"

Consejo: en lugar de escribir el token en el fichero, guárdalo en secrets.yaml y refiérelo con !secret.

Automatización: avisar cuando toque regar

Envía una notificación con los nombres de las plantas cada vez que el sensor pasa de cero. Usa la sintaxis de Home Assistant 2024.10 o posterior (triggers: y actions:); cambia notify.notify por tu propio servicio de notificaciones.

automation:
  - alias: "Plant Reminder: plantas por regar"
    triggers:
      - trigger: numeric_state
        entity_id: sensor.plantas_por_regar
        above: 0
    actions:
      - action: notify.notify
        data:
          title: "Plantas por regar"
          message: >-
            {{ state_attr('sensor.plantas_por_regar', 'plants') | selectattr('kind', 'eq', 'watering') | map(attribute='name') | join(', ') }}

Referencia de endpoints

Todas las rutas cuelgan de la URL base de abajo y necesitan la cabecera Authorization: Bearer TU_TOKEN. Los cuerpos son JSON.

URL base: https://kerijldtrzlwaawlpdcw.supabase.co/functions/v1/public-api

• En las escrituras puedes enviar la cabecera opcional Idempotency-Key: repetir una petición con la misma clave devuelve el resultado original en lugar de apuntarlo dos veces.
• Las fechas son ISO 8601 en UTC.
• Cada respuesta lleva api_version (ahora "1").
• Los errores tienen la forma {"error": "código", "message": "..."}.

Errores y límites

Límites

• 10 peticiones por minuto y 5.000 al día por token.
• 60 escrituras al día por token (un lote cuenta como una).
• Deshacer solo quita lo que apuntó tu propia integración en las últimas 24 horas.

Alexa Próximamente

La skill de Plant Reminder para Alexa sigue en proceso de certificación, así que todavía no está disponible. Así funcionará:

Podrás decir:

• Alexa, abre mis plantas
• Alexa, pregunta a mis plantas qué toca regar hoy
• Alexa, pregunta a mis plantas si toca regar la monstera
• Alexa, dile a mis plantas que he regado el ficus
• Alexa, dile a mis plantas que regué el ficus ayer
• Alexa, dile a mis plantas que riegue las plantas del salón
• Alexa, dile a mis plantas que riegue todas las de hoy
• Alexa, dile a mis plantas que deshaga lo último

Vincularás tu cuenta desde la app de Alexa. La skill estará disponible en español e inglés. Después de apuntar una planta, la skill pregunta si quieres apuntar otra: di su nombre o «ya está». Las listas largas se leen de cinco en cinco. Si preguntas por una planta («¿toca regar la monstera?»), te dice si le toca hoy, cuántos días de retraso lleva o qué día le toca; si le toca, se ofrece a apuntar el riego.

Privacidad

De cada token guardamos la fecha del último uso y un recuento diario de peticiones, para aplicar los límites y mostrarte si está en uso.

El token en sí solo se guarda en forma de hash, nunca en claro: nadie, ni nosotros, puede volver a leerlo. Por eso solo se muestra una vez.

Soporte

Para dudas, errores o ayuda con tu cuenta, escríbenos a [email protected].

Tiempo de respuesta habitual: 24–48 horas laborables.