Cronofy changelog
Cronofy changelog
www.cronofy.com

Real-Time Scheduling event overrides

 

API

  

We've released two updates to Real-Time Scheduling that give you more control over the calendar events it can create on your behalf.

  • events can now have conferencing settings overridden based on who is selected as the organizer of the event
  • events can have attendees automatically added when they are selected for the time slot as a result of the Availability Query you specify

There's a full example that makes use of both new features over on our docs site. For more details, read on.

These features build on top of single event creation mode and are both an addition to the target_calendars parameter.

In this mode, the Real-Time Scheduling link will create a single event in an organizer's calendar as the result of the end-user selecting a time. The organizer is chosen based on the Availability Query you provide. The Availability Query may specify that multiple members of a group of potential participants must be available at the same time for a slot to be valid. For example, an interview that requires three members out of a larger pool of potential interviewers.

Specifying the organizer's conferencing profile

target_calendars.event (docs) controls event overrides when a given user is selected as the event organizer.

{
...
  "target_calendars": [
    {
      "sub": "acc_5e591ae2815c14f86ea55caf",
      "calendar_id": "cal_Xlka34FcFPhupVxZ_K@fbCQqIXfoVEHSVR06mpg",
      "event": {
        "conferencing": {
          "profile_id": "pro_YABpIfWqk4wjcW5t"
        }
      }
    }
...
}

Here, a specific conferencing profile belonging to the account is provided. When the event is placed in their calendar, this will override any conferencing set on the top level event template.

This allows you to provide end-users with discrete control over their preferred conferencing mechanism, for events booked in their calendar.

Adding attendees from the Availability Query

target_calendars.attendee (docs) controls how the other participants in the Availability Query are added to the final event. They'll only be added if they are available at the selected time, and only as many as are required.

{
...
  "availability": {
    "participants": [
      {
        "members": [
          {
            "sub": "acc_5e591ae2815c14f86ea55caf"
          }, ...
        ],
        "required": 3
      }
...
  "target_calendars": [
    {
      "sub": "acc_5e591ae2815c14f86ea55caf",
      "calendar_id": "cal_Xlka34FcFPhupVxZ_K@fbCQqIXfoVEHSVR06mpg",
      "attendee": {
        "email": "marty@evenitron.com",
        "display_name": "Marty McFly"
      }
    }, ...
  ],
...
}

In the scenario where three members of a pool must be available at the same time:

  • the first will have the event placed in their calendar
  • the other two can now automatically be invited as an attendee, should they be specified here

Real-Time Scheduling overlapping slots

 

API

  

We've added the ability for the slot options presented by Real-Time Scheduling links to overlap, meaning your end-users can have more choice over the times they select.

As an example, consider an event that will be one hour long, but the target calendar is unavailable between 12:30 - 13:30, marked by the blue arrows:

image.png

  • With default settings, we'll consider slots every hour, meaning the one hour period of unavailability blocks two hours of slots.

  • Setting a start_interval of 30 minutes helps, since it allows us to consider slots beginning on the half hour. This was previously available.

  • This most recent change allows enabling overlapping_slots via the Availability Query's response_format parameter, giving the greatest possible choice to the user.

The default remains unchanged (non-overlapping slots), so as not to impact existing consumers.

To read more about these parameters, please see our docs here.

Clearer Teams/Meet conferencing

 

Scheduler

  

We've updated the Conferencing option in your Scheduler preferences and when creating a Request to be more clear when Microsoft Teams or Google Meet is available through your calendar.

image.png

There's no action needed for existing users - Teams and Meet were previously available behind the "Default conferencing" option - we've just made it more obvious which service will be used so you can schedule more confidently.

New users who've connected a Google or Microsoft 365 calendar with the respective conferencing service available will see it selected by default.

Rescheduling Scheduler requests

 

Scheduler

  

We've released the capability to allow recipients of Scheduling Requests to change their selected time after making their initial time slot choice.

This is an option for Scheduling Request creators, and appears as a new default setting in your preferences as well as being an option on individual requests:

image.png

When this is enabled, the recipient of the scheduling link may change their slot selection at any time before the event occurs.

image.png

When this happens, we'll email the event host, and move the event in their calendar. We'll preserve any changes to the event (e.g. additional attendees, any updates to the event description) when doing so.

We'll always respect the live availability of the host and relevant participants, in line with the configuration of the original request.

Scheduler Requests page

 

Scheduler

  

We've added a new page for Scheduler users to help track your requests, and enable visibility of requests across your Organizational Units.

Navigate to Scheduler ➡ Requests or click View all requests on the Scheduler dashboard to see the new page.

image.png

On this page you can:

  • Sort requests by date
  • Filter by status
  • Filter by Organizational Unit (if you're scheduling across multiple teams)

You can search for requests based on the name or email address of participants. Try searching for @example.com to get all requests involving a particular company!

This page also introduces the ability to view others' requests in an Organizational Unit which you are the Owner of. Flip My requests to All requests and we'll show all requests you have the permission to view.

Conferencing moved out of Beta

 

API

  

Conferencing services have been promoted from Beta to general availability.

These APIs make it easy to add video conferencing to your events. It supports a variety of providers, as well as supplying your own conference details.

When a conference is created through Cronofy, changes to the event start time and name will be synced to the conference.

Real-Time Scheduling - Spanish locale

 

API

  

We've added Spanish translations for our Real-Time Scheduling pages.

Locales are detected for end-users automatically, so no changes are required to benefit from this.

If your application forces locale selection by adding a ?locale= parameter to the link's query string, es is now a supported value.

Ignoring calendar events for availability

 

API

  

There are situations where it makes sense to ignore the events in someone’s calendars when generating a list of availabile slots. For example, a recruiter has pre-agreed slots to offer a candidate with a hiring manager, or a sales person needs fit a call in with a client and is happy to override internal meetings.

In these situations you may still want to respect someone’s working hours as defined with Availability Rules or Availability Periods.

This can be achieved by passing an empty array to the participants.members.calendar_ids parameter in the Availability query.

In this example we’re generating slots for 2022-02-07 and respecting the Availability Rules for the participant with sub value of acc_567236000909002.

{
  "participants": [
    {
      "members": [
        {
          "sub": "acc_567236000909002",
          "calendar_ids": [],
          "managed_availability": true
        }
      ],
      "required": "all"
    }
  ],
  "required_duration": { "minutes": 30 },
  "query_periods": [
    {
      "start": "2022-02-07T00:00:00Z",
      "end": "2022-02-08T00:00:00Z"
    }
  ]
}

More in the Ignoring Calendar Events docs.

Bulk Enterprise Connect authorization

 

API

 

Calendar authorization

  

A common pattern when using Enterprise Connect is requesting authorization for all known users or resources from the domain in quick succession.

Previously, this required an individual API request being made for each email address. For larger organizations this could mean reaching your rate limits when otherwise normal API traffic was far from reaching them.

We've now added the ability to request authorization to a collection of up to 50 email addresses in a single request. The rest of the Enterprise Connect authorization process is unchanged. This simply allows you to hand off the initial work of verifying, approving, and synchronizing your customers' schedules to Cronofy in a more efficient manner.

As part of this enhancement, we've also improved our guards against overwhelming downstream calendar services. We did this as the only foreseeable downside of accepting requests more quickly was that fulfilling them could overwhelm your customers' calendar hosting.


If you have any questions, or need any help, please get in touch via the Support Widget or via email to support@cronofy.com

Event Triggers

 

API

 

Alpha

 

 

We have just released a new, powerful capability for driving application workflows through the Cronofy scheduling platform: Event Triggers.

Cronofy has long helped create events with the scheduling capabilities of our Availability Engine. Time and again we saw our customers building features such as pre-event reminders and post-event surveys around the scheduled times.

Tracking the times to trigger such workflows is not a trivial challenge, particularly when events can be moved or cancelled. This is solved by Event Triggers. By registering for callbacks relative to the start or end of the event when creating it, Cronofy will take care of the "when" allowing your integration to focus on the "what".

Event Triggers are available today on all API plans. We're excited to see what you build with them!


If you have any questions, or need any help, please get in touch via the Support Widget or via email to support@cronofy.com