Web App - Import My Contacts via Integration

Import My Contacts via integration

Connecting Bananatag with your existing people management system (such as Azure Active Directory) gives you the benefit of having daily contact syncs which means all of your contact information will be kept up to date automatically. You can then use your imported contacts to build custom distribution lists in Bananatag.

You will need to have a Power or Enterprise plan to access this feature.

There are two integrations available:
1. Azure Active Directory 
2. Workday  

1. Using the top navigation, click on Contacts, and then click Import.
   
   
   
   
   
2. Select the Azure tile, to start creating this integration. 
   
   
   
   
3. a) From the next screen enter a Title for your Company Active Directory and click CREATE and then click CONNECT ACTIVE DIRECTORY.
   
   
   
   Ensure pop-ups are allowed for https://app.bananatag.com/
   
   
   
   b) In the new window that pops up, you will need to enter your Microsoft AD credentials.
   
   
   
   c) Once successfully connected to Azure, the pop-up should close and you should see a connected status.
   
   
   
   
   
4. The next step after connecting is to choose which Azure groups you want to replicate as distribution lists. You can learn more about how list syncing works here. 
   
   
   
   
5. a) After clicking NEXT, you will map your Azure Active Directory fields, to ensure they display as desired in Bananatag. Some fields may be mapped automatically but can be adjusted before moving to the next step.
   
   Note: An Email Address field is a required attribute because it is used as each employee's unique ID, you can change this after your initial import. Learn more about unique ID's here. 
   
   
   
   b) If you have a specific attribute imported that does not currently have a preset attribute in the Bananatag Field dropdown, you can create a custom attribute by clicking on “Create a new field”.
   
   
   
   
   c) The “Create a new field” modal will then open, allowing you to set a custom attribute name as well as data type.
   
   

   There are 3 types of data are supported based on the data type included in the import:
   • Text - Plain text or alphanumeric values (“Manager”, “123ABC”, “12 Cherry Lane”).
   • Number - Explicit number values like Employee ID or telephone number (no hyphens or other special characters) (“1237”, “5552140505”).
   • Date (YYYY-MM-DD) - Date value such as a Start Date or Employee Contract Expiration (“2019-03-12”, “2020-12-31”).
   
   

   
   

   
   After you’ve assigned the attribute a name and selected the data type, click the Create Field button to create the new field and finish mapping it. 
   
   

   d) With Azure Active Directory, you have the option to add custom fields. You will need to know which attributes you want to import and their Unique Field Id in order to import them. You can learn where to find and how to import your AAD Unique Field IDs here. 
   
   
   
6. Once all rows have been mapped, you will be able to click through to the next step - excluding contacts. This is an optional step, can you may choose to skip it if you want all of your AAD contacts to be imported. You can learn more about why you might want to exclude contacts here.
   
   a) First choose the attribute that you want to base your exclude contacts on. 
   
   Note: only attributes that you mapped to Bananatag will appear in the dropdown. If you need to return to the mapping step and re-map a field you can do so without losing your work by using the Previous button. 
   
   
   
   b) Now, you will select an operator. 
   
   
   
   c) If you choose Is or Is not you will also need to provide the field input for the contacts that should be excluded. You may add as many exclusions as you want. 
   
   Note: The input here needs to be an exact match to the field input. 
   
   
   Once you have your optional exclusions set up, you can hit SYNC.
   
   
7. In the final step, you will see the status of your integration and lists while they are syncing. Note: You are free to navigate around Bananatag or to other websites while this is running. 
   
   
   
   
8. Once you have finished syncing, you will be able to see all your contacts in your Employee Directory and any lists you chose to sync under Distribution Lists. You can make edits to your integration by navigating to Contacts > Sources > Integrations. 
   
   
   
   

   🎓  Learn more about excluding contacts and importing lists with Azure Active Directory.

   
   
   

Sync with Workday

1. Using the top navigation, click on Contacts, and then in the sub-navigation below, click Import.
   
   
   
   
   
2. Click on the Workday tile, to start creating this integration. 
   
   
3. a) From the next screen enter a Title for your Workday and click CREATE and then click CONNECT TO WORKDAY.
   
   
   
   
   b) In the modal that pops up, you will need to enter your Microsoft AD credentials.
   
   
   
   
   c) Once successfully connected to Workday, you should see a connected status.
   
   
   
   
   
4. a) After clicking NEXT, you will map your Workday fields, to ensure they display as desired in Bananatag. Some fields may be mapped automatically but can be adjusted before moving to the next step.
   
   Note: An Email Address field is a required attribute because it is used as each employee's unique ID, you can change this after your initial import. Learn more about unique ID's here. 
   
   
   
   b) If you have a specific attribute imported that does not currently have a preset attribute in the Bananatag Field dropdown, you can create a custom attribute by clicking on “Create a new field”.
   
   
   
   
   c) The “Create a new field” modal will then open, allowing you to set a custom attribute name as well as data type.
   
   

   There are 3 types of data are supported based on the data type included in the import:
   • Text - Plain text or alphanumeric values (“Manager”, “123ABC”, “12 Cherry Lane”).
   • Number - Explicit number values like Employee ID or telephone number (no hyphens or other special characters) (“1237”, “5552140505”).
   • Date (YYYY-MM-DD) - Date value such as a Start Date or Employee Contract Expiration (“2019-03-12”, “2020-12-31”).
   
   

   
   
   

   After you’ve assigned the attribute a name and selected the data type, click the Create Field button to create the new field and finish mapping it. 
   
   

5. Once you have finished mapping your fields and click next you will be redirected back to the Sources page where you will see the status of your Workday integration. From here you can manually sync or edit your integration in the future.