# Yoxel Sync admin configuration

### Prerequisites:

***

* Yoxel Sync package is installed.<br>
* You (Salesforce admin) have the package license (use the **'Manage Licenses'** link to assign one).

\
1\. In Salesforce Setup, on the **'Install Packages'** page find Yoxel Sync and click '**Configure':**

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FwZO3ExTp3z1pfbGHOuEr%2Fimage.png?alt=media&#x26;token=8e9563f4-aa23-493c-a686-0e8052aea2f4" alt=""><figcaption></figcaption></figure>

2\. You will be taken to the Yoxel Sync setup page. Go to the **'Sync templates'** menu:

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2Fg30SvtC9MnnMIduF5gOU%2Fimage.png?alt=media&#x26;token=ed83da6b-0a61-4e81-9682-a98436bb3d48" alt=""><figcaption></figcaption></figure>

3\. Then click **'+ Create new template'** to select a type of sync you want to configure (Office 365, MS Exchange, G Suite):

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FBtI9ANPBoH83S3xeZqjp%2Fimage.png?alt=media&#x26;token=9764bf83-ac88-4eaf-b9b4-5c3cd07c7bd9" alt=""><figcaption></figcaption></figure>

4\. Now start configuring your new template, i.e. Office 365. The first step is choosing a Salesforce authorization mode. To use the admin level authorizations you need to prepare additional configurations:

* [Salesforce: Activating admin approved pre-authorizations mode](https://helpdocs.yoxel.com/yoxel-sync/activating-admin-approved-pre-authorizations-mode)

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FSprpSO6TpiSg622vAPvy%2Fimage.png?alt=media&#x26;token=a8ba9b85-4da3-4ffa-98e3-5e8753645c50" alt=""><figcaption></figcaption></figure>

﻿

5\. Scroll down and choose an authorization mode for the mailbox connections. If you choose 'self-authorizations' mode for your users you want to list allowed email domains and can move further.

{% hint style="info" %}
*Note: Your Office 365 admin should be available to authorize in the admin mode.*
{% endhint %}

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FgH0DnsP5QElCJ10hCRYZ%2Fimage.png?alt=media&#x26;token=e52f6609-fce3-4691-93ac-cfbfde2e10ab" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*Note: to sync G Suite emails you need to activate the admin level authorization mode. Prepare a service account key file first:* [Setting up G Suite service account](https://helpdocs.yoxel.com/yoxel-sync/setting-up-g-suite-service-account)
{% endhint %}

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2F2SAaanQe1cXVjJ38xGhB%2Fimage.png?alt=media&#x26;token=388df50b-389f-4eb7-8dd9-76da5109fb30" alt=""><figcaption></figcaption></figure>

MS Exchange authorization settings will require entering an EWS url:

* Check your current Outlook account settings: Account Settings->\[choose account]->More Settings->\[select Connection tab]->Exchange Proxy Settings. For Mac Users, try the Outlook Preferences-->Accounts-->\[choose account]--->Advanced

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FveWwZ9NmhDjDJZYWG0tB%2Fimage.png?alt=media&#x26;token=089da68e-d018-4785-a9c7-0e4d23d92953" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
*Admin mode: Your MS Exchange admin should prepare a special service login with impersonation permissions.*
{% endhint %}

6\. Scroll further down to the Email sync settings.

{% hint style="info" %}
*Note: For the G Suite sync this is available only in the the admin level authorization mode.*
{% endhint %}

* Emails can be logged to a standard Salesforce object like Opportunity or Case, or any custom object.<br>
* Specify all your email domains so that the sync could exclude internal email communications.<br>
* Specify any additional exclude rules if want to make sure certain categories of emails are never logged to Salesforce.

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2F9GnVtJSJuen6zc3LVMa1%2Fimage.png?alt=media&#x26;token=aff1ba73-93e3-462b-9c6c-78d0dc4556fd" alt=""><figcaption></figcaption></figure>

7\. Scroll down to the Calendar sync settings.

* Chose the sync direction.<br>
* Specify time range.<br>
* Specify all your email domains so that the sync could distinguish between internal and external attendees.

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FWtxOu84DfKy89pl2oURU%2Fimage.png?alt=media&#x26;token=9f0f375a-378f-48c7-9f6e-e7b48ff2458d" alt=""><figcaption></figcaption></figure>

* Events can be related to a standard Salesforce object like Opportunity or Case, or any custom object.<br>
* Either all Salesforce user events can be synced or only those satisfying one additional field/value filter.<br>
* You can also define default field values for new events syncing to Salesforce.

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FNqa5mbKLceharhfPiDhB%2Fimage.png?alt=media&#x26;token=40536aa3-c24c-4cce-b963-b4eb2a596d23" alt=""><figcaption></figcaption></figure>

* Either all mailbox events can be synced or only meetings

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FBhOQZnjHpuWa2WLf5Qk3%2Fimage.png?alt=media&#x26;token=91877473-5a5e-454d-9263-17dd8984732a" alt=""><figcaption></figcaption></figure>

8\. Scroll further down to the Contacts sync settings

* Choose the sync direction.<br>
* Choose which Salesforce events need to be synced.<br>
* Specify if any default field values should be set for new contacts syncing to Salesforce.

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2Fw577HPlX1Hd89oWyloVX%2Fimage.png?alt=media&#x26;token=e4a68904-9681-4108-aea0-316636b70328" alt=""><figcaption></figcaption></figure>

* Either all Outlook/Gmail contacts can be synced or those from specific categories/groups

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2F406ncG2ryRjrjbzGaAHc%2Fimage.png?alt=media&#x26;token=52246f3b-99e4-4a58-aaf4-5876e2e33aae" alt=""><figcaption></figcaption></figure>

9\. Scroll down to Add users. Specify users that the sync should be activated for.

{% hint style="info" %}
*Note: Your first template is also your 'default' template meaning that it applies for any new licensed user by default. Other templates can specify their own new user activation rules.*
{% endhint %}

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FQo10bJIs4ko3tipO0R7E%2Fimage.png?alt=media&#x26;token=16daef09-bc97-41e5-bee8-c5f1be421510" alt=""><figcaption></figcaption></figure>

10\. Click **SAVE** to publish the template and activate it for the specified users. When the 'self-authorization' mode is used user still have to visit their Yoxel Sync page to provide authorizations to complete the sync activation.\ <br>

11\. 2nd, 3rd, and other additional templates will show the user assignment form. Use it to specify user record attributes for automatic assignment of the template.

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2F5wYECiQ2gE4jb8O6FBVd%2Fimage.png?alt=media&#x26;token=befac0aa-5459-4716-942a-a7802c02f4d9" alt=""><figcaption></figcaption></figure>

12\. Your template can now be found on the templates page:

<figure><img src="https://2347016775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpfahWVY94WP1EHugi6X6%2Fuploads%2FVJhgCfeua9XzMEt7BBM6%2Fimage.png?alt=media&#x26;token=d8450c7d-609b-430b-af79-b61427270502" alt=""><figcaption></figcaption></figure>
