All Collections
Integrations
CRM Integrations
Integrate Salesforce with Appointlet (beta)
Integrate Salesforce with Appointlet (beta)
Updated over a week ago

This feature is currently in beta. We welcome your feedback and patience as we refine this feature.

Appointlet's Salesforce integration brings together our robust scheduling system and Salesforce's expansive CRM capabilities to streamline your workflow. This integration responds to key events in Appointlet - such as meeting scheduling, rescheduling, or cancellation - to automatically update relevant Salesforce records.

You can use this integration to automatically update prospects, leads, or opportunities when related parties schedule new meetings. This guide will give you a detailed overview of the integration, what it's capable of, how it works, and how to set it up effectively.

How the Integration Works

This integration works by calling Salesforce flows in response to key events within Appointlet. When one of these events occur, we pass along the relevant meeting data to the specified Salesforce flow. With this data, you can trigger automations that can perform almost any task within Salesforce.

Here are the events that can trigger a Salesforce flow:

  • Meeting Scheduled

  • Meeting Cancelled

  • Meeting Rescheduled

By responding to these events, you can automate your actions to scheduling changes, ensuring your Salesforce data stays current and your operations run smoothly.

Prerequisites

Before you can begin setting up your Salesforce integration, you will need to ensure you have the appropriate permissions within Salesforce:

  1. API Enabled: Our integration uses API calls to communicate with your Salesforce account, so this permission is essential. While it's generally enabled for most standard profiles, those using a custom profile will need to confirm it's activated.

  2. Manage Flows: Since our integration triggers flows in your Salesforce organization, you must have the permission to manage them. This involves creating, editing, activating, and deactivating flows as needed.

Initial Setup

The first step is to connect Appointlet to your Salesforce account. By doing this, you grant Appointlet the necessary permissions within your Salesforce environment.

To accomplish this, follow these steps:

  1. Navigate to the "CRMs" section in your Appointlet account settings.

  2. Find Salesforce in the list of available CRMs and click on the "Connect" button.

  3. Follow the instructions presented on the screen to complete the process.

Remember, you will need to have admin privileges on your Salesforce account to successfully establish the connection.

Creating Flows

Locating Flows in Salesforce

To begin working with flows in Salesforce, you first need to locate them within your Salesforce setup UI. To do this, navigate to the setup (by clicking on the gear icon in the top right corner and selecting "Setup") then use the quick find box and type "Flows". Click on the "Flows" link under the "Process Automation" heading.

Creating a Flow

To create a new flow, click on the "New Flow" button in the Flows UI. This will launch the Flow Builder.

In the Flow Builder, you'll want to create an "Autolaunched Flow". This type of flow can be triggered by external systems like Appointlet, without any user interaction.

Adding Variables to Your Flow

The data we send to your Salesforce flows needs to be received by variables that you define. When setting up a new flow, Salesforce will present you with an empty canvas.

In your flow's setup screen, open the toolbox.

Click the "New Resource" button.

In the "Resource Type" dropdown, select "Variable".

In the "API Name" field, enter one of the Variable Names from the table below.

Make sure to also select the appropriate “Data Type” (see table below):

Finally, ensure that “Available for input” is checked:

You can now click “Done” and the variable should now be listed in the toolbox:

You'll need to repeat this process for each variable you want to include in your flow. Note that you don't need to include all variables, just the ones relevant to the actions you want your flow to perform.

Flow Variables

Here's are all the variables that you have access to in your flow:

Variable Name

Data Type

Description

Action_Type

Text

Indicates the type of action that occurred. Will be one of Meeting.scheduled, Meeting.cancelled, and Meeting.rescheduled.

Meeting_ID

Text

Unique identifier of the meeting.

Meeting_Name

Text

Name of the meeting.

Meeting_Start_Time

DateTime

Scheduled start time of the meeting.

Meeting_End_Time

DateTime

Scheduled end time of the meeting.

Meeting_Location

Text

Where the meeting is being held.

Meeting_Conference_URL

URL

URL of the associated web conference, if any.

Attendee_ID

Text

Unique identifier of the attendee.

Attendee_Email

Email

Email address of the attendee.

Attendee_First_Name

Text

First name of the attendee.

Attendee_Last_Name

Text

Last name of the attendee.

Attendee_Timezone

Text

Timezone of the attendee.

Attendee_UTM_Source

Text

UTM Source associated with the attendee.

Attendee_UTM_Medium

Text

UTM Medium associated with the attendee.

Attendee_UTM_Campaign

Text

UTM Campaign associated with the attendee.

Attendee_UTM_Term

Text

UTM Term associated with the attendee.

Attendee_UTM_Content

Text

UTM Content associated with the attendee.

Host_ID

Text

Unique identifier for the host (member who was scheduled for the meeting).

Host_First_Name

Text

First name of the host.

Host_Last_Name

Text

Last name of the host.

Host_Email

Text

Email address of the host.

Adding Custom Form Field Variables

Appointlet's Salesforce integration also gives you the ability to pass data collected via custom form fields into your Salesforce flows. Each form field in Appointlet has an associated API Identifier, which is used to name the variable that contains the form field data.

To locate the API Identifier for a given form field, please see our guide on locating and updating a form field's API Identifier.

In your Salesforce flow, you can add a variable corresponding to this form field using the API Identifier. The variable name will be Attendee_Form_Field_ followed by the API Identifier of the form field. So for the "Company" field, the variable name in Salesforce would be Attendee_Form_Field_company.

Please remember to add all custom form field variables you wish to include in your Salesforce flow, following the process described in the "Adding Variables to Your Flow" section above. Also, ensure you choose the correct data type when adding these variables in Salesforce.

Constructing Your Flow

Building a flow within Salesforce involves a number of decisions and steps that are highly dependent on your organization's specific needs and practices. Since the construction of a flow can be complex and is unique to each user's Salesforce configuration, we are unable to provide an exhaustive guide within this document.

However, Salesforce offers a comprehensive guide on building flows which you can refer to as you build your custom flows. We recommend the following resources:

Remember, the goal of creating a flow is to automate tasks in Salesforce based on the Appointlet data we send over. The variables you added to your flow (as described in the previous section) will be used to capture the data from Appointlet.

Providing the Flow API Name

When you save your newly created flow in Salesforce, you'll be asked to provide a name for it. As part of this process, Salesforce will automatically generate an API name for the flow based on the name you provide. It's this API name that you’ll need to give us so that we can call your flow and pass data to it. Make a note of this name as you will need to enter it into Appointlet's integration settings.

If you've already saved your flow, you can find the Flow API Name by clicking the settings button in the toolbar:

To provide Appointlet with the API name of your flow:

  1. Go to the Salesforce Integration settings in your Appointlet account.

  2. Find the field labeled 'Salesforce Flow API Name' and enter your Flow's API name there.

  3. Save your settings.

This connects your flow to Appointlet and enables the data from scheduling events to be passed into your Salesforce environment.

Remember, each Salesforce flow has a unique API name, so you must provide the correct one to ensure the integration works as expected.

Maintenance and Updates

Over time, we may send new kinds of information that require modifications to your Salesforce flows. We'll notify you of any upcoming changes that could impact your use of the integration. Stay tuned for updates via email.

Support

If you encounter any difficulties or have any questions while setting up or using the integration, don't hesitate to reach out via our support chat. We're here to help!

Did this answer your question?