How to automate user import from Google Workspace in Jostle

Google Workspace automation closely integrates your Jostle platform with your Google domain. It will allow you to automate the import of new Users and sync User metadata. To access these Google automation functions, you must already have integrated Jostle with your Google domain.

Setting up automatic import

To automatically set up Jostle Accounts when new Users are added to your Google domain, a System Admin should:

1. Go to Admin Settings > User Data to/from Other Systems > Google Workspace automation
2. Check the box "Automatically import new users (every 24h)"
3. Click Save at the bottom

Note: At the bottom of this section, you can see when your last automated import happened, and if there were any errors encountered they will be noted here.

Using the Block List

If you have Users like "info@company.com" that you don't want to have Jostle Accounts for, a System admin should:

1. Go to Admin Settings > User Data to/from Other Systems > Google Workspace automation
2. Click "Edit block list" and add the User to the Block List in the Automatic Import of New Users section.
3. Check the "Exclude specific users" box
4. Click Save at the bottom

Automatically Inviting new Users to Jostle

If you would like to automatically Invite new Users to Jostle when they are added to your Google Domain, a System Admin should:

1. Go to Admin Settings > User Data to/from Other Systems > Google Workspace automation
2. Check the Invite All box in the Automatic Import of New Users section
3. Click Save at the bottom

Dealing with users departing your Google domain

When a User's Google Account is suspended, you can automatically Disable their Jostle Account. To configure this a System Admin should:

1. Go to Admin Settings > User Data to/from Other Systems > Google Workspace automation
2. Check the "Disable in Jostle (profile will remain)" box in the Manage Users Suspended in Google section
3. Click Save at the bottom

When a User's Google Account is removed, you can automatically Disable their Jostle Account. To configure this a System Admin should:

1. Go to Admin Settings > User Data to/from Other Systems > Google Workspace automation
2. Check the "Disable in Jostle (profile will remain)" box in the "Manage Users in Jostle with Google ID's but no longer in your Google domain" section
3. Click Save at the bottom

Notes:

• When a Jostle User is Disabled, they cannot log in, but are otherwise remain unaffected. Disabled Users are visible in the platform.
• When you delete a User on the Google side, they then need to be Deleted on the Jostle side by a System Admin at Admin Settings > User Accounts and Data > Delete Disabled or Suspended Users. This can also be done in bulk at Admin Settings > User Data To/From Other Systems > Delete Users (CSV).

Setting up User metadata syncing

With the Google Automation running, you can decide how User metadata it kept in sync. To configure this, a System Admin should:

1. Go to Admin Settings > User Data to/from Other Systems > Google Workspace automation
2. Configure the Sync User Metadata section, as required
3. Click Save at the bottom

Here is how the settings here work:

"Off" means that User metadata set in Jostle is not synced to your Google domain.

"Google as the master" updates User metadata from Google to Jostle, once a day.

"Jostle as the master" updates User metadata from Jostle to Google, in real time.

Tip: Check "Blank fields overwrite existing data" if you want data removed on the Google side to also be removed on the Jostle side.

Note: See the next section to understand what fields are synced.

Field mapping

This section sets out how the fields making up the User metadata are mapped from Google Workspace Profile fields are to Jostle User Profile fields.

Note: First Name and Last Name do not appear in this table because that information is synced from Workspace User Data, not Workspace Profiles.

¹ For Org Name we will only sync from Jostle to Google if the Org Name in Jostle is not the domain name.

² Your Jostle “Custom Filter Category” will sync to the Google “Work Organization Department”, but this only syncs from Jostle to Google. If you are using your Jostle Custom Filter Category for something other than department this could lead to some unexpected values in your Google Contact Profile “Work Organization Department” field.

³ We intentionally do not sync Primary Role from Google to Jostle, since this field needs to be managed with care on the Jostle side. Consequently this field is only synced from Jostle to Google, where it arrives as the Work Organization Job Title.

⁴ Jostle only has access to a very low resolution version of your Google profile photos, so we only import photos to Jostle from Google if there is no existing Profile Photo.

⁵ For Home Phone, Personal Email, and Personal Mobile Phone blanks overwrite doesn’t apply if Jostle is the master. Syncing to Google respects the Permissions set in each User Profile. For example, if the Permissions of one of these fields is set to Direct Relations or Nobody the value in Google will be deleted.

⁵ If Google is the master for Home Phone, Home Email, and Custom Phone Label “Personal Mobile”, blanks overwrite will apply. This is because these fields are generally visible within your Google domain.

⁶ Because of the way Jostle handles and uses Locations “Work Address” will sync from Jostle to Google only.