Salesforce Scheduler Developer Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
Introduction to Salesforce Scheduler
Set Up Salesforce Scheduler
Salesforce Scheduler Data Model Overview
Salesforce Scheduler Standard Objects
Salesforce Scheduler Custom Objects
Salesforce Scheduler Platform Events
Salesforce Scheduler Metadata API Types
Authenticate Salesforce Scheduler APIs
Translate SOQL Query Results
Salesforce Scheduler Business APIs
Salesforce Scheduler Apex Classes
Build Custom Appointment Booking Experiences Using Salesforce Scheduler APIs
Schedule an Anonymous Appointment
Schedule Anonymous Appointments with Appointment Distribution
Schedule Appointments by Selecting Location First
Modify an Anonymous Appointment
Create a Single-Resource Appointment
Modify a Service Appointment
Create a Multi-Resource Appointment
Modify a Multi-Resource Service Appointment
Authenticate with Salesforce Scheduler APIs
Get Service Appointments
Get Service Appointment Details
Change Appointment Details
Change Appointment Candidates
Change Appointment Time Slots
Update Service Appointments
Create a Concurrent Appointment
Schedule Appointments by Using Sharing Availability
Schedule Appointments with a Dummy Resource and Reassign to Actual Resources
Integrate Salesforce Scheduler with External Calendars
PDF

Change Appointment Time Slots

A time slot represents a period in a day when an appointment takes place. a multi-resource service appointment can be modified. To show the alternative tome slots for the assigned resources, use the getAppointmentSlots REST API.

Create a page in your app to show the selected primary resource, other required resources, including assets, and the consolidated time slots for the primary service resource and required resources that users select. Here’s how a page can look.A representation of the manage multiple service resource screen.

When the user selects one or more required resources, refresh the available time slots by making a POST request to the getAppointmentSlots REST API and passing the selected required resources along with the workTypeGroupId and territoryId parameters.

Resource URI
https://yourInstance.salesforce.com/services/data/vXX.X/scheduling/getAppointmentSlots
Sample Request
{
   "startTime" : "2021-10-04T17:00:00.000+0000",
   "endTime" : "2021-10-04T18:00:00.000+0000",
   "workTypeId" : {
       "08qB0000000Tf1FIAS"
   },
   "accountId" : "001B000001McLhMIAV",
   "territoryIds" : ["0HhB0000000TaHOKA0"],
   "primaryResourceId" : "0HnB0000000TavDKAS",
   "requiredResourceIds" : ["0HnB0000000DynTKAS", "0HnB0000000Tav3KAC"]
}
Sample Response

The API returns the time slots where the selected primary resource and required resources are available for the multi-resource service appointment.

{
   "timeSlots" : [ {
      "endTime" : "2021-10-04T18:00:00.000+0000",
      "startTime" : "2021-10-04T17:00:00.000+0000",
      "territoryId" : "0HhB0000000TaHOKA0"
   }, {
      "endTime" : "2021-10-04T19:00:00.000+0000",
      "startTime" : "2021-10-04T17:00:00.000+0000",
      "territoryId" : "0HhB0000000TaHOKA0"
   }, {
      "endTime" : "2021-10-04T20:00:00.000+0000",
      "startTime" : "2021-10-04T17:30:00.000+0000",
      "territoryId" : "0HhB0000000TaHOKA0"
   }, {
      "endTime" : "2021-10-04T18:00:00.000+0000",
      "startTime" : "2021-10-04T17:00:00.000+0000",
      "territoryId" : "0HhB0000000TaHOKA0"
   }, {
      "endTime" : "2021-10-04T18:30:00.000+0000",
      "startTime" : "2021-10-04T17:30:00.000+0000",
      "territoryId" : "0HhB0000000TaHOKA0"
   }, {
      "endTime" : "2021-10-04T18:00:00.000+0000",
      "startTime" : "2021-10-04T17:00:00.000+0000",
      "territoryId" : "0HhB0000000TaHOKA0"
   } ]
}
Parse the JSON response, and show the available time slots for the selected resources. Here’s how a Select Service Appointment Time page can look.

A multi-resource appointment can have a maximum of five required service resources: one primary required service resource plus four required service resources, including asset resources.

Note

A representation of the selected required resources screen.

On the next page in your app, you can show the appointment details for the user to review and create the appointment.