*This integration is supported for both SMB & Enterprise businesses.

Integrating BirdEye with Storelocal
User Manual

Integration Requirements

Triggers supported
Information required from the business
Information required from BirdEye dashboard

Integration Process

Business Integration Group

Create Integration Group (Curl Command)
Fetch information for all the triggers (Curl Command)
Find business integration group details (Curl Command)
Update Trigger Information (Curl Command)

Integration Mapping

Integration Mapping

Introduction

Storelocal is a nationwide co-operative formed by private self-storage operators. StoreLocal provides education, technology, and services to increase the profitability of its members.It supports two PMS integrations - SSM & StorEdge.

BirdEye collects the first name, last name, email address and phone number of the clients and automatically sends them review requests based on the preferences set within the BirdEye account.

Integration Requirements:

Triggers Supported

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 is the supported trigger for Storelocal:

Trigger Name	Trigger Description
StoreLocal Move In Move Out Trigger	This trigger is used to fetch customer data based on move in and/or move out of the tenants.

Details required from the Storelocal Client Dashboard

Trigger details

Details required from the BirdEye dashboard

Enterprise ID for multi-location account and Business ID for all locations
Business ID in case of an SMB Business

For single location SMB account - Business ID
For multi-location account - Enterprise ID and Business IDs of all locations
Enterprise ID

Business IDs of all locations

Initial Steps

In order to set up the integration with Storelocal, you need to contact the Storelocal support team. You need to send an email to the support team (jeremiah.jacks@storelocal.com , sneha.jose@storelocal.com) to set up the integration. For convenience, BirdEye needs to provide the Business Name and facility details per location to successfully set up the initial integration. A sample email for reference is written below:

Note: In case of an SMB Business, the facility detail will be the name of the single location business. In case of an Enterprise Business, you need to provide all the business names as facility details that you need to setup integration with.

SAMPLE EMAIL(SMB BUSINESS)

Hi,

I would request your help in enabling integration for Just Store It! (Business Name) with BirdEye at your end.

Please provide access to this facility for the above-mentioned business to BirdEye’s GDS API Key and subscribe BirdEye for CacheSpaceUpdate events for the respective facility.

Also, provide us with the owner ID for this business in Storelocal.

Thank you,
<NAME>
<DESIGNATION>

SAMPLE LETTER (ENTERPRISE BUSINESS)

Hi,

I would request your help in enabling integration for Strat Property Management (Business Name) with BirdEye at your end.

Please provide the access to the facilities below for the above-mentioned business to BirdEye’s GDS API Key and subscribe BirdEye for CacheSpaceUpdate events for below facilities:

Desert Self Storage (Location Name 1)
Diablo Mini Storage (Location Name 2)
Ballpark Self Storage (Location Name 3)

Also, provide us with the respective owner IDs for the above-mentioned facilities in Storelocal.

Thank you,
<NAME>
<DESIGNATION>

After receiving the access, you need to call the below API passing the owner IDs received from above:

curl -X GET \ 'https://common-services.birdeye.com/storelocal/facilities?ownerIds=own912376a0c75e46649021a283a3f69a41,own96d1b2509829489a82d9bcf080e59bc4,ownb8a10b98230f4dd584377936cc1fde3d,own173a832f4a8c4f048cb963dca978dd49' \

own912376a0c75e46649021a283a3f69a41 : Owner IDs - This list will contain all the owner ids which will be provided by the Storelocal team after they grant the access.

Sample Response:

[
{
"ownerId": "own912376a0c75e46649021a283a3f69a41",
"facilities": {
"National Self Storage - ELP5": "face296683729664678a15b8bbb577dd4e2",
"National Self Storage - ELP6": "facee0c3beb82df4100939ece58eb33d817",
"National Self Storage - ELP9": "fac46b14b3190814c2fb681c6fadd7c0034",
"Little Vineyard Self Storage": "fac707fd65822704934bf10158d3a534ef9"
}
},
{
"ownerId": "own96d1b2509829489a82d9bcf080e59bc4",
"facilities": {
"StaxUp Storage - Lakeside": "fac11fc4f0ab99740babd4e0bf1db74a7f3",
"StaxUp Storage - Brawley": "fac2686aaf86aa44aa7b99cf345fcd13f0b",
"South Street Self Storage": "fac177d668c20cf439f94e209b261b10002",
"StaxUp Storage - San Marcos": "fac65284c42ab634b7c8a39b9da079aafa5",
"H&M Self Storage": "fac3c6206c9f6444a7aa070652bfa0d6b7e"
}
},
{
"ownerId": "ownb8a10b98230f4dd584377936cc1fde3d",
"facilities": {
"Just Store It - State of Franklin Rd": "fac0ca4909b8c7043818e64596f18c061f8",
"Just Store It - Fort Collins": "faccf95ff7eae0144128b1d2b554803c9eb",
"Just Store It - Clarksville": "facaa42d5dbc94652ff977c75cf35363353",
"Just Store It - Knoxville": "face30673e6006c5f96ad3fcd29df743910"
}
},
{
"ownerId": "own173a832f4a8c4f048cb963dca978dd49",
"facilities": {
"Lockaway Storage - Airport": "facd74e3331c9194393a6a7a8bdc184a09a",
"Lockaway Storage - O'Connor": "facadd20fbaee8b4a4aab080c5216d4ab42",
"Lockaway Storage - FM 471": "fac21875e7e885b4cf69cf4e8a96daf9964"
}
}
]

