Calendly
The Calendly is a scheduling platform which enables you to monitor or retrieve events, invitees, event types, and memberships in your Calendly account. This document describes how to connect IBM watsonx Orchestrate to Calendly and use its skills on watsonx Orchestrate.
Before you begin
Before you connect watsonx Orchestrate to Calendly, make sure that you have a Calendly account. If you don't have a Calendly account, you can create one at Sign up with Calendly for free.
Connecting to Calendly
- A credential type must be set for apps that are a part of team skill sets and AI assistants. Skill-based actions in AI assistants support only shared credentials.
- If a credential type of an app is not specified, an error message is displayed when users attempt to run the skills of the app. To resolve the error, an admin must set the credential type for the app. For more information, see Managing connections.
An app can be connected either through the skill catalog or through the watsonx Orchestrate chat. Use the method that suits you to connect to an app.
Connect to the app through the skill catalog when you add that skill to your skill set:
- On the watsonx Orchestrate chat page, click Add skills from the catalog.
- Search and click the app tile.
- Click Connect app.
- Configure the connection. For more information, see Configuring the connection.
- Click Connect app.
Otherwise, connect to that app through the watsonx Orchestrate chat when you use the skill:
- Open the watsonx Orchestrate chat.
- On the chat, start the skill.
- Click Connect app.
- Configure the connection. For more information, see Configuring the connection.
- Click Connect app.
Configuring the connection on watsonx Orchestrate SaaS
You can connect to Calendly by using Calendly credentials or Gmail credentials.
Connect with Calendly credentials
To connect watsonx Orchestrate to Calendly, complete the following steps:
-
Click Connect app. You are redirected to the Calendly login page.
-
Specify the Email address and Password.
- Email address: The email address used to log in to Calendly.
- Password: The password for the specified email address.
-
Click Allow to grant permission to access your Calendly account.
You are now successfully connected to the Calendly app.
Connect with Gmail credentials
Following are the steps to connect watsonx Orchestrate to Calendly with Gmail credentials:
-
Click Connect app. You are redirected to the Calendly login page.
-
Choose Continue with Google to provide the connection details.
-
Specify the following connection details:
- Email address: The email address to log in to Calendly.
- Password: The password for the specified email address.
-
Click Allow to grant permission to access your Calendly account.
You are now successfully connected to the Calendly app.
Configuring the connection on watsonx Orchestrate on-premises
To connect watsonx Orchestrate to Calendly, complete the following steps:
-
Click Connect app.
-
Specify the following connection details:
- Client ID: The consumer key that is generated when you create a connected application in Calendly.
- Client secret: The consumer secret that is generated when you create a connected application in Calendly.
- Access token: The access token that is generated from the application client ID and client secret.
- Refresh token: The refresh token that is generated from the application client ID and client secret.
-
Click Connect app.
Technical parameters
The following table contains the technical parameters required by some skills of this app and instructions to retrieve them.
Parameters | Details |
---|---|
User URI |
The unique identifier for the user. For example, in the URL https://api.calendly.com/users/{uuid} , the uuid is the User URI . |
Event type URI |
The unique identifier for the event types. For example, in the URL https://api.calendly.com/event_types/{uuid} , the uuid is the Event type URI . |
What to do next
After you connect to the app, you can use the Calendly skills. For more information see, Using the chat.
To learn about the available skills, see List of prebuilt apps, skills and skill flows.
Parent topic: