Skip to main content

Hello, how can we help you today?

Or select a category below
Getting Started
Videos

How to configure a unique per-user calendar booking link

  1. Exclaimer Knowledge Base
  2. Solutions
  3. Features
Ari Flavell
  • Updated

Scenario

You are using the Calendly element, Microsoft Bookings element, or Chili Piper element in your signature, and you want this to change the calendar link used based on the sender. For example, the signature is used for all the members of a department, but each member needs to send their individual Calendly or Microsoft Bookings calendar.

Resolution

Calendar elements use URLs to connect calendars to your signature. You can create user-specific calendar URLs by creating dynamic hyperlinks, which replace part of the URL with user-specific information. The static part of the link stays the same, and the dynamic part of the link makes it unique to the user.


For example, a Microsoft Bookings link may read:

https://outlook.office.com/bookwithme/user/[bookings ID]@[domain].com/?anonymous&ep=plink

The static part of the URL would be

https://outlook.office.com/bookwithme/user/ 

and the dynamic part of the link would be

[bookings ID]@[domain].com/?anonymous&ep=plink

To create a dynamic hyperlink for calendars, store the dynamic data in one of the following ways:

  • In a custom attribute
  • In the User Details Editor
  • In Exclaimer via a CSV upload - either by manually downloading a CSV of user data and reuploading it, or by using a Powershell script to generate a CSV (Global Administrator permissions are required). 

Then, add your calendar element to your signature and populate your hyperlink with the static part of the URL, then the dynamic part via fields. The fields draw the dynamic data from where it is stored.

To create and use a dynamic calendar hyperlink

Select an option below to view the related instructions:

