Interviews with Google Calendar and ICS
Crutor finds the interview time for you: it checks when you're busy, offers the candidate a few free times, and the candidate books with one tap. Connect Google Calendar or any calendar with an iCal (ICS) link, set your working hours and time zone: three steps, done once. After that it's one button in the candidate's topic, and the bot sends the times, the confirmation, a calendar file and reminders.
What you need
- A published job and a candidate who has a topic in the job's group. To publish a job, see Your first job in 5 minutes.
- Google Calendar, or Outlook, Apple, Yandex or any other calendar that can give you an iCal link.
Setup (once)
Connect a calendar. Send
/calendarto the bot. On the “📅 Calendars” card, choose:- 🔗 Connect Google Calendar: a browser opens with the Google sign-in. Allow access and go back to Telegram: the bot writes “✅ Calendar … connected” and how many busy blocks it sees in the next 7 days. Crutor reads only when you're busy, never event titles or attendees, and creates the interview events in your primary calendar.
- ➕ Another calendar (Outlook, Apple, Yandex) via an iCal link: send the link. The bot tells you where to find it: in Google Calendar, “Settings → your calendar → Secret address in iCal format”; in Outlook, “Settings → Calendar → Shared calendars → Publish a calendar”. With such a link Crutor only reads busy times, and reads them afresh every time it looks for slots; it doesn't create events in that calendar.
You can connect several calendars; busy time is taken from all of them.
Set your working hours. ⚙️ Working hours opens “Settings → Calendars” in the app. There you set the interview hours for each day (Monday to Friday, 10:00–19:00 by default), the buffer between meetings (15 minutes), the default meeting length (45 minutes), and a video link for meetings without Google Meet, such as a permanent Zoom or Telemost room.
Set your time zone. On the same page, tap “Use this device's: …” or pick a zone. Without it the bot can't find times: it tells you it doesn't know your time zone.
How a candidate books
- Ask for times. In the candidate's topic in the job's group, tap 📅 Interview time on the application card or send
/meet. You can add wishes in your own words:/meet tomorrow after 3pmor/meet Tuesday or Wednesday. In the app, the same is on the candidate's page under “Interview”: the “When” field and Find times. - Check the times. The bot posts “📅 Free times for …” in the topic, with the length and time zone. By default it looks 7 days ahead, no sooner than 3 hours from now, and picks 5 times spread across different days. Without a connected calendar the times come from working hours only, and the bot says so. 🔎 Look further ahead widens the search; ✖️ Cancel the interview cancels.
- Send them to the candidate. Tap 📤 Send to …. The candidate gets “📅 …: the team invites you to an interview (45 min). Pick a time that suits you.” with a button per time and 🙅 None of these work. They can also answer in words, naming one of the times or writing something like “Thursday after 5 pm”: the bot looks for a matching time and offers it.
/meet in the candidate's topic: the bot checks your calendar, posts free times, and 📤 Send passes them to the candidate. - Booking. When the candidate picks a time, the bot checks the calendars once more. If the time has just been taken, the candidate gets the remaining times. If it's free, the candidate sees “✅ Interview booked: …”, the video call link and an
interview.icsfile for their own calendar. The topic gets “📅 Interview with …”, and the application moves to the “Interview” stage if it was in “New” or “Shortlist”.
With Google Calendar connected, an event “Candidate name · job” appears there with a Google Meet link, or with your own video link if you set one.
Time zones
When the candidate's time zone is known, they see times in their zone, and your preview shows both yours and theirs. When it isn't, the bot shows times in the team's zone, names the zone, and asks the candidate to write their city if they're somewhere else. From then on the candidate sees times in their own zone.
Reminders, rescheduling and cancelling
- Reminders to the candidate come a day and an hour before the interview, with 👍 I'll be there, 🔁 Reschedule the interview and ✖️ Cancel the interview. The day-before reminder is skipped when the interview is booked less than a day ahead. The event in your Google Calendar uses Google's usual reminders.
- The candidate reschedules or cancels with the buttons under the confirmation or a reminder. On a reschedule the bot finds and sends new times by itself; on a cancel it asks them to confirm. You see everything in the candidate's topic.
- You reschedule or cancel in the topic:
/meetfor an interview that's already booked shows it with 🔁 Reschedule the interview and ✖️ Cancel the interview. The candidate's page in the app has the same. - From Google Calendar. Move or delete an event Crutor created, and the bot notices, tells the candidate (with an updated calendar file) and posts in the topic.
Interviews with your team
Colleagues who interview join the job's team: send /team in the job's group, the bot pins a card with 👥 Join the team, and they connect their own calendar. Name a colleague in your wishes, for example /meet with Anna tomorrow, and the bot takes their busy time into account and, if you connected Google Calendar, adds them to the event. People outside the team can be saved as contacts with an email (“Settings → Calendars” in the app).
Limits
- There is no separate Outlook connection with a Microsoft sign-in, only the iCal link.
- The candidate's calendar isn't connected, and the candidate isn't added to the Google event: they get the
.icsfile in Telegram. - Scheduling works for candidates from the chat with the bot. It isn't available yet for applications that came in through Telegram Business.
Try it on your own job
Five minutes to describe it, and the link for candidates is ready.
Try it on your job