Who can use this feature?
Creating a button on the page layout to launch Chili Piper's ChiliCal is an easy way to take advantage of Chili Piper inside Salesforce.
While "Links" can also be created and used in some situations to book or share via email or API, this article will focus on the instructions for creating a Custom Button within Salesforce Setup that loads ChiliCal and/or Handoff.
It is also possible to use a Salesforce Screenflow to load Chili Piper, should you need the User to take some action or update fields before the User loads Chili Piper to book a meeting. The URLs for the buttons listed below will also work and be supported via Screenflows.
This article is dedicated to users who have migrated and are working with our Demand Conversion Platform instance. If you are still a Legacy user, check this article instead.
Once set, the end-user must have a logged-in session with Chili Piper access to the Scheduler's Interface.
Table of Contents
Creating a Salesforce Custom Button
- Navigate to "Object Manager" in Salesforce Setup
- Search for the Object you wish to create the button
- Click Into "Buttons, Links, and Actions" → "Add Button or Link"
- Name the Label, add a description (optional), and select the following:
- Display Type: "Detail Page Button"
- Behavior: "Display in a new window"
- Content Source: "URL"
Choose the Correct URL to add to Salesforce
Chili Piper requires one of three types of values from within Salesforce to find an email address to be able to schedule a meeting on the calendar:
- Lead Id
- Contact Id
- Email Address
Chili Piper accepts both 15-digit and 18-digit Salesforce IDs for passing the value. Differently from Legacy, the URLs below can be used to open the ChiliCal's and Handoff's Scheduler, as you can switch between both in the Demand Conversion Platform.
Click the articles below to learn more about the above-mentioned Schedulers:
Now, let's check the URLs that can be added to Salesforce per object:
Lead Object
https://fire.chilipiper.com/chilical-scheduler/?crmRecordType=Lead&crmRecordId={!Lead.Id}
Example:
Contact Object
https://fire.chilipiper.com/chilical-scheduler/?crmRecordType=Contact&crmRecordId={!Contact.Id}
Example:
Route by and Relating to Opportunity and Case
Opportunity Object
https://fire.chilipiper.com/chilical-scheduler/?crmRecordType=Contact&crmRecordId={!Opportunity.Primary_Contact__c}&opportunityId={!CASESAFEID{Opportunity.Id}}
In this URL, we are using a custom Lookup(Contact) field called "Primary Contact" - {!Opportunity.Primary_Contact__c} to book a meeting. A Primary Contact must be defined on the Opportunity to be able to schedule a meeting.
You may have different naming conventions for your field(s) in Salesforce and need to adjust the merge tag to ensure a Contact Id gets populated in the URL from the Contact you wish to book a meeting with.
Case Object
https://fire.chilipiper.com/chilical-scheduler/?crmRecordType=Contact&crmRecordId={!Case.ContactId}&caseId={!CASESAFEID(Case.Id)}
Example:
Add the button to the layout
Once your Custom Button is created on the respective Object, the next step is adding the Button to the Salesforce Page Layout so that End Users are able to access and click on the Button to load Chili Piper.
- Now that the Custom Button is available in Custom Buttons, navigate to a real Opportunity record, click the Gear Icon on the page → "Edit Page"
2. Click into the "Highlight Panel", then click "Add Actions" on the Right Panel, search for the name of the Button that you created, and Add it to the Page
Note: Salesforce Lightning Page Layouts have a maximum amount of 10 Visible Action Buttons
3. Click "Save" in the top right and your Custom Button to book meetings will be Live.
Visualize Page
When you click the Button, you should expect to see the Chili Piper's Scheduler open using the Name and Email Address of the respective Lead or Contact you are booking.