Microsoft Dynamics 365 CRM

About APSIS One's Microsoft Dynamics 365 CRM Integration

(Beta)

"Microsoft Dynamics 365 CRM is a set of intelligent business applications that helps you run your entire business and deliver greater results through predictive, AI-driven insights.”

Read more on Microsoft Dynamics 365 CRM's website.

integrations5.jpg

 

Expand an item below to learn more about APSIS One Microsoft Dynamics 365 CRM integration:

APSIS One's Microsoft Dynamics 365 CRM Integration

About APSIS One's Microsoft Dynamics 365 CRM Integration

The Microsoft Dynamics 365 CRM Integration for APSIS One enables you to utilise all the data from your CRM in any channel connected to your APSIS One account.

This is achieved by mapping data fields in your Microsoft Dynamics 365 CRM account to Profile Attributes and Channel Consent in APSIS One, allowing for unified and synchronised Profile data in your APSIS One account.

There are two features that empower data transfer from Microsoft Dynamics 365 CRM into your APSIS One account: Real-time Sync and Full Sync.

A Real-time sync takes place whenever a contact card is created or updated. This results in a corresponding Profile being updated or created in APSIS One, matching the state of the contact.

A Full sync systematically goes through all contacts in your Microsoft Dynamics account and either creates a new Profile in your APSIS One account, or updates the existing Profile data. We recommended using this feature after setting up your initial mappings, or when you intend to sync new mappings.

 


 

Profile Merging and Updating

When a Profile is created in the APSIS One account, it will receive the contact ID as a Profile key in the Microsoft Dynamics Keyspace, and the email address as a Profile key in the Email Keyspace. All data is written through Microsoft Dynamics 365 CRM.  

When a new email address is detected in either the Real-time or the Full sync, all consent associated with the old email address will be moved to the new email address.

 


 

Keeping the CRM healthy

Synchronising large amounts of data can slow down your CRM. To relieve the CRM as much as possible, APSIS One has taken the following steps:

Real-time Sync: Microsoft Dynamics only sends the contents of the created or updated cards to APSIS One. To handle this message, APSIS One utilises its integration middle layer to handle the expensive operations related to consents and handling merging

Full Sync: Microsoft Dynamics is not responsible for sending any of the data to APSIS One as a part of a Full Sync. Instead, APSIS One downloads all of the contacts using Microsoft Dynamics' API endpoints for fetching paginated contacts. This puts the least amount of strain on the CRM since it only needs to respond to standard requests. Messages generated as part of a Full Sync are put in the same queue as the Real-time Sync messages, promoting consistency between Microsoft Dynamics 365 CRM and your APSIS One account.

Note that the Real-time Sync API does not accept any messages while contacts are downloaded for a Full Sync. This means that, for a short duration, a queue of messages might build up in the CRM. However, these are sent to APSIS One as soon as the Full Sync is completed.

Prerequisites

Microsoft Dynamics 365 CRM Integration Prerequisites

The APSIS One Integration solution only works with Microsoft Dynamics 365 CRM for Sales: No other products from the Microsoft Dynamics 365 CRM family are currently supported.

The APSIS One integration is intended to work with all recent versions of Microsoft Dynamics 365 CRM for Sales, or any version above 9.1.0.0.

The installation does not change any local files and does not require any specific software to be installed on the end-user's system. The only prerequisite is a web browser. To see which browsers are supported please refer to Microsoft's official documentation.

Please note that currently the APSIS One Integration is not intended to work with an on-premises version of Microsoft Dynamics 365 CRM for Sales.

Solution Overview

APSIS One Configuration Values

Here's a list of all APSIS One values sent to Microsoft Dynamics 365 CRM CRM:

  • Discriminator for the Section on which the integration was installed.
  • Discriminator for the Keyspace created to use with the integration.
  • APSIS One API Client ID.
  • APSIS One API Client Secret.

 

Security Roles

The installation package includes one security role which is required to access the entities related to the APSIS One integration. The name of that security role is APSIS Integration User. and it can be combined with other security roles, including both built-in and custom roles.

This role ensures that users with this role have read-only access to the apsis_authentication and apsis_events entities. 

 

Virtual Entities

Virtual entities to show APSIS data are still under development and the list will be extended as new functions are implemented.

Currently, only the apsis_event entity is implemented, which provides a list of Events shown on the Contact Card. 

 

APSIS Authentication Subsystem

The APSIS authentication subsystem is aimed to provide easy access to APSIS authentication token and consists of the CRMK.APSIS.Authentication plugin, registered automatically during the installation, and the apsis_authentication entity.

During installation, several configuration values holding APSIS credentials are pushed. These allow the subsystem work as intended.

After the configuration, the authentication subsystem provides the APSIS authentication token. Once expired, it can be renewed.

