**This article is for users with System Administrator profiles or a profile with Customize Application permissions.
In order to setup the integration with Buildout, follow the steps below.
- Obtain your API Keys from Buildout Support.
- Enable the integration in Apto Settings.
- Add the Publish link to the Listing page.
Detailed instructions below.
Obtain Buildout API Keys
If you do not have Buildout API keys, please contact the Buildout Support Team and mention the Apto-Buildout integration.
The Buildout Support Team will explain the process for initiating the integration from Buildout.
Customer Service: email@example.com
Enable The Integration
- Click the App Launcher ("" symbol) located in the top left corner of your screen next to your “Home” tab. Select the Settings tab which is listed in alphabetical order in the All Items list.
- Under the INTEGRATIONS section on the left hand side panel, click “Buildout Settings”.
- Click Edit on the top section and enable the integration.
- Check Run Daily to activate a daily batch job that syncs Listings marked for publishing (more details in the next section).
- In the API Keys section, click the Edit button. Enter the API Keys provided to you from Buildout.
- Check Public check box if one key is shared among multiple brokers. In other words, one Buildout login is used by multiple brokers.
When done, it should look something like this:
Sharing API keys
The keys are marked public when the public check box is checked.
When should I set keys to public?
- When the entire org shares the keys.
- When there are no privacy settings.
When should I set keys to private?
- Each broker has their own personal instance of Buildout.
Skip this section if your org decides to keep the keys public and visible to all the brokers.
If a key is not marked public, it is owned by the user that creates it. In most cases, it is the system administrator. It should be shared to the corresponding brokers in order for them to use that key to publish the listing.
- Go the Buildout Settings tab, identify the key that you would like to share and hit Share this Key link next to it.
- Click Add.
- Select the user or group that you would like to share the key.
4. Click Save.
Enable The Publish Button
If you have never enabled another publishing integration, you may need to add the Publish button to your listing pages.
- Open a Seller Representation listing in your Apto org.
- Click the Setup icon () in the top right corner of your screen. Select Edit Object.
- On the left menu panel, click on Page Layouts (3rd option down). Select the Listings Layout Page Layout from the list of available layouts.
- Scroll to the Salesforce1 & Lightning Actions option in the top panel.
- You should see an available Publish button. Drag and drop that button into the Salesforce1 and Lightning Experience Actions panel.
- Click Save.
Applying Additional Mappable Fields to the Apto Property Page
In order to enter in additional data surrounding lease/sale information (such as a sale description or sales/lease advertising language), you will need to add a few fields to the property page layouts that will be syncing with Buildout.
We have 11 out of the box property types. To add the fields Lease Title, Lease Description, Lease Bullets, Auction, Sale Title, Sale Description, Sale Bullets and YouTube URL to these property records, please follow the steps below.
- Navigate to Properties and select a property record (any will work).
- Then click the setup icon on the top right corner of the page. Select Edit Object.
- Click on Page Layouts (located on the left side panel of your screen). For further help on configuring page layouts, see here.
- Select the Page Layout you wish to add these fields to.
- Drag and drop these fields from the list of available fields (top of the page in a blue box) into an area of your choice on the property page layout.
- Click Save (located at the top left corner of the page).
- Repeat the process (steps 1-6) for any other additional property types in Apto that you want to add these fields to.
These newly-added fields are now ready to accept your data and be transferred in the sync process between Apto and Buildout… YAY!