Skip to content

Telegram Commands

Telegram is the first everyday interface for Calendaria. Use the bot for quick calendar reads and for writes that you explicitly confirm.

WhatsApp reuses the same agent and confirmation model. Use Telegram when you prefer Telegram commands, or WhatsApp when you prefer WhatsApp chat.

Find the bot

/start has two states

Open Telegram, search for Calendaria, and choose @AICalendarBot. If you are not signed in, /start gives you a private sign-in link for the email magic link flow. If you are already set up, Telegram returns examples you can try. Calendar setup happens in the dashboard.

  • 1Open Telegram search.
  • 2Select the Calendaria bot with the username @AICalendarBot.
  • 3Tap Start or send /start.
C Calendaria.co@AICalendarBot
/start
If you are not signed in yet, open your private sign-in link and use your email magic link.
Open private link
You're already set up.

Just talk to me in your own words. Try:
• "what's on my plate today?"
• "agéndame algo mañana 3pm"
• "move my 3pm to 4pm"

Bot commands

/start Start setup or reconnect Gives signed-out users a private sign-in link for the email magic link flow. If you are already set up, it gives natural-language examples you can try.
/help See what Calendaria can do Shows the current command list and natural-language examples.
/whoami Check linked account state Shows the current chat's linked Calendaria user, timezone, and Google Calendar connection status.

You can also ask for help in plain language:

help
what can you do?

Read your calendar

Reads run immediately because they do not change your calendar.

what do I have tomorrow?
show me next week
anything Friday afternoon?
C Calendaria.co@AICalendarBot
what do I have tomorrow?
Tomorrow you have design review at 10:00 and focus time from 2:00 to 4:00.
Expected result

What to look for

  • 1Immediate answer Read requests run without a confirmation step.
  • 2Visible scope Calendaria replies with the events it can see for the requested window.
  • 3Language match The response tries to follow the same general language as your request.

Create an event

Create events with natural phrasing:

block 4-8pm tomorrow for the deck
lunch with Ana at 1 Thursday
30 min call now
C Calendaria.co@AICalendarBot
lunch with Ana at 1 Thursday
I can create "Lunch with Ana" for Thursday at 1:00 PM.
ConfirmCancel

Move or delete events

move my 3pm to 4
push the design review to Thursday morning
delete my 5pm
cancel the design review

If more than one event might match, Calendaria can ask for clarification or list the likely target before preparing the write. Deletes and moves require confirmation.

Conflict warnings and alternatives

When a requested slot is busy, Calendaria can warn you and suggest alternatives. Suggested slots prioritize nearby times on the same day, then nearby days.

Busy slot

Calendaria warns first

If your requested time conflicts with another event, the bot should surface that before the write.

Alternatives

You choose the slot

Choosing an alternative is treated as explicit confirmation for that proposed time.

Boundary

No standalone free/busy yet

Dedicated attendee availability checks and broad free-slot queries remain roadmap work.

Current boundaries

  • Standalone free-slot queries are still roadmap work.
  • Dedicated attendee free/busy checks are not live yet.
  • Preference changes through natural language are planned but not part of the first public docs surface.
  • WhatsApp supports the same core calendar request and confirmation model through WhatsApp-native controls.