The authentication subsystem is intended to work only for the purpose of integrating MSD with APSIS One, and not for users to interact with directly.

Get the token information as an output by retrieving the apsis_authentication entity.

Installation

Installation

To begin the installation, you will need to have a managed Microsoft Dynamics 365 CRM CRM solution file. Contact your APSIS Account Manager to obtain the most recent version of the file.

Note that the APSIS Integration User security role is required to perform the installation.

1. Head over to Microsoft Dynamics' Settings and enter the Solutions section.

2. Click Import.

3. Select the APSIS One solution file and click Next.

That's it!

Continue with Enabling Microsoft Dynamic 365 CRM in APSIS One below.

Enabling Microsoft Dynamics 365 CRM in APSIS One

How to Enable Microsoft Dynamics 365 CRM

1. Head over to Account Settings in APSIS One.

magento1.jpg

 

2. Select a Section and open the Integrations tab.

integrations1.jpg

 

3. Locate Microsoft Dynamics 365 CRM CRM and click Connect.

MSD1.jpg

 

4. The settings will expand. Click Authorise.

You will be taken to Microsoft Azure's login page.

6. Enter your login credentials and grant permissions to APSIS One to perform the necessary operations in your account. Afterwards, you will be redirected to APSIS One.

7. Select the organisation and CRM environment you would like to work with.

You will be taken back to Microsoft Azure.

8. Allow APSIS One to work with your CRM environment. You will be taken back to APSIS One.

9. The installation process will continue in the background as you see the loading screen. 

Mappings

Mappings

Set up which data you wish to sync with the integration by mapping your APSIS One Profile Attributes with your Microsoft Dynamics 365 CRM Contact Cards.

 

How to Set up Attribute Mapping

1. Head over to the Integrations tab in your Section, locate Microsoft Dynamics 365 CRM and click Edit.

MSD8.jpg

 

2. Select the Mappings tab.

MSD11.jpg

 

3. Under Microsoft Dynamics 365 CRM, expand the Contact Card drop-down menu and select a data field.

MSD10.jpg

 

4. Under APSIS One, expand the Attributes drop-down menu and select an Attribute that matches the data field.

MSD12.jpg

 

5. Click Add new mapping to map another Attribute. Repeat the process above for all the Attributes you wish to map with your Microsoft Dynamics 365 CRM account.

MSD13.jpg

 

6. When done, click Save.

MSD7.jpg

 

Consent

About Consent Mapping

While the Real-time and Full Sync features are excellent at transporting your Profile data quickly, without mapping for consent it's hard to utilise the data in your email marketing campaigns.

The Consent tab allows users to map any True/False (boolean) field on the contact card to Channel Consent to any Consent lists and Topics in your APSIS One Section.

 

How to Set up Consent Mapping

1. Head over to the Integrations tab in your Section, locate Microsoft Dynamics 365 CRM and click Edit.

MSD8.jpg

 

2. Select the Consent tab.

MSD14.jpg

 

3. Under Microsoft Dynamics 365 CRM, expand the Contact Card drop-down menu and select Allow Newsletters.

MSD4.jpg

 

4. Under APSIS One, expand the Consent List & Topics drop-down menu and select the Topic(s) within a Consent list you'd like to map with your Microsoft Dynamics 365 CRM subscriptions.

MSD5.jpg

 

5. Under Channel Consent, tick the Email and/or SMS boxes to choose which Channel your Profiles should have consent for.

MSD6.jpg

 

6. Click Add new mapping to map another Consent list & Topic(s). Repeat the process above for all the Consent list & Topic(s) you wish to map with your Microsoft Dynamics 365 CRM account.

MSD13.jpg

 

7. Click Save.

MSD7.jpg

 

Full Sync

About Full Sync

Sync Profiles with your customer entries in Microsoft Dynamics 365 CRM. Note that a this might put a high load on Microsoft Dynamics 365 CRM and is a cost-driver for your account.

Read more about Full Sync above under APSIS One's Microsoft Dynamics 365 CRM Integration.

 

How to Start a Full Sync

1. Head over to the Integrations tab in your Section, locate Microsoft Dynamics 365 CRM and click Edit.

MSD8.jpg

 

2. Select the Full sync tab.

MSD17.jpg

 

3. Click Start sync.

MSD18.jpg

 

Uninstalling Microsoft Dynamics 365 CRM in APSIS One

How to Uninstall APSIS One's Microsoft Dynamics 365 CRM Integration

Note that it's not possible to uninstall the integration while a Full Sync is in progress.

1. Head over to your Section in Account Settings and open the Integrations tab.

Locate the Microsoft Dynamics 365 CRM Integration card and click Edit.

MSD8.jpg

 

2. Select the Settings tab.

MSD16.jpg

 

3. Select Remove and follow the instructions shown in the wizard.

MSD15.jpg

 


 

 

Was this article helpful?