Editing Microsoft Dynamics 365 (section)

== Setup Instructions ==
=== Step 1: Install the ActiveCampaign App ===
To install the ActiveCampaign app in Microsoft Dynamics:
# Log into your Microsoft Dynamics account.
# Go to AppSource in your Microsoft Dynamics account. Search for ActiveCampaign.
# Click the "Get it now" button.
# A modal window will appear. Complete the information in the modal and click the "Continue" button.
# Complete the rest of the steps to set up the ActiveCampaign app in your Microsoft Dynamics account.

=== Step 2: Connect ActiveCampaign to Microsoft Dynamics ===
From your Microsoft Dynamics account:
# Navigate to the Dynamics environment you installed.
# Launch the Apps section and click the ActiveCampaign option.
# The ActiveCampaign dashboard will load. Click the "Settings" option located under "Setup."
# Enter your ActiveCampaign API URL and Key into the fields provided.
# Click the "Connect" button.
# A confirmation window will appear. Click the "OK" button.

Your ActiveCampaign account is now connected to Microsoft Dynamics 365.

=== Step 3: User Management ===
Now that your ActiveCampaign account is connected to Microsoft Dynamics, you can assign permissions. These permissions dictate which Microsoft Dynamics users can use the ActiveCampaign Sales Actions available with this integration.
* Permissions are assigned on the "User Management" page. Click the "User Management" option on the top navigation menu.
* To assign permissions:
# Click the "Add User" icon.
# Type the name of the user into the search field that appears. As you type, Microsoft Dynamics will suggest names. Click the user you wish to assign permissions to.
# Click the "Add" button.

=== Step 4: Data Configuration ===
Click "Data Configuration" on the top navigation menu to select sync directions and map fields for Contacts, Leads, Accounts, and Opportunities. 

* You can set the sync direction for Contacts, Leads, and Accounts on the entity and field level. To set the sync direction on the field level, select "Bi-directional" for the entity sync.
* Opportunity fields sync is a one-directional sync from Microsoft Dynamics to ActiveCampaign. There is no bi-directional sync for this option.
* Compatible field types will surface when you map fields.
* It is not possible to map Deal fields in ActiveCampaign with fields in Microsoft Dynamics.
* You can turn off mapping for standard Contact and Lead fields, except for the "Email" and "Account" fields, and remap to custom fields.
* If you don't want to sync fields for leads, contacts, accounts, or opportunities, set the entity toggle to the "Off" position.

==== Configure Mapping for Leads, Contacts, and Accounts ====
Locate the entity you want to sync, then click the toggle to set it to the “On” position. Choose the sync direction for the entity as a whole. The entity sync direction applies to all mapped fields. You can choose from bi-directional, push-only from D365 (outbound), or pull-only from ActiveCampaign (inbound).

Next, choose one of the following sync options:
* All leads, contacts, and accounts created or updated.
* All leads, contacts, accounts that match specific criteria.

If using "All leads/contacts/accounts created and updated":
# Click the "Edit" button.
# Click the ActiveCampaign fields you wish to sync with Microsoft Dynamics.
# Click the "Add" button.
# Click each dropdown under the "Dynamics" column and select the Dynamics field you wish to map to.
# Click "Save Changes."

If using "All leads that match certain criteria":
# Select the field you want to use to segment your contacts.
# Choose the operator.
# Enter a value for the field.
# Click the "Add" button.

==== Configure Mapping for Opportunities ====
To sync Opportunities, they must have a relationship with a syncing contact. Opportunities are available on Contact records in the Custom Objects box.
* You can map up to 20 custom fields for the Opportunity sync. This is a one-way sync from Microsoft Dynamics 365 to ActiveCampaign.

To sync opportunities to your ActiveCampaign account:
# Click the "Opportunities" toggle to set it to the "On" position.
# Click the “Opportunity Custom Field Mapping” toggle to set it to the “On” position.
# Scroll down to the “Custom Mappings” section.
# Click the “Edit” button.
# Select the ActiveCampaign fields you want to map, then click “Add.”
# For each ActiveCampaign field, add the field type to the “ActiveCampaign field type” column.
# Click “Save Changes” located in the toolbar.

=== Step 5: Sync Settings ===
Once you've completed the data configuration step, establish your sync settings on the "Sync Settings" page. 

There are three different sync settings that you can configure: Global, Initial, and Job Schedule.
* **Global Sync**: Enabled by default. When on, the one-time "Initial Sync" will run.
* **Initial Sync**: This one-time sync runs when the "Global Sync" toggle is set to "On."
* **Job Schedule**: Configure recurring syncs between Microsoft Dynamics and ActiveCampaign.

The integration setup is now complete. This integration does not allow for immediate syncs. Leads and contacts will sync between platforms when the next scheduled sync runs.