Steps
Google Calendar
Book, change, cancel and look up appointments in Google Calendar from your chatbot.
What it does#
The Google Calendar step works on a calendar in your Google account, in the background: the customer doesn't see it. One step does one action:
| Action | What it does | Saved as |
|---|---|---|
| Create an event | Adds an event to the calendar, for example the appointment the customer chose. | event |
| Update an event | Changes an event: time, title, description. Fields left empty stay as they are. | event |
| Cancel an event | Cancels (deletes) an event. Guests are told only if you choose so. | event |
| Find events | Finds events in a time range, by text or by a phone number written in the event. | events |
| Today's or tomorrow's events | Lists today's or tomorrow's events, with a ready-to-send text list. | events |
| Check free / busy | Checks whether the calendar is free in a time range. | busy |
| Suggest free times | Finds free times inside working hours, ready to offer the customer. | slots |
Google steps are also rolling out: they appear in the Google group of the step list once they're turned on for your account.
Book an appointment#
- 1
Ask for the time
Before the Calendar step, ask with a Date step, for example one named
date1, and a Text step for the name. - 2
Add the Calendar step
Drag Google Calendar from the Google group and connect it. Under Google account, click Connect Google (or pick an account) and allow Officely to see and edit events in your calendars.
- 3
Pick the action and calendar
Under Action, choose Create an event. In Calendar, keep Main calendar or pick another one.
- 4
Describe the event
Title: for example
Appointment: {{@name}}. Starts:DD/MM/YYYY HH:mm, or the answer of a Date step such as{{@date1}}(ISO like2026-10-14T09:00works too). - 5
Set the length
In Length, choose minutes, hours, or an End time. The default is 30 minutes.
- 6
Add details
Optionally fill Description (tip: write the customer's phone,
Phone: {{#cphone}}, so you can find the event later), Location, Time zone and Guests (optional). - 7
Choose whether to notify guests
Notify guests: Don't notify or Email guests. Guests get Google's invitation only if it's on.
- 8
Connect both outputs
Connect Success to a confirmation such as
Booked for {{#event.start_text}}and Error to a fallback.
Other actions#
- Update an event / Cancel an event: under Which event, write the Event id, usually a variable such as
{{#event.id}}from an earlier step or{{#trigger.id}}from a Start a flow trigger. - Find events: set From and To (or Today, Tomorrow, Next 7 days), plus Text (optional) or Customer phone in the event (optional).
- Today's or tomorrow's events:
{{#events.text}}is a numbered list of the day's events, ready to send. - Check free / busy:
{{#busy.free}}is true when nothing is booked in the range. - Suggest free times: set Length (minutes), How many, and Working hours from / Until (as
HH:mm). Times are never in the past. Send{{#slots.text}}to offer them.
Use the result#
| Action | Examples |
|---|---|
| Create an event | {{#event.id}}, {{#event.start_text}}, {{#event.date_text}}, {{#event.time_text}}, {{#event.link}} |
| Find events | {{#events.count}}, {{#events.first.summary}}, {{#events.first.start_text}}, {{#events.text}} |
| Check free / busy | {{#busy.free}}, {{#busy.count}}, {{#busy.busy[0].start}} |
| Suggest free times | {{#slots.count}}, {{#slots.first.label}}, {{#slots.text}} |
If Google fails, the chat continues on the Error output with {{#google_error.message}} and {{#google_error.code}}. If Error isn't connected, the chat stops and you get an alert.
Try it runs the step against Google for real. Actions that change the calendar ask "Run it for real?" first.
Common mistakes#
| Problem | Fix |
|---|---|
| "Write when the event starts." | Fill Starts with DD/MM/YYYY HH:mm or a Date step's answer. |
| "Write which event, usually a variable such as {{#trigger.id}}." | Update and Cancel need the event id from an earlier step or trigger. |
| "Write guest emails separated by commas." | Check the addresses in Guests. |
| "Only the main calendar is listed." | Reconnect the Google account to pick other calendars. |
| The event time is off by hours. | Set Time zone to your business's time zone. |