Skip to content

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:

ActionWhat it doesSaved as
Create an eventAdds an event to the calendar, for example the appointment the customer chose.event
Update an eventChanges an event: time, title, description. Fields left empty stay as they are.event
Cancel an eventCancels (deletes) an event. Guests are told only if you choose so.event
Find eventsFinds events in a time range, by text or by a phone number written in the event.events
Today's or tomorrow's eventsLists today's or tomorrow's events, with a ready-to-send text list.events
Check free / busyChecks whether the calendar is free in a time range.busy
Suggest free timesFinds 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.

The Google Calendar step

Book an appointment#

  1. 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. 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. 3

    Pick the action and calendar

    Under Action, choose Create an event. In Calendar, keep Main calendar or pick another one.

  4. 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 like 2026-10-14T09:00 works too).

  5. 5

    Set the length

    In Length, choose minutes, hours, or an End time. The default is 30 minutes.

  6. 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. 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. 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#

ActionExamples
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#

ProblemFix
"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.