Adding a New Portal Lead Source

Front Desk, a service developed by Propertybase, allows you to capture leads from several online real estate portals. However, there are still many portals that are not supported (yet!) or you are a first time client where no mapping has been created yet. This article will explain the steps necessary connect to a new portal and start importing leads into your Propertybase account.

Note: You must enable Front Desk before you can capture portal leads.
Please use Webforms to connect your website or landing page forms!

1. Send First Test Lead

First, you need to send a test lead to your unique Front Desk email address. Instructions for locating that address can be found here. To do this, update the main contact email on the portal to your Front Desk address. Then send a test lead by filling out the entire inquiry form on the portal website.

Note: You must fill out every single available inquiry field on the portal form.

By filling out every field on the form, you are sending the most data possible to our Customer Support Team. This allows them to identify and map every available portal field to existing fields in your Propertybase account. Alternatively, having missing fields will result in errors when a potential lead fills them out in the future.

When entering a test lead, make sure to use information that is easily identifiable as test data. See the table below for example entries:

Form Field Name Example Test Data
First Name FIRSTNAME_TEST
Last Name LASTNAME_TEST
Email FRONTDESK_TEST@example.com
Phone 1234567890

By using entries like the examples above, you will help our Support Team immediately recognize the incoming lead as a test. By using a different, unique test lead email address, you can force contact creation. If a email address is already in your database, Front Desk will skip to inquiry creation for that message.

Note: You must update the main email address on the portal to your Front Desk address when sending the test lead. Simply forwarding a test lead email from a separate inbox to your Front Desk address will not work.

2. Contact Support

Once the test lead has been created, submit a new support request with the following information:

  • Explain that you just created a test lead on a new portal.
  • Include the name of the portal.
  • Include your unique Front Desk email address.
  • Explain that you would like the test lead checked for parsing.

Once your request has been received, our Support Team will look for the test lead. Once found, they will identify whether or not a new parser needs to be created. If a parser already exists, the Support Team will configure your account to start receiving leads immediately. If a parser does not exist, our Support Team will notify you that one needs to be created, and provide a estimated time for completion.

If our Support Team needs to create a new parser for you, they may need you to send several additional test leads to test the parser is working correctly. If this is the case, make sure to change the "from" email address for the test lead each time. For example: FRONTDESK_TEST_2@example.com, FRONTDESK_TEST_3@example.com, FRONTDESK_TEST_4@example.com, etc.

3. Mapping Portal Fields

The final step in configuring a new portal integration is mapping external portal fields to their Propertybase counterparts. Standard fields like "first name", "last name", "phone", "bedrooms", etc. are easy to map. However, some fields are unique to your brokerage or may not exist in Propertybase. When this is the case, our Support Team will work with you to create necessary fields and map them correctly. This may take several back-and-forth correspondences between you and our Support Team. We will provide you with a mapping table that you can use to cross-check and inform us about amendments. 

Notes on mapping fields

We have some more default fields and best practices that we will also try to populate right from the start:

Lead Source

%{meta.source}

Best practice: ask us to map it to both, contact AND inquiry (request). This will allow you to capture where re-inquiries of existing contacts come from. Note: there is not default field on inquiry for this. Please create one.

We normally use meta information to provide the lead source name. If you want something else, it will either have to be in the portal's message content or you need to use a process builder field update rule to change the value Front Desk hands over to your desired version.

Technical Source

You can use a hidden field named "Technical Source" to identify messages (contacts/inquiries) processed by Front Desk. The field is a text field that will be populated with "FrontDesk". The field is on contact and request named  (search for "technical" on the objects fields & relationships)

pba__TechnicalSourceSystem__c

If you don't find that field "Technical Source", simply add it to contact and inquiry (request), so the API name looks like this after creation:

TechnicalSourceSystem__c

Then let us know that you want us to map e.g. contact.TechnicalSourceSystem__c and request.TechnicalSourceSystem__c for you in FrontDesk. 

You would use this e.g. in filtered list views or reports to find new leads created by FrontDesk.

 

FAQs

Missing Information or Incorrect Field Mapping

If information is missing from leads or appearing in the wrong fields, this is most likely due to a change in the format that the portal sends to Front Desk. It could also be an issue with the Front Desk parser. If this is the case, please submit a new support request with the following information:

  • The name of the contact in your Propertybase account
  • The email of the contact in your Propertybase account
  • The time and date that the lead was received
  • The name of the portal that sent the lead
  • Any error messages (if applicable)

Once the information above has been received, our Support Team will work to resolve the issue.

Portal Lead Source Naming not as desired

The lead source is defined and hard-coded in our backend. If you don't like it, you can set the value you'd prefer by updating the records on creation with a Process Builder field update on "Lead Source", e.g. with a formula like this:

IF
(TEXT(LeadSource) = 'PortalName', 'My Custom Value',
IF
(TEXT(LeadSource) = 'Zoopla.com', 'Zoopla',
IF
(TEXT(LeadSource) = 'Immoscout24', 'IS24.de',
IF
(TEXT(LeadSource)='habitaclia.com', 'Habitaclia',
IF
(TEXT(LeadSource) ='portal name', 'another value for it',
IF
(TEXT(LeadSource)= 'Dubizzle', 'My local portals',
IF
(TEXT(LeadSource)= 'tucasa.com', 'Tu Casa',
TEXT(LeadSource))))))))

The formula above checks the picklist field for the first value and replaces it with the second.

"LeadSource" would be the lead source field you use (this example field is on contacts, your field on requests/inquiries will look different, perhaps Lead_Source__c). You need a line for each value you want to replace, not for the ones that can remain. The final line says "and in all other cases take what you have".

You can use this field update on pretty much every value you want to adjust (e.g. Listing/Request Type on Request/Inquiry).

Using Multiple Portals

If you would like to setup more than one portal, start by sending a list to our Support Team. They will help you identify which are already available (if any) and work to formulate a plan for integrating each portal.

Forwarding Leads to Front Desk

We highly recommend against forwarding leads to Front Desk. When you forward an email, the underlying source text changes the format of the email (even if it appears visually the same.) Always setup your real estate portal to forward leads directly to Front Desk.

Creating Linked Listing

Front Desk can also create a Linked Listing, linking the inquiry, the contact and the listing the lead requested from. This is only possible if the portal lead message also contains the unique reference number you have for the listing (aka MLS ID/Broker's Listing ID). If not present, the creation will be skipped. If you want Linked Listings to be created, please let Propertybase Support know to activate this service. You can have it turned off again any time you like.

Creating an Email Task containing the lead message

Front Desk can create a task, linked to the contact and if present to the inquiry. The Task contains the text-only version of the portal message. If you want Tasks to be created, please let Propertybase Support know to activate this service. You can have it turned off again any time you like.

Contacting Propertybase Support

Whenever you contact Propertybase Support, remember to grant them access to your Propertybase account. This makes resolving your request much easier.

Locating Your Front Desk Email Address

Once you have enabled Front Desk, your unique email address can be located at the bottom of the same activation page. Click here for more info.

 

Powered by Zendesk