Message Formats¶

The Telegram bot offers four message formats — pick one in notifications.telegram.messageFormat.

✅ Import Summary

🏦 Banks: 3/3 (100%)
📥 Transactions: 47 imported
🔄 Duplicates: 12 skipped
⏱ Duration: 38.2s

✅ discount: 18 txns 12.3s
✅ leumi: 22 txns 15.1s
✅ hapoalim: 7 txns 10.8s

✅ Import Summary
3/3 banks | 47 txns | 38.2s

✅ Discount · 0152228812
14/02  משכורת חודשית
       +12,500.00
14/02  שופרסל דיזנגוף
       -342.50
14/02  חברת חשמל
       -289.00
💰 45,230.50 ILS
✅ Balance matched

✅ Import Summary
47 transactions · 38.2s

✅ Discount (0152228812)
14/02 משכורת חודשית
        +12,500.00
14/02 שופרסל דיזנגוף
           -342.50
14/02 חברת חשמל
           -289.00
Balance: 45,230.50 ILS
✅ Balance matched

✅ Import Summary

📊 3/3 banks · 47 txns · 38.2s

💳 Discount
  📥 +12,500.00  משכורת חודשית
  📤 -342.50  שופרסל דיזנגוף
  📤 -289.00  חברת חשמל
  💰 45,230.50 ILS
  ✅ Balance matched

Phone-friendly variant¶

When listenForCommands: true, the logger format auto-switches to phone (no emojis, compact lines) so that /logs output is readable on a small screen. Message format stays whatever you chose.

On failure¶

🚨 Import Failed

🔐 Authentication Error (discount): Invalid credentials. Please verify your password.

Errors are categorized so users can self-serve fixes: authentication, captcha, rate-limit, password change required, network. Each category includes a one-line action hint.

Partial runs¶

Every bank is imported in its own child process, so one bank failing never cancels the others. When a Telegram-triggered import finishes with a mix of outcomes, the bot reports exactly which banks failed instead of implying the whole run was lost:

⚠️ Partial import (38s) — 4/5 banks OK, 1 failed:
  • paybox: Invalid credentials. Please verify your password.

Use /retry to re-run the failed bank(s), or /logs for details.

Only when every bank failed does the message read as a total failure:

❌ Import failed (12s) — all 3 bank(s) failed:

/status uses the same distinction and shows partial: 4/5 OK for a mixed run.

Each child process also sends its own 🚨 Import Failed message when none of the banks it was given succeeded. That message names the bank and the reason rather than reporting a bare status token, so a single-bank child never reads as a total outage:

🚨 Import Failed

Import failed for visacal: Hard-model scrape resolved zero accounts

When a child was given several banks and every one of them failed, the message states the count and lists up to five banks, eliding the rest:

🚨 Import Failed

All 3 banks failed — visacal: zero accounts; max: login rejected; leumi: timeout

See also¶

• Telegram setup
• Webhook payloads
• Logging — controls log file output, separate from Telegram message format