The information contained in this document is confidential, privileged, and only for the use of internal Birdeye users. This document may not be used, published or redistributed.
This integration is supported for both SMB & Enterprise businesses.
Integrating Birdeye with Rent Manager
User Manual - SUPPORT ARTICLE
Rent Manager is a property management software which caters to the needs of both commercial and residential real estate companies. The deeply integrated software solution offers features including billing and invoicing, expense management, contact management, budget management, financial reporting, etc.
Birdeye can seamlessly integrate with your Rent Manager account and send out review solicitations to your customers automatically. Integrating Rent Manager with Birdeye will automate the process of sending out review requests to your customers on a daily basis.
Table of Contents
Triggers Details
Rent Manager company ID
Activation From Client’s End
Enterprise ID for a multi-location account and Business IDs for all locations
Business ID in the case of an SMB business
Login
Manage Triggers
Manage Properties
Manage Locations
Create Integration Group
Fetch information for all the triggers
Find business integration group details
Update Trigger Information
Integration Mapping
How it works - (Location support based on only location id)
How it works - (Location support based on ‘Property name’)
Integration Requirements
Supported triggers,
Birdeye allows you to fetch data from your CRM using some predefined triggers. You can choose any combination from the list of available triggers and inform the support team about your selection. Here are the supported triggers for Rent Manager:
Trigger Display Name | Trigger Name/Value | Trigger Description |
Rent Manager Move In Trigger | Move In | This trigger is used to fetch customer data based on the move into the property. |
Rent Manager Move Out Trigger | Move Out | This trigger is used to fetch customer data based on the move out of the property. |
Rent Manager Closed Service Request Trigger | Service Request | This trigger is used to fetch customer data based on the closed service request. |
Information required from the Birdeye client
Triggers Details
Rent Manager company ID
Activation From Client’s End
Information required from Birdeye Dashboard
For single location SMB account - Business ID
Login to your Birdeye account, go to Left Navigation Rail and click on ‘Settings’. Once the new page appears, click on ‘Integrations’ and select ‘API.’
You will find the ‘Business ID’ and ‘API key’ shown in the image.
For multi-location accounts - Enterprise ID and Business IDs of all locations
Enterprise ID
Business IDs of all locations
Login to your Birdeye account, go to Left Navigation Rail and click on ‘Settings’. Once the new page appears, click on ‘Profile’ and select ‘Business Profiles.’
To view Location ID, hover over the ‘Status’ of location.
Integration Process
Before you can integrate Rent Manager with Birdeye, you will need to set up the following configurations on the integrations support dashboard:
To set up native integration, we have an integration support dashboard, where we need to set up the integration and then follow these steps to complete the configuration.
Login
After successful login in the integration dashboard, you have to click on ‘BE integration’ and then click on ‘Add Integration’.
Search for the CRM in the search bar and select it. Click on ‘Next’.
Manage Triggers
Select the Trigger Name (Check Box) as per the client’s requirement and click ‘Next.’
Note: To fetch information for all the triggers available using curl commands, use this command. To replace triggers, use this curl command.
Manage Properties
Here; you can manage group-level properties, which will be applied to all locations under a CRM.
Customer Fetch Delay: It is used if businesses want to send review requests with a delay (number of days). You can set a delay or leave it blank and click ‘Next.’
Note: This step will create a group for our integration. Alternatively, you can do it via curl commands.
For SMB accounts, you can access the curl command.
For Enterprise accounts, you can access the curl command.
Manage Locations
For Single Location/Multi-Location Accounts, select the drop-down and click on ‘Add.’
(In the case of Single Location accounts, it will give you only one option).
A drawer will appear on the right-hand side.
The Status, Frequency and Next RunTime will be set by default. You can make changes if required.
Status: It shows the integration status (Active or inactive).
Frequency: The number of times integration will sync with CRM (Days or Hours).
Next RunTime: The next scheduled time is when the integrations will run.
Location id: RentManager location id.
Property Name: To set up a multi-location account based on property names within the location, then define this property; otherwise, leave it blank. Use pipe(|) separated values to specify more than one value.
Customer fetch delay: It is used if businesses want to send review requests with a delay (number of days).
NOTE: For Multi-location, pass the Location Name after the AccountID provided by the client, such as 104323:Espire. The valid format is Account id: Location Name. Remember to provide the colon(:) as a separator. This format is supported when
You are setting up a multi-location business, so there would be more than one location in the client’s Rent Manager.
If you are setting up an SMB account and the client’s Rent Manager has more than one location, and we only want to fetch customers of one Rent Manager location.
Override Group Properties: With this, you can override the Customer Fetch Delay property added at the group level, specific to each location.
Click on ‘Next’ and click on ‘Save.’
Note: For SMB and Enterprise, you can use ‘manage the locations’ using this curl command.
Curl Commands
Before you can integrate Rent Manager with Birdeye, you will need to set up the following configurations:
A business integration group is a configuration that supports the business hierarchy of individual businesses on the Birdeye platform. The properties that are common for all business integrations are entered at the group level. Setting up a business integration group allows you to associate multiple business locations with the Enterprise account. Below is the list of curl commands that you will need to run to set this up.
Create Integration Group (Curl Command)
Copy this Curl Command
curl -X PUT
https://common-services.Birdeye.com/integration/add/businessintegrationgroup -H 'Cache-Control: no-cache' -H 'Content-Type: application/json' -d '{"parentBusinessNumber" :150088776180458,"integrationSourceId" : 15,"integrationGroupTriggers":[{"triggerId":15,"triggerTypeId":1}],"integrationGroupProperties" :[{"propertyKey" : "companyId","propertyValue": "Birdeye"},{"triggerId":15,"propertyKey" : "customer.fetch.delay","propertyValue": 10},{"triggerId":19,"propertyKey" : "customer.fetch.delay","propertyValue": 12},{"triggerId":20,"propertyKey" : "customer.fetch.delay","propertyValue": 5} ]}'
150088776180458 - Business ID - This is Enterprise ID for multi-location account and Business ID for a single location SMB account.
15 & 20- Integration Trigger ID - Can be one or more triggers. Ask business what trigger they would like to integrate with and then run the curl command below to fetch all possible triggers for Rent Manager. Identify the trigger ID(s) and insert (use commas) in case of multiple trigger IDs.
12, 10, 5 -fetch.delay - Will be shared by the customer on the initial setup call for each trigger.It depicts that after how many days review requests need to be sent for each trigger.
Birdeye - Company ID - Will be shared by the customer on the initial setup call.
NOTE: We will get the group ID once we run the first curl (Integration Group) and make a note of group ID as that will be required while we will be doing the integration mapping.
Fetch information for all the triggers available for Rent Manager (Curl Command)
Copy this Curl Command
curl -X GET https://common-services.Birdeye.com/integration/trigger/integrationtriggers/sourceid/15 -H 'cache-control: no-cache' -H 'content-type: application/json'
Sample response: A sample response like this (see below) will appear after you run the curl command. The response will have the trigger name, description and the ID. This trigger ID will be utilized while creating the integration group. An integration can have one or more triggers. To use more than one trigger, enter comma separated values while creating the integration group.
[{"id": 15,
"integrationSourceId": 15,
"triggerService": "rentManagerMoveInTriggerService",
"displayName": "Rent Manager Move In Trigger",
"description": "This trigger is used to fetch customer data based on move in to the property",
"active": true,
"integrationSourceName": "Rentmanager",
"integrationTriggerType":[{"id":1,"name":"JOB"}]
},
{"id": 19,
"integrationSourceId": 15,
"triggerService": "rentManagerMoveOutTriggerService",
"displayName": "Rent Manager Move Out Trigger",
"description": "This trigger is used to fetch customer data based on move out from the property",
"active": true,
"integrationSourceName": "Rentmanager",
"integrationTriggerType":[{"id":1,"name":"JOB"}]},
{"id": 20,
"integrationSourceId": 15,
"triggerService": "rentManagerClosedServiceRequestTriggerService",
"displayName": "Rent Manager Closed Service Request Trigger",
"description": "This trigger is used to fetch customer data based on the closed service request",
"active": true,
"integrationSourceName": "Rentmanager",
"integrationTriggerType":[{"id":1,"name":"JOB"}]}]15, 19, and 20 - Trigger IDsFind business integration group details (Curl Command)
Copy this Curl Command
curl -X GET https://common-services.Birdeye.com/integration/businessintegrationgroup/149581663020602 -H 'Cache-Control: no-cache'
149581663020602 - Business ID: Enter the Business ID here to get the integration group ID for the business.
Sample Response
[
{
"groupId": 142,
"integrationSourceType": {
"id": 15,
"integrationSource": "RENTMANAGER",
"sourceCategory": "Real Estate",
"oauthEnabled": false
},
"integrationGroupTriggers": [
{
"triggerId": 15,
"triggerTypeId": 1
}
]
}]142 - Group ID: A group ID will be returned in the sample response with the details of the existing triggers for the business.
Update Trigger Information (use only if business wants to change) (Curl Command)
Copy this Curl Command
curl -X POST 'https://common-services.Birdeye.com/integration/update/businessintegrationgroup?replaceTriggers=true' -H 'cache-control: no-cache' -H 'content-type: application/json' -d '{ "groupId": 142,"integrationGroupTriggers":[{"triggerId":15,"triggerTypeId":1},{"triggerId":19,"triggerTypeId":1}]}'replaceTriggers=true - To replace existing trigger(s), enter the value for replaceTriggers as To add new trigger(s) to the existing list, the value for replaceTriggers should be false
142 - The Group ID that was returned in the previous step will be entered here.
19 & 15- Enter the Trigger ID(s) that need to be added or updated to the integration.
Business Integration Mapping
This configuration is developed to create the actual business integration mapping. Each business integration mapping corresponds to an individual business location.
How it works - (Location support based on only location id)
Copy this Curl Command
curl -X PUT https://common-services.Birdeye.com/integration/add/businessintegrationmapping -H 'Cache-Control: no-cache' -H 'Content-Type: application/json' -d '{"businessNumber": 151980725935863,"active": true,"integrationGroupId" : 25,"integrationProperties":[{"propertyKey" : "locationid","propertyValue": "1"}]}'How it works - (Location support based on ‘Property name’)
Copy this Curl Command
curl -X PUThttps://common-services.Birdeye.com/integration/add/businessintegrationmapping -H 'Cache-Control: no-cache' -H 'Content-Type: application/json' -d '{"businessNumber": 151980725935863,"active": true,"integrationGroupId" : 25,"integrationProperties":[{"propertyKey" : "locationid","propertyValue": "1"},{"propertyKey" : "property.name","propertyValue": "palo alto | dallas"}]}'151980725935863- Business ID- Enter the Business ID here.
25 - Group ID- Enter the Group ID that was returned when the Integration group was created.
1 - Location ID - Location name will be provided by the client. Based on the Location name, we will get the corresponding Location ID as described below.
palo alto|dallas - Property Names - Property names will be provided by the client. Based on the ‘Property names’, Birdeye will fetch the tenant details only for mentioned properties within the given location.
IMPORTANT:
Multiple property names should be separated by pipe symbol (|).
To find the Location ID, refer to the section below. For a single location account, the default value of ‘Location ID’ should be ‘1’.
Finding the Location ID,
The Location ID can be found for a business using the Inspect Element tool on the browser. Go to the login page, and right-click on the location. From the drop-down menu, click on the ‘Inspect’ button. In this case, the location ID for ‘Palo Alto’ will be 3.
NOTE: The login URL for the Rent Manager business will be - https://xyz.api.rentmanager.com/Help/Login, where xyz is the company ID.
In case, the location ID, is not available with the client, you can hit the curl command to fetch the location ID.
Copy this Curl Command
curl --location --request GET 'https://{companyId}.api.rentmanager.com/Locations'
--header 'X-RM12Api-PartnerToken: 4f51a0e6-8c30-4234-b1f4-c339c742ccdd'To execute this curl login to the remote desktop -
IP - 10.51.13.199
User - Administrator
Password - Birdeye@123
Finding the Rent Manager company ID
The company ID for the Rent Manager can be found in the login URL provided to you by Rent Manager.
Example: In the URL on the login screen below 'Birdeye.api.rentmanager.com', the company ID would be 'Birdeye'.
Activation From Client’s End
While you are on the integration setup call, you may ask for a specific time delay in sending review requests for any or all of the three different cases - move in, move out and service request completion. You may also specify the desired review request/survey email template (configured in your Birdeye account) that will be used to send review/survey requests once the integration is complete. After the Birdeye support team confirms the integration, you need to perform the steps mentioned below:
Log into your Rent Manager account and in the 'Admin' panel, click on 'Available Integrations'.
In the 'Search' box, type 'Birdeye'. When the 'Birdeye' integration box opens, click 'Activate’. This opens a new pop-up window.
In the pop-up window, select the locations you want to establish the integration for, and click ‘Activate'.
NOTE: By default, ‘Available Integrations’ is visible only for your ‘Default location’.
When the next pop-up appears, click 'Ok'.
Now, Birdeye integration has been activated, and the 'Activate' button will turn grey.
Now you can view the information in the 'My Integrations' section with four new options.
Once the Client has activated our Birdeye Integration from the Rent Manager, an email will be sent which will confirm that the activation is successful. And now, you can add the details to Integration Dashboard and complete the integration.
Campaigns Tags
Campaign tags are used to set up campaigns within the Birdeye dashboard.These tags are either provided by the client or can be fetched from Kibana for already checked-in contacts.
RentManager Campaign tags are:
tenant_color_status,billing_name_1,billing_name_2,move_in_date,lease_sign_date,rentmanager_tenent_status,service_request_issue_category.
Restriction Reason
Restriction reason is used to identify the contacts which have been opted-out(restricted) from sending a review request. This reason can be fetched from Kibana for contacts that are checked-in already.
Possible restriction reasons are:
Property is inactive
Troubleshooting Steps
Inform the Client that the property Id is Inactive, you can check for property id value from the field, property_id, billing_name_1, billing_name_2





















