# Mensaje nuevo — BoT GPS

Método de Botize — `bsize_bot.new_message` (disparador).

Se dispara una vez por cada mensaje nuevo en la bandeja de un tag BoT: mensajes de voz (que llegan ya transcritos a texto), avisos del propio BoT y cargos de la tarjeta de transporte. Un mensaje por ejecución, el pendiente más antiguo primero, sin repetir. La primera ejecución publica el mensaje más reciente y da por vistos los anteriores, para que activar la tarea no te repita todo el histórico.

Es un disparador: inicia la tarea. Una tarea tiene exactamente uno.

## 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
- `message_kind` *(string, one of: ""; "voice"; "push"; "transit_ic")* — Sólo este tipo de mensaje. Vacío significa todos
- `sender` *(string, one of: ""; "tag"; "me"; "system")* — Sólo mensajes de este remitente. Vacío significa cualquiera

## Variables de salida

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

- `{{message_id}}` *(text)* — Id del mensaje
- `{{message_kind}}` *(text)* — Tipo de mensaje. voice, push (un aviso de BoT) o transit_ic (un cargo de la tarjeta de transporte).
- `{{sender}}` *(text)* — Remitente. tag cuando viene del aparato, me cuando lo has mandado tú desde la app de BoT, system cuando lo genera BoT.
- `{{sender_name}}` *(text)* — Nombre del remitente
- `{{text}}` *(text)* — Texto
- `{{transcript}}` *(text)* — Transcripción. Lo que dice el mensaje de voz, transcrito por BoT. Vacío en los mensajes que no son de voz. Éste es el valor que querrás mandar a un correo o a un chat.
- `{{voice_url}}` *(url)* — Enlace al audio. Enlace firmado al audio. Caduca, así que úsalo en la misma ejecución; no lo guardes para abrirlo días después.
- `{{voice_seconds}}` *(int)* — Duración del audio (segundos)
- `{{transit_amount}}` *(int)* — Cargo de transporte (yenes)
- `{{transit_balance}}` *(int)* — Saldo de la tarjeta (yenes)
- `{{transit_usage}}` *(text)* — Uso de la tarjeta. Para qué se usó la tarjeta, tal como lo cuenta BoT (por ejemplo un viaje o una compra). Vacío cuando el mensaje no es de la tarjeta.
- `{{created_at}}` *(date)* — Fecha de envío (UTC)
- `{{created_ts}}` *(int)* — Fecha de envío (epoch)
- `{{device_id}}` *(text)* — Id del tag

## 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/new_message