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, Case, or Custom Object
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:
Custom Object
https://fire.chilipiper.com/chilical-scheduler/?crmRecordType=Contact&crmRecordId={!Custom_Object__c.Contact_Id__c}&objectId={!Custom_Object__c.Id}
Once you have a Contact Id or Email Address available on the Custom Object Record, you can use a tag like {!Custom_Obj.Contact__c} where "Custom_Obj" is your object name and "Contact__c" is the custom field name. These names will vary depending on how you set them up.
If you have multiple custom object records related to the Lead/Contact, you will want to also pass one additional parameter customObjectId={!Custom_Obj.Id} so that Chili Piper knows which of the Related Custom Object Records to route against your Rules.
Items to Note:
-
This will relate the SFDC event to whichever record is passed (it may route based on it too, if you've set up custom object matching and rules)
-
You can use this interchangeably with the opportunityId or caseId (ie, you can pass it an Opportunity Id value and it'll work). However, it's recommended to use the respective one for those objects.
-
You wouldn't use both objectId and opportunityId together in the URL; you would use either one or the other.
-
Setting this objectId value will override whatever settings are configured within the App CRM Actions or Handoff Router settings.
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.
Comments
0 comments
Please sign in to leave a comment.