Your browser does not support JavaScript!

Setup Instructions: ACE Chatbot URL for Property Listings and Email

Follow the instructions below to learn how to set up your own ACE™ Virtual Leasing Assistant chatbot URL for placing on property listings, email, and more.

Last Update:
January 9, 2024
ACE
How-To Guide

Introduction

You can add ACE™ Virtual Leasing Assistant to nearly any website, social media profile, CRM email template, and email signature. To do this, you will need to setup an ACE chatbot URL. Once your URL is set up, you can place it on property listings, Instagram, Yelp, or any website that allows you to place a clickable URL or website link. When your prospects click on the link, it will open ACE ready to chat. Just like when a prospect visits your property website directly, when a prospect clicks to chat via the URL, ACE will answer all their leasing questions, collect guest cards, set appointments, and send you notifications.

Additionally, you can customize your property website URL with parameters. These parameters pass a script to the ACE chatbot, so ACE can begin the conversation from a specific starting point—such as scheduling a tour or providing pricing and availability.

Check out this diagram for a quick overview of how it works:

ACE Chatbot URL - How It Works Diagram

Step 1: Set Up Your URL

Choose one of the implementation options below. We recommend Option 1: Add an ACE Script to Your Property Website URL — it is easy to implement and provides the best user experience for your prospects.

To get started, you will need the ACE chatbot installed on your property website.
  1. Identify the URL of your property website.
  2. Copy one of the ACE scripts below and paste it to the end of the URL of your property website.

    • To Load the ACE welcome greeting use: ?openchatbot=true
    • To load the ACE pricing and availability prompt use: ?chatscript=pricing

    • To load the ACE tour scheduler use: ?chatscript=tour

    • TIP: You can have ACE load any leasing or resident question by simply adding a keyword (e.g., pets, maintenance, etc.) following “?chatscript=” in the URL script.

  3. Your URL should look something like this:
  4. Next, place your URL on any wesbite where you think prospects would like to chat and learn more about your property.

To get started, you will need your ACE chatbot ID. You can find your chatbot ID by either:

  1. Contacting your LeaseHawk Client Success Manager or email support@leasehawk.com.
  2. Or, log in to the LeaseHawk Admin Center.

    • Once you're logged in, go to the Chatbot Style dashboard.
    • Next, scroll down to the section Chatbot Code Snippet for [Property Name].

    • In the code, you will see a 4-digit ID snippet like this, "id="XXXX". Typically, this is in the third line of code.

    • The number shown in the quotes is the chatbot ID for your property.

After you have identified your chatbot ID, follow the instructions below:

  1. Use the URL string below to add your chatbot ID. Add your chatbot ID to the end of the URL where it says, SITEID.
  2. If you would like to customize the background color, use the URL string below to add a HEX color value.
  3. If you would like to further customize your ACE chatbot URL experience, use the optional URL strings below.
  4. Once you are satisfied with your URL parameters, it’s ready to go! Follow the directions in Step 2 below to place your URL on Google My Business, Facebook, Yelp, or any website where you think prospects would like to chat and learn more about your property.

  1. Create a config file with the following values:
  2. Host your file.

  3. In the URL string below, add the file location to the config parameter.

    • https://chat.leasehawk.com?config=https://file-location/congif.json

  1. Follow the instructions in either Option 1 or Option 2 above to create your ACE chatbot URL.

  2. Then, take the ACE chatbot URL and insert into the iframe code snippet below.

  3. Add the iframe code snippet to your website.

  4. Once the iframe is on your website, it’s ready to go! Follow the directions in Step 2 below to place your website's URL with the embedded ACE chatbot iframe by on Google My Business, Facebook, Yelp, or any website where you think prospects would like to chat and learn more about your property.

Step 2: Place Your URL

Follow the instructions below to place your ACE chatbot URL to the property listings, CRM email templates, email signatures, and social media profiles of your choice. Please note, the ACE chatbot URL can be added virtually anywhere that a link can be added, so you may not see instructions below for every possible placement.

  1. Sign into your Google My Business account.

  2. Choose the My Business listing, or property, that you want to edit.

  3. From the left menu, click into the Info section.

  4. Select the pencil icon next to the Website section to edit.

  5. A pop-up will appear, paste your ACE chatbot URL into the Appointment links field.

  6. Click Apply.

Troubleshooting Tips

  • Depending on your business category, you might see the Appointment URL field, or you may not. If you do not see the Appointment URL field, you may request it from Google by submitting a Google My Business support ticket.

  • Changes to your Google My Business page may be reviewed by Google and take up to 3 days to be published. For more information about how Google publishes edits, please read this Google Support document.

  • Some Google My Business profiles must be verified first before edits can be applied. If your profile is not verified, follow this Google Support document to become verified.

There are three options for adding your ACE chatbot URL into a Facebook Page. Choose the option that best fits your business needs.

Call to Action (CTA) Button

  1. Sign into your property’s Facebook Page.

  2. Below your Page’s cover photo, click Add a Button. If you already have a button, click Edit.

  3. A pop-up will appear, select your preferred Button option. We recommend Learn More or Contact Us.

  4. Paste your ACE chatbot URL into the field.

  5. Click Finish to add the CTA button to your Page.

