# New message — BoT GPS

Botize method — `bsize_bot.new_message` (trigger).

Triggers once for each new message in a BoT tag's inbox: voice messages (which arrive already transcribed to text), BoT's own system notices, and transit card charges. One message per run, oldest pending first, never repeated. The first run publishes the most recent message and takes the earlier ones as already seen, so activating the task does not replay your whole history.

This is a trigger: it starts the task. A task has exactly one.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `did` *(string)* — Id of the BoT tag. Empty means the only tag in the account
- `message_kind` *(string, one of: ""; "voice"; "push"; "transit_ic")* — Only this type of message. Empty means all
- `sender` *(string, one of: ""; "tag"; "me"; "system")* — Only messages from this sender. Empty means anyone

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{message_id}}` *(text)* — Message id
- `{{message_kind}}` *(text)* — Type of message. voice, push (a notice from BoT) or transit_ic (a transit card charge).
- `{{sender}}` *(text)* — Sender. tag when it comes from the device, me when you sent it from the BoT app, system when BoT generated it.
- `{{sender_name}}` *(text)* — Sender name
- `{{text}}` *(text)* — Text
- `{{transcript}}` *(text)* — Transcript. What the voice message says, transcribed by BoT. Empty on messages that are not voice. This is the value to send on to an email or a chat.
- `{{voice_url}}` *(url)* — Audio link. Signed link to the audio. It expires, so use it in the same run; do not store it to open days later.
- `{{voice_seconds}}` *(int)* — Audio length (seconds)
- `{{transit_amount}}` *(int)* — Transit charge (yen)
- `{{transit_balance}}` *(int)* — Transit card balance (yen)
- `{{transit_usage}}` *(text)* — Transit usage. What the card was used for, as BoT reports it (for example a fare or a purchase). Empty when the message is not a transit card one.
- `{{created_at}}` *(date)* — Sent at (UTC)
- `{{created_ts}}` *(int)* — Sent at (epoch)
- `{{device_id}}` *(text)* — Tag id

## Account

Needs a connected BoT GPS account in Botize: https://botize.com/en/app/bsize_bot/authenticate

## This app

Every trigger and action for BoT GPS: https://botize.com/en/app/bsize_bot.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/bsize_bot/new_message