From the above response, you need to match the business location’s name in the list and find the corresponding facility id for the same. For e.g. Here, business location National Self Storage is mapped to facility id “face296683729664678a15b8bbb577dd4e2”[National Self Storage - ELP5": "face296683729664678a15b8bbb577dd4e2]

Integration process

Before you can integrate Storelocal with BirdEye, you will need to set up the following configurations:

Integration Group

(a) Create Integration Group (Curl Command)

Copy Curl Command:

curl -X PUT \
https://common-services.birdeye.com/integration/add/businessintegrationgroup \
-H 'content-type: application/json' \
-d '{"parentBusinessNumber":145301438060509,"integrationSourceId":46,"integrationGroupProperties":[{"propertyKey":"fetch.move.in.tenants","propertyValue":"true"},{"propertyKey":"fetch.move.out.tenants","propertyValue":"true"}],"integrationGroupTriggers":[{"triggerId":69,"triggerTypeId":1}]}'

145301438060509- Business ID - This is Enterprise ID for multi-location account and Business ID for a single location SMB account
true – Flag to fetch move in tenants- This flag is to be set to ‘true’ if the client wants to send a review request to the tenants who moved in today.
true – Flag to fetch move out tenants- This flag is to be set to ‘true’ if the client wants to send a review request to the tenants who moved out today.
69- Integration Trigger ID - Can be one or more triggers. Ask the client what trigger they would like to integrate with then run the curl command to fetch all possible triggers for Storelocal. Identify the trigger ID (s) and insert (use commas) in case of multiple trigger IDs.

(b) Fetch information for all the triggers available for Storelocal (Curl Command)

Copy Curl Command:

curl -X GET https://common-services.birdeye.com/integration/trigger/integrationtriggers/sourceid/49 -H 'cache-control: no-cache' -H 'content-type: application/json'

Sample response: A sample response like this would 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": 71,
"triggerService": "storeLocalMoveInMoveOutTriggerService",
"displayName": "StoreLocal Move In Move Out Trigger",
"description": "This trigger is used to fetch customer data based on move in and/or move out of the tenants.",
"active": true,
"integrationTriggerType": [
{
"id": 2,
"name": "WEBHOOK"
}
],
"actionGroupId": 1
}
]

71Trigger ID

(c) Find business integration group details (Curl Command)

Copy Curl Command:

curl -X GET https://common-services.birdeye.com/integration/businessintegrationgroup/155793839525772 -H 'Cache-Control: no-cache'

155793839525772Business ID: Enter the Business ID here to get the integration group details for a business.

[
{
"groupId": 8454,
"integrationSourceType": {
"id": 49,
"integrationSource": "STORELOCAL",
"sourceCategory": "Real Estate",
"integrationType": "Birdeye API",
"integrationPlan": "Basic",
"oauthEnabled": false
},
"integrationGroupTriggers": [
{
"triggerId": 71,
"triggerTypeId": 2,
"actionIds": [
1
]
}
]
}
]

8454 Group ID: A group ID will be returned in the sample response with the details of the existing triggers for a business.

(d) Trigger Information: Only required if client wants a change (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": 8454,"integrationGroupTriggers":[{"triggerId":71,"triggerTypeId":1}]}'

replaceTriggers=true -To replace existing trigger(s), enter the value for replaceTriggers as true. To add a new trigger(s) to the existing list, the value for replaceTriggers should be false.
8454 Group ID: The Group ID which was returned in the previous step will be entered here.
71Trigger ID: Enter the Trigger ID (s) which need to be added or updated to the integration.

Integration Mapping

Once the Integration Group is created, the next step is to create the Integration Mapping.
Copy Curl Command:

curl -X PUT \https://common-services.birdeye.com/integration/add/businessintegrationmapping \
-H 'content-type: application/json' \
-d '{
"businessNumber": 154416387790029,
"integrationGroupId": 8454,
"active": true,
"integrationProperties": [
{
"propertyKey": "owner.id",
"propertyValue": "own96d1b2509829489a82d9bcf080e59bc4"
},
{
"propertyKey": "facility.id",
"propertyValue": "fac12eb84853e604c3db16ca21bd42ff51c"
}
]
}'

154416387790029- Business ID: Enter the Business ID for the SMB Business.
8454 Group ID: Enter the Group ID which was returned when the Integration group was created.
own96d1b2509829489a82d9bcf080e59bc4- Owner ID: This ID will be provided by the Storelocal support team as a response to the integration setup email.(Note: Please enter the correct owner ID mapped to this location in BirdEye)
fac12eb84853e604c3db16ca21bd42ff51c - Facility ID: This ID will be fetched by calling the API mentioned above in the document.

Campaigns Tags

These campaign tags are used to setup campaign from the birdeye dashboard.These tags are either provided by client or can be found from Kibana for already checkedIn contacts.StoreLocal Campaign tags are:
CheckinType