To watch a video of these instructions from Facebook, click here.

Page Description

  1. Sign into your property’s Facebook Page.

  2. Click on the About tab, then click Edit.

  3. In the About field, write 1-2 sentences to help people understand your property.

    • For example: Now leasing apartments in Neighborhood Name, City, State. Luxurious, elevated living.

  4. Save by clicking anywhere outside the text field, then click the x to exit the pop-up window.

  5. Next, click on Add additional information.

  6. In this field, write a more detailed description of your property. This is where you may include the ACE chatbot URL. Be sure to instruct users to click on the link or copy and paste it into their browsers.

    • For example: ABC Apartments is at the heart of one of the most contemporary spots in City, but still possesses that classic sense of community. You’ll discover the city’s best dining and entertainment next door to top cultural happenings. Set trends by night, then enjoy a convenient commute each morning. It all comes together to create a place that you’ll love to call home. Have a question about our community? Chat with our virtual leasing assistant 24/7: https://chat.leasehawk.com/?id=xxxx (click link or copy and paste into your browser to start chatting).

  7. Save by clicking anywhere outside the text field, then click the x to exit the pop-up window.

To watch a video of these instructions from Facebook, click here.

Facebook Post

  1. Sign into your property’s Facebook Page.

  2. Enter your text in the Write a post section.

    • For example: ABC Apartment’s leasing office is closed this Labor Day, but you can still connect with our virtual leasing assistant, 24/7! Chat now: https://chat.leasehawk.com/?id=xxxx

  3. Once you are finished with your post, select Share Now.

To watch a video of these instructions from Facebook, click here.

  1. Log in to the Yelp app and tap More at the bottom of the screen.

  2. Under the Promote section, tap Call to Action to edit.

  3. Pick a Call to Action message; you can choose from the recommended options or create your own. We recommend creating your own, such as: Chat with Us.

  4. Next, choose to send customers to your website and paste your ACE chatbot URL into the field.

  5. Schedule an end date (optional).

  6. Tap Set Call to Action.

To watch a video of these instructions from Yelp, click here.

Provide prospects quick access to leasing, pricing and availability, and appointment inquiries by adding the ACE chatbot URL to your email signature and out of office replies through a clickable image.

Email Signature

  1. Right-click on the image below and select Save Image As... to save the image on your computer. Remember to save it in a location on your computer that you can easily access and safely store.

  2. Open your email service provider (e.g. Outlook, Gmail, etc.) and select Signatures. Typically, this is found in the Preferences or Settings menu.

  3. Insert the image that you saved from Step 1 into your email signature. This is commonly done by clicking on Pictures from your email system's menu and then selecting Picture From File. Be sure to insert the image at the bottom of your email signature for a clean look.

  4. If necessary, resize the image by clicking on the image and dragging it inward to decrease the size or outward to increase the size.

  5. Next, right-click on the image and select Hyperlink. Paste your ACE Chatbot URL into the Address field and click OK.

  6. Click Save and enjoy your new email signature!

Below is an example of what your email signature can look like by following this tutorial:

LeaseHawk CRM Email Templates

  1. Request the CRM Email Template Builder from support@leasehawk.com.

    • Create your email with subject line.
    • Add the ACE chatbot image in the signature.
    • Email back to support@leasehawk.com.
  2. Or, if your CRM email templates are already created and in use:

    • Email support@leasehawk.com and request the ACE chatbot image be added to leasing-specific email templates.

For non-LeaseHawk CRM email templates, provide the ACE chatbot URL and image to your CRM provider's support representative.

Provide prospects quick access to leasing, pricing and availability, and appointment inquiries by adding the ACE chatbot URL to your email signature and out of office replies through a clickable image.

  1. Right-click on the image below and select Save Image As... to save the image on your computer. Remember to save it in a location on your computer that you can easily access and safely store.

  2. From your Gmail inbox, click on Settings in the top-right corner, then select See all settings.

  3. Scroll down to the Vacation Responder section.

  4. Enter your vacation responder details in the body of the email.

  5. Insert the image that you saved from Step 1. This is commonly done by clicking on Pictures from your email system's menu and then selecting Picture From File. Be sure to insert the image at the bottom of your email signature for a clean look.

  6. If necessary, resize the image by clicking on the image and dragging it inward to decrease the size or outward to increase the size.

  7. Next, right-click on the image and select Hyperlink. Paste your ACE Chatbot URL into the Address field and click OK.

  8. Click Save.

Below is an example of what your out of office reply can look like by following this tutorial:

Add a "Chat with Us" button to your Knock CRM auto-reply emails. This allows your prospects to immediately chat with ACE without having to wait for an email reply from your leasing team.

  1. Contact your Knock CRM support representative.

  2. Request for a new Knock button labeled, "Chat With Us" to be added to your Email Auto Response.

  3. Provide your Knock CRM support representative with your ACE chatbot URL(s).

Below is an example of what your email autoresponder can look like by following this tutorial: