SYSTEM REQUIREMENTS
- DoorBird IP Video Door Station
- DoorBird Cloud Enterprise License
- Prodatakey (PDK) Subscription
SCOPE OF THE INTEGRATION
The following guide shows you step by step how to connect a DoorBird IP Video Doorstation to a Prodatakey (PDK) System.
With this integration, you can:
- Synchronize the PDK database with one or more DoorBird(s) and assign them to call buttons or the digital directory (depending on the DoorBird device)
- Automatically create tenants and invite them via email
- Synchronize PIN codes for tenants
- Control locks in the PDK system using the DoorBird App or via DoorBird schedules
The guide assumes that your PDK system is already configured. If you need help with the configuration of your PDK system, please refer to the official documentation from PDK (support.pdk.io), contact your local dealer, or reach out to PDK customer support (pdk.com/contact).
SOFTWARE / FIRMWARE
This guide has been tested with the following hardware and software versions:
DoorBird IP Video Door Station - D31:
- Firmware: 000155
DoorBird IP Video Door Station - D22:
- Firmware: 000155
EXPLANATION OF INTEGRATION
This integration works by synchronizing the users from the PDK System onto the user database of the connected DoorBird. The users are then displayed on the digital directory of the DoorBird or assigned call buttons (depending on the model of DoorBird that you have). It is strongly recommended that you create a group inside of PDK where the users you wish to synchronize are stored as the integration allows you to filter by group.
The other practical advantage of this is that you can use groups strategically to synchronize across multiple buildings selectively (since the integration allows adding more than one DoorBird, as well as multiple properties in the DoorBird Property Management Platform).
Finally, in the default settings, only users in the PDK System who have been assigned email addresses will be synchronized as an email address is required to receive invitations with DoorBird user credentials. If the setting “Send invitation emails to” is set to “Owner” or “Owner and Tenant”, all users in the selected group will be added (see page X).
1. CREATING A TEMPLATE USER
All DoorBird users are assigned permissions which dictate which functions of the DoorBird they can and can’t use. The integration uses the notion of a “template user” when creating the DoorBird users out of the user data from the PDK Database. Before setting up the integration, you should verify the user permissions by either modifying those of the App User or creating a new user
1.1 Navigate to webadmin.doorbird.com and log in to your DoorBird’s web administration interface using the Admin login data from the Digital Passport supplied with your DoorBird.
1.2 Click on “User” on the sidebar, and either click on the App User (xxxx0001) or create a new one by pressing “+”. Select permissions according to your needs and save your changes by clicking “Save”. Remember which user you applied the permissions to, you will need to reference this in the subsequent steps.
2. SETUP IN DOORBIRD PROPERTY MANAGER
Note: A DoorBird Cloud Enterprise License is required in order to carry out these steps. You can purchase a license in the Property Management Platform during setup if you don’t already have one.
2.1 Navigate to webadmin.doorbird.com/property and make an account, if you don’t already have one. Then, log in.
2.2 If you haven’t already configured Sites and Buildings, please do so now. At the very minimum, one Site containing a Building is required. If you need help with the configuration process, please consult the official documentation of the DoorBird Property Management Platform.
You are now ready to begin the configuration of PDK
2.3 On the “Sites” screen, click on the site which contains the building that you would like to synchronize your DoorBird and PDK Database with.
2.4 Now click on “Integrations” in the left hand side menu.
2.5 Next, click on the “+” icon in the PDK box to add the integration.
2.6 Note: The following step requires you to be logged into https://pdk.io alongside the DoorBird Property Management Platform.
In a separate tab or window, navigate to the “Marketplace” section of PDK and click on “Learn More” on the “DoorBird” tile. After that, click on activate in the section that appears on the right hand side of the screen.
2.7 Back in the DoorBird Property Management interface, give the instance of the integration a name and click “Connect”.
2.8 You will then be asked with which System you would like to connect the integration. Select the correct system from the list and then click “CONNECT”.
2.9 In the PDK box in “Configured Integrations”, click on the “+” icon next to “DoorBird devices”.
2.10 From the “Select a device” drop-down menu in the “Add device” dialog, click on the DoorBird you wish to synchronize with the PDK system. Finally, click “Add”.
2.11 Now that the DoorBird has been added you can select the PDK group that you want to sync in the “GROUPS” drop-down menu, choose which DoorBird user should act as a template in terms of permissions in the “COPY PERMISSIONS FROM USER” drop-down and select the door/actuator in your PDK system (associated with a Cloud Node) in the “CONNECTED DOOR” dropdown that should open when the DoorBird’s internal relay is triggered. Confirm your changes by pressing “Save”. Then, the system will begin to synchronize and create new users in the DoorBird based on the user data in the selected group.
You will then see the PDK users in the “Users” section of the DoorBird’s Web Admin interface or on the screen of the DoorBird’s digital directory (if your device has one).
3. ALLOCATING PIN CODES
In PDK it is possible to create a PIN number and assign it to a user. These PIN numbers are synchronized between PDK and the DoorBird, enabling you to enter a code on the DoorBird’s keypad or touchscreen and open the door connected to the DoorBird’s relay. If you have “Connected Door” (see step 2.11) enabled, this will also simultaneously open the selected door connected to the PDK system.
3.1 Navigate to the “People” screen in PDK and select the user you want to assign a PIN code
3.2 The following sidebar will appear on the right hand side of the screen. Click on “Add Credential”.
3.3 This dialog box will now appear. Type the PIN number in the “PIN” box and click “Submit”.
You can verify that the credentials work by entering them on the DoorBird’s keypad or digital display
4. INTEGRATION SETTINGS
The integration has a settings menu which can be accessed by clicking on the cog icon in the top right hand side of the PDK menu item.
The following dialog box will appear with the following configuration options
|
Should you need to remove all of the synchronized users, you can perform a cleanup in the “Cleanup DoorBird from Cloud Integrations” menu of the integrations page. Select the DoorBird you wish to cleanup from the drop-down menu and click “Clean up device”.
5. MANUALLY DEFINING A RING CODE
Sometimes it might be necessary to manually define a ring code. Normally, users are automatically assigned a code during synchronization, but there may be circumstances where these codes need to be reallocated or edited. DoorBird and PDK keep track of these codes in a custom field called “DoorBird ring code”.
One such use case is when a DoorBird has physical call buttons. Normally, a newly created user is allocated to the next free call button. It may be the case that you want a tenant to be allocated to a specific button. Call buttons are sequentially ordered in the following manner 101, 102 . 10x . In the doorbirdRingcode field, you can define the call button position by using these ring codes.
In general the manual allocation of ring codes is not recommended but the functionality exists for these edge cases and debugging purposes.
FURTHER SUPPORT
For questions and problems regarding products from PDK please contact your dealer or PDK online at: pdk.com/contact
For questions and problems regarding our devices (DoorBird IP Video Door Station), please contact our customer support using the online contact form: doorbird.com/en/contact
DISCLAIMER
At the time of creating the integration guides, we carefully test both with components that we develop and manufacture ourselves, as well as with components from third-party providers, in order to describe the respective integration possibilities. However, as the manufacturer, we cannot provide any warranty for the cross-manufacturer functions described in this guide (smooth interaction of our components with third-party components), since integrations naturally involve third-party components that are neither developed nor distributed by us and whose performance and functionality we cannot directly influence. In addition, third-party providers may release software updates for their components over time, which can lead to incompatibilities. Bird Home Automation GmbH can guarantee functionality and performance only for components that are developed and distributed by us.
Comments
0 comments
Please sign in to leave a comment.