How Does the Church Community Builder (CCB) Integration Work?

The Virtuous Volunteer - CCB Integration allows you to connect the Virtuous Volunteer People Object to the CCB Individual Object so that you can import and export user data between the two systems.

Once you connect your CCB account to Virtuous Volunteer, you will be able to get started syncing your members into your Virtuous Volunteer Account. The users you import will get a customized email to create their account in Virtuous Volunteer. Or you can setup SSO so that users can use their CCB account to login to Virtuous Volunteer and create their account via SSO.

People

Virtuous Volunteer People = CCB Individuals

Each Virtuous Volunteer user has specific contact data associated with their account. This is biographical information like their first name, last name, email address (unique identifier), phone number, etc. that the user inputs when they create their Virtuous Volunteer account.

There are two ways to sync your data from Virtuous Volunteer to CCB:

1. Importing from CCB to Virtuous Volunteer
   • When you setup the integration through our Setup Wizard, you will get to select a couple of settings as far as who you want to import, when to import them, etc. so that you can launch the integration and get people started.
   • You can choose to enable a 2-way sync on these users in order to keep data synced up in both systems when a Virtuous Volunteer user updates their information in Virtuous Volunteer. (Note that this will update data in CCB, so if you want to avoid this make sure to turn off the sync).
     1. You can select individual Contacts to Import
        • You will see three segments in the Users list.
          1. Imported (users who have been imported).
          2. Pending (users who are waiting until the next API sync to be imported to Virtuous Volunteer).
          3. Not Imported (users who exist in CCB but have not been selected to be imported to Virtuous Volunteer).There are two ways to select contacts to import from CCB in to Virtuous Volunteer:
     2. Select CCB Groups (of Individuals) to Import
        • The list of CCB Groups will display in the list. Simply select a Group and Virtuous Volunteer will keep that Group up to date in Virtuous Volunteer, even when you add new Individuals to the Group in CCB (syncing happens every 15 minutes).
          • There is an option to map Group Members from CCB to Virtuous Volunteer Groups so that you can copy the same structure in both CCB and Virtuous Volunteer. 
2. Data Exporting/Syncing back to CCB from Virtuous Volunteer
   Enabling Syncing allows you to automatically send data from Virtuous Volunteer to CCB regardless of if you have imported them into Virtuous Volunteer. Keep in mind that if you did not import the user into Virtuous Volunteer, there is a good chance that a duplicate would be created in CCB for the user.
   • Enable Custom Syncing
     1. When you toggle on Custom Syncing Virtuous Volunteer user's contact data will start syncing back to CCB. You can use our mapping tool to choose which Virtuous Volunteer Objects and data will be synced in the CCB Individual Object. 
     2. If you wish to edit the default mapping, simply change the data mapping tool from the defaults however you would like. There are several to choose from, and you can even create a custom value to send along with the People data that is going back to CCB.
   • For documentation on the Virtuous Volunteer-CCB Field Mapping Tool, visit: CCB Integration Field Mapping