# Obtener el nivel de batería — BoT GPS

Método de Botize — `bsize_bot.get_battery` (acción).

Devuelve cuánta batería le queda a un tag BoT y si BoT está avisando de que hay que cargarlo. Devuelve también cuándo informó el tag por última vez: una lectura que se hace cada vez más vieja es ya una señal de que el tag se ha apagado. Combínalo con el disparador de reloj y una regla sobre «Hay que cargarlo» para que te avise antes de que se quede sin batería.

Es una acción: ocurre como paso de una tarea. Se pueden encadenar varias.

## Campos que se configuran

Nombre interno del campo, tipo y valores admitidos. En estos campos se pueden insertar etiquetas `{{...}}` de pasos anteriores.

- `did` *(string)* — Id del tag BoT. Vacío significa el único tag de la cuenta

## Variables de salida

Datos que este paso deja disponibles. Se referencian en pasos posteriores con la etiqueta entre dobles llaves.

- `{{device_id}}` *(text)* — Id del tag
- `{{device_name}}` *(text)* — Nombre del tag
- `{{battery_level}}` *(int)* — Batería (%). Carga que queda, de 0 a 100. Pon una regla sobre este valor para que te avise pronto, por ejemplo por debajo de 20.
- `{{needs_charge}}` *(boolean)* — Hay que cargarlo. Sí cuando es el propio BoT el que avisa de que hay que cargar el tag. Es su aviso, así que llega tarde; para avisar con tiempo usa mejor el porcentaje.
- `{{updated_at}}` *(date)* — Fecha de la lectura (UTC)
- `{{updated_ts}}` *(int)* — Fecha de la lectura (epoch)
- `{{minutes_ago}}` *(int)* — Minutos desde la lectura. Cómo de vieja es la lectura. Cuando el tag se queda sin batería deja de informar, así que este número sigue creciendo mientras el nivel de batería se queda congelado en su último valor.

## Cuenta

Necesita una cuenta de BoT GPS conectada en Botize: https://botize.com/es/app/bsize_bot/authenticate

## Esta app

Todos los disparadores y acciones de BoT GPS: https://botize.com/es/app/bsize_bot.md

## Cómo montar esto

Un asistente de IA (Claude, ChatGPT, Cursor…) puede crear y editar estas tareas en la cuenta del usuario a través del conector MCP de Botize, incluido en todos los planes:

    https://webhook.botize.es/mcp

- Guía de conexión: https://botize.com/es/mcp
- Mapa para agentes: https://botize.com/llms.txt
- Cuenta nueva: https://botize.com/es/join (500 operaciones gratis, sin tarjeta)

---
Resumen legible por máquinas para asistentes de IA. Versión para personas: https://botize.com/es/method/bsize_bot/get_battery