Skip to content

Telegram Commands

Telegram is one of Calendaria's everyday chat interfaces. 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 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.

Send voice or audio

Telegram voice notes and audio files work like typed requests after transcription. Send a short calendar request by voice, and Calendaria transcribes it before routing the transcript through the normal assistant flow.

voice note: "move my 3pm to 4"

Same confirmation rule

Audio input only changes how the request starts. If the transcript asks Calendaria to create, move, edit, RSVP, delete, or share something, the write still waits for confirmation.

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, edit, or delete events

move my 3pm to 4
push the design review to Thursday morning
rename the design review to product review
add ana@example.com to the planning meeting
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, moves, and edits require confirmation.

Find free time

Calendaria can search for open slots across connected calendars included in availability checks.

find 45 minutes for planning this week
find a time tomorrow that works for me and ana@example.com

When attendee availability cannot be verified, Calendaria should say so. If you already say what to schedule, Calendaria can return slot buttons; choosing one creates the event for that slot.

Respond to invitations

accept the design review
decline tomorrow's lunch
mark the team sync as maybe

RSVP responses require confirmation. For recurring invitations, say whether you mean one occurrence or the whole series.

create a booking link for 30-minute intro calls
I'm hosting dinner Saturday at 8pm, create an invite link for 8 people
who's coming to the dinner?

Booking links let guests choose from your free slots. Group invites are fixed-event RSVP links that count who joined.

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.

Availability

Free-slot search is live

Calendaria can search connected calendars for open time and disclose any attendee it could not verify.

Current boundaries

  • Outlook attendee free/busy is limited today; unchecked attendees are reported instead of assumed free.
  • Booking links and group invites currently use Google calendar connections.
  • 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.
  • Audio requests are available in Telegram, WhatsApp, and dashboard web chat. They are not an MCP, ChatGPT app, or external voice assistant feature.