Marketplace / scheduling-telegram

Scheduling — Telegram channel

Telegram channel for the scheduling stack. v1.1: outbound approval cards with inline-keyboard Approve / Edit / Decline / Snooze, slot pickers for scheduling drafts, edit-via-reply, and per-agent operator chat id with global fallback.

by Agentum 1 installs v1.2.3 integrations
Open in Agentum
Requires the Agentum app

Scheduling — Telegram channel

Adds Telegram as an interactive channel for the scheduling agent. Every draft that needs your decision becomes an inline-button card in your operator chat; tap to act, or reply with corrections to nudge the agent.

What it does

When the scheduling agent produces a draft (a proposed meeting time, a reply needing approval, a conflict to resolve), this add-on:

  1. Posts an inline-keyboard card to your operator chat.
  2. Watches that card for taps. Approve, Edit, Decline, or Snooze each have their own button.
  3. Watches your reply messages. If you reply to a card with free-text (“Push to Thursday afternoon instead”), the agent treats that as an edit and produces a revised draft.

The plugin runs alongside scheduling-next (this is a capability that augments it). You don’t install or operate it separately — it just makes the scheduling agent’s drafts show up in Telegram.

Settings

Open the Configuration tab to adjust:

  • Operator Telegram chat id — the chat that receives approval cards. Required. The fastest way to find yours: message /start to @userinfobot on Telegram and copy the numeric id. Leaving this blank falls back to the global TELEGRAM_ALLOWED_USER_ID, which is fine for single-agent installs but doesn’t scale.
  • Send Telegram approval cards — master on/off. On by default. Off means the agent still produces drafts and you can act on them from the desktop panel — Telegram cards just don’t get sent.
  • TMA base URL — optional. When set (e.g. https://t.me/youragentumbot/youragentum), cards include an “Open in TMA” button that deeplinks to the draft in the Telegram Mini App. Leave blank if you don’t use the Mini App.

What the buttons do

  • Approve — accepts the draft and starts sending whatever the draft proposes (e.g., a calendar invite, a reply email).
  • Edit — opens an interactive slot picker so you can change the proposed times directly in Telegram.
  • Decline — drops the draft. The agent treats this as a hard “no” and won’t re-propose the same option.
  • Snooze — defers the card for ~30 minutes; you’ll see it again if you haven’t acted on it elsewhere by then.

Editing by reply

If a tap-button doesn’t fit your intent, reply to the card with text:

  • “Tuesday morning instead” → agent produces a revised draft with Tuesday morning slots.
  • “Use my work calendar” → agent re-runs with the alternate calendar.
  • “Make it 30 min not an hour” → agent adjusts and re-proposes.

You’ll get a new card with the revised draft. Repeat as needed.

Integrations

Uses your global Telegram setup — no extra credentials configured here. If @userinfobot doesn’t recognize your bot or you don’t have one set up yet, configure Telegram from the main app’s integrations screen first.

Known limits

  • Approval cards expire after 24 hours; the agent re-sends if it still needs your call.
  • The “Open in TMA” button is omitted automatically when the TMA base URL is blank (Telegram URL buttons can’t carry custom schemes, so a fallback “Open in panel” deeplink isn’t possible yet).
  • Snooze always defers for the same fixed interval (~30 min). No per-card snooze duration today.