Create and add a link using custom attributes
NOTE: For instructions on how to create and populate custom fields for Active Directory, Microsoft 365, Microsoft Entra ID or Google Workspace, see How to add custom fields to your signature.
  1. In your chosen directory, select or create a custom attribute field for your data. Ensure that you use the same attribute field for every user.
     
  2. Enter your user-specific section of the URL (in the format [bookingID@[domain].com) and save the attribute.


    The user-specific section of the URL is stored in the custom field when creating a part-dynamic hyperlink.
      
  3. Perform a manual data synchronization to synchronize these details.
     
  4. Open your signature in the Signature Designer.
     
  5. Add the required calendar element to the signature. For more information, see Working with the Calendly element, Working with the Microsoft Bookings element, or Working with the Chili Piper element.
     
  6. In the Booking page URL text box, add the static part of the URL.


    A Microsoft Bookings window. The static half of the example URL ends at 'user/'. The dynamic half is added after the '/'.

     
  7. At the end of the static part of the link, enter { and begin typing the name of the custom attribute field which stores the dynamic data. Select the correct field from the autofill drop-down.


    Select your new field from the autofill list.

     

  8. Select OK to close the element window and select Save Changes to save your signature template. Your Booking page URL now directs recipients to the unique link.

    Tip! You can use Visibility properties on the calendar elements so that the element only becomes visible if the field containing the dynamic part of the booking link is populated. For more information, see how to use Conditional Visibility.
Create and add a link using the User Details Editor
NOTE: The number of editable fields available in the Editor depends on which pricing plan you have.

The Starter plan does not have access to the user-editable contact details.

The Standard plan has access to two editable contact fields.

The Pro plan and any Marketing Cloud subscriptions purchased before April 2023 have acces to an unlimited number of editable fields. For more information on pricing plans, see Exclaimer Pricing Plans.

User Details Editor (UDE) fields cannot be renamed, but you can create a custom attribute to control field names.
 

  1. Sign in to the User Details Editor as a Microsoft 365 Global Administrator or Google Super Admin.
     
  2. Select Settings.
     
  3. Enable an attribute to store the dynamic data in. For more information, see Manage settings for user editable contact details.


    The Settings page. Select a checkbox to enable an attribute.
     
  4. Select Save Changes.
     

  5. Return to the User Details Editor by selecting Contact Details and enter the dynamic section of the booking link in the designated attribute field.

    Tip! End-users can enter their own data in the UDE. For more information on how you can enter your own data, see Manage your contact details.


    The UDE page. Enter your data in the attribute enabled for it. This example shows the dynamic part of the URL in User Defined 1.

     

  6. Select Save Changes.
     
  7. Open your signature in the Signature Designer.
     
  8. Add the required calendar element to the signature. For more information, see Working with the Calendly element, Working with the Microsoft Bookings element, or Working with the Chili Piper element.
     
  9. In the Booking page URL text box, add the static part of the URL.


    A Calendly window. The static half of the example URL ends at 'user/'. The dynamic half is added after the '/'.
      
  10. At the end of the static part of the link, enter { and begin typing the name of the custom attribute field which stores the dynamic data. Select the correct field from the autofill drop-down.


    Select your new field from the autofill list.
     

  11. Select OK to close the element window and select Save Changes to save your signature template. Your Booking page URL now directs recipients to the unique link.

    Tip! You can use Visibility properties on the calendar elements so that the element only becomes visible if the field containing the dynamic part of the booking link is populated. For more information, see how to use Conditional Visibility.
Create and add a link by manually updating a CSV
NOTE: The User Details Upload feature is only available for users on Standard or Pro plans. For more information on pricing plans, see Exclaimer Pricing Plans. 

This method allows an Exclaimer admin to upload a CSV file containing the user's booking links. For more information, see User Details Upload. You must add each user's booking link to the appropriate column in the CSV - for a bulk method, see the Create and add a link by genering a CSV with Powershell section of this article. 

  1. From the header bar, select the cogwheel icon to open the Settings menu, then select Sender Management.


    The Settings menu is found under the cogwheel icon.
     
  2. Locate the User Details Upload section and select Export Existing to export a CSV file of your existing users and their current override data.


    The User Details Upload section is found on the Sender Management page. You may need to scroll.
     
  3. Open the CSV file in an appropriate program, such as Microsoft Excel.
     

  4. In the first empty column, enter text in the topmost cell to act as a column header. This will be the name of your field for storing the data.

    NOTE: Headers must start with a letter. Full stops (.) and underscores (_) are the only special charcters permitted; all other characters must be alphanumeric.
    Any mismatched header names will be treated as new columns.


    A CSV opened in Microsoft Excel. A new column header has been added for booking links.
     

  5. Populate the cells in the coloumn with the dynamic part of the booking data for each user as required.


    Add the unique section of the dynamic booking link in the new column for each respective user row.
     
  6. Save the CSV file.
     
  7. Return to the Sender Management page in Exclaimer. Under User Details Upload, select Update Existing, then select and open the updated CSV file to import the data.


    The Update Existing button is found in the User Details Upload section.
     
  8. Open your signature in the Signature Designer.
     
  9. Add the required calendar element to the signature. For more information, see Working with the Calendly element, Working with the Microsoft Bookings element, or Working with the Chili Piper element.
     
  10. In the Booking page URL text box, add the static part of the URL.


    A Calendly window. The static half of the example URL ends at 'user/'. The dynamic half is added after the '/'.
      
  11. At the end of the static part of the link, enter { and begin typing the name of the custom attribute field which stores the dynamic data. Select the correct field from the autofill drop-down.


    Select your new field from the autofill list.
     

  12. Select OK to close the element window and select Save Changes to save your signature template. Your Booking page URL now directs recipients to the unique link.

    Tip! You can use Visibility properties on the calendar elements so that the element only becomes visible if the field containing the dynamic part of the booking link is populated. For more information, see how to use Conditional Visibility.
Create and add a link by generating a CSV with Powershell (Microsoft 365 users only)

This method allows an Exclaimer admin to upload a CSV file containing the user's booking links. For more information, see User Details Upload. The CSV is generated by running a Powershell script to export all the dynamic booking IDs in bulk.

NOTE: You must have Microsoft 365 Global Administrator credentials for this solution.
  1. Open Windows Powershell.
     

  2. Enter and run the following script: 

    Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/exclaimerltd/Internal-Support-Scripts/master/MSBookingGuid.ps1" -OutFile "$env:TEMP\MSBookingGuid.ps1"; & "$env:TEMP\MSBookingGuid.ps1"
  3. When prompted, sign in to Microsoft 365 using your Global Administrator credentials. Once signed in, you are returned to Powershell. 
     

  4. You are prompted to answer the query Do you want to limit the export to members of a specific group?
    EITHER:

    Enter Y to only export the booking links for users in an existing group. Enter the group email address on the following line.

    OR

    Enter N to export the booking links for all users. 
      

  5. Press Enter to generate the CSV file. 
     
  6. Log into your Exclaimer subscription. From the header bar, select the cogwheel icon to open the Settings menu, then select Sender Management.


    The Settings menu is found under the cogwheel icon.
     
  7. Under User Details Upload, select Update Existing, then select and open the updated CSV file to import the data.


    The Update Existing button is found in the User Details Upload section.
     
  8. Open your signature in the Signature Designer.
     
  9. Add the required calendar element to the signature. For more information, see Working with the Calendly element, Working with the Microsoft Bookings element, or Working with the Chili Piper element.
     
  10. In the Booking page URL text box, add the static part of the URL.


    A Calendly window. The static half of the example URL ends at 'user/'. The dynamic half is added after the '/'.

     

  11. At the end of the static part of the link, enter:

    {MSBookingGUID.

    Select the corresponding field from the autofill drop-down.
     

  12. Select OK to close the element window and select Save Changes to save your signature template. Your Booking page URL now directs recipients to the unique link.

    Tip! You can use Visibility properties on the calendar elements so that the element only becomes visible if the field containing the dynamic part of the booking link is populated. For more information, see how to use Conditional Visibility.