Email Software Integration

Steps For Using Active Campaigns Integration Features in SuiteCRM 8 :

(Notes: Needs to set up SuiteCRM Cron on Server for Sync Data between SuiteCRM and Email Software Tools.

Active Campaigns Supports three modules of SuiteCRM such as Contacts, Target List and Accounts.)

Step 1:

To open the Administration Page, Click on the Admin tab as shown in the below screenshot.

Step 2:

Open Administration page, Click on Email Software Integration from the “Other” section.

Step 3:

After clicking on the “Email Software Integration” Link from Admin, the Email Software Integration Widget Page will be open as shown in the below screenshot.

Step 4:

On click of “API Configuration” Link from Email Software Integration Widget page, API Configuration List view Page will be open as shown in the below screenshot.

Step 5:

On click of “CREATE” Link, API Configuration Edit view Page will be open as shown in the below screenshot.

Step 6:

Enter Title & Select Email Software as Active Campaigns. Once selected Email Software, it’ll show the field of Enter Active Campaigns URL & Active Campaigns API Token. After entering the value, click on “CONNECT TO ACTIVE CAMPAIGNS” Button as shown in the below screenshot.

Step 7:

To Update Record, Click on the pencil icon from the Listview of API Configuration page as shown in the below Screenshot.

Step 8:

To Delete Record, Check the Checkbox and Click on the “DELETE” Button as shown in the below screenshot.

Step 9:

On click of the BACK Button, Email Software Integration widget page will be open.

Step 10:

On click of “Module Mapping” link from the Email Software Integration Widget Page, Module Mapping List View page will be open as shown in the below screenshots.

Step 11:

On click of “CREATE” Link, Module Mapping Configuration Page will be open as shown in the below screenshot.

Step 12:

Fill up all Required Fields from step 1 “Select Email Software” as shown in the below screenshot and click on SYNC FIELDS Button.

(Notes : SYNC FIELDS Button is used to save fields of Active Campaigns Module for future Synchronize Processes. If Batch Management is enabled and condition matched records is greater than or equal to 100 then record will sync based on Batch size once click on Sync SuiteCRM to Active Campaigns Button from Step 3 and other records will sync in backend using Scheduler.)

Once clicked on the SYNC FIELDS Button, it will display an alert message as shown in the below screenshot.

Step 13:

After that click on Next Button to move on Step 2 “Field Mapping”. Click on Add Mapping Button to Add Mapping between SuiteCRM Contacts Fields and Active Campaigns Contacts Fields as shown in the below screenshot.

Step 14:

Select SuiteCRM Contacts Fields and Active Campaigns Contacts Fields for mapping and click on “Next” Button to apply Conditions for a particular module as shown in the below screenshot.

Step 15:

After clicking on the “Next” Button from the Module Mapping Configuration Page, the Apply Conditions page will be open.

Step 16:

Once you click on the SAVE Button, the Module Mapping Listview page will be shown as below screenshot.

Step 17:

To Update Record, Click on the pencil icon from the Listview of Module Mapping Listview page as shown in the below Screenshot.

Step 18:

To Delete Record, Check the Checkbox and Click on the “DELETE” Button as shown in the below screenshot.

After clicking on the “Delete” Button, It will show an alert for Confirmation. Click “OK” Button to Delete Record from Module Mapping Configuration Listview.

Step 19:

On click of “Synchronize” link from the Email Software Integration Widget Page, Synchronize Edit View page will be open as shown in the below screenshots.

Step 20:

Select Email Software as Active Campaigns and List of Mapping modules. After that click on SYNC SUITECRM TO ACTIVE CAMPAIGNS Button as shown in the below screenshot.

Step 21:

Once you click on the SYNC SUITECRM TO ACTIVE CAMPAIGNS Button, all the matched Contacts as per conditions from SuiteCRM are synchronized in the Active Campaigns account as shown in the below screenshots.

Step 22:

After Synchronizing from SuiteCRM to Active Campaigns, Summary Report will be generated as shown in the below screenshot.

(Notes : In Summary Report number(count) of failed synchronizations of contacts will also be displayed if synchronization failure occurs.)

Step 23:

After Synchronization of Contacts, log is generated in the Email Software Integration Sync Log module as shown in the below screenshot. (Notes : In EMAIL SYNC LOG module number(count) of failed synchronizations of contacts will also be displayed if synchronization failure occurs. )

Step 24:

Now Go to Active Campaigns and add one Contact Manually and click the “Add” Button as shown in the below screenshot.

Step 25:

Go to Step-3 Synchronize page and click on SYNC ACTIVE CAMPAIGNS TO SUITECRM Button. All contacts from the Active Campaigns account will be synchronized to SuiteCRM as shown in the below screenshots.

Step 26:

After Completing Synchronization, summary report will be generated as shown in the below screenshot.

Step 27:

Check in SuiteCRM Contacts Module, all 3(2 Updated and 1 created) Contacts are successfully synchronized as shown in the below screenshot.

Step 28:

Also check in the Email Software Integration Sync Log module, log has been stored as shown in the below screenshots.

Step 29:

On click of “Automatic Synchronize” link from the Email Software Integration Widget Page, Automatic Synchronize List View page will be open as shown in the below screenshots.

Step 30:

On click of “CREATE” Link, Automatic Synchronize Configuration Page will be open as shown in the below screenshot.

Step 31:

Select Email Software, List Of Mapping Modules, Switch on Sync SuiteCRM To Active Campaigns and click on the Save Button. List view Page will display as shown in the below screenshot.

Step 32:

To Update Record, Click on the pencil icon from the Listview of Automatic Synchronize Configuration page as shown in the below Screenshot.

Step 33:

To Delete Record, Check the Checkbox and Click on the “DELETE” Button as shown in the below screenshot.

Step 34:

Now Create a new Contact in SuiteCRM based on Condition as shown in the below screenshot.

Step 35:

On click of Save, Contacts is auto synchronized in Active Campaigns Account as shown in the below screenshot. Check in the Active Campaigns account.

Step 36:

Also check in Email Software Integration Log Module, log is recorded for Automatic sync of contacts from SuiteCRM to Active Campaigns as shown in the below screenshot.

Step 37:

Open Contacts detail view in SuiteCRM and click on edit Button to update the record as shown in the below screenshot.

Step 38:

Update Last Name of the record and click on the SAVE Button as shown in the below screenshot.

Step 39:

Check in Active Campaigns, Contact record is updated as shown in the below screenshot.

Step 40:

Check log in Email Software Integration Sync Log module as shown in the below screenshot.

Step 41:

You can also Automatic Sync Records using Mass Update as shown in the below screenshot. (Notes : When records are imported from CSV at that time Automatic Sync records using Mass Update is most preferable)

After Selecting records, click on Mass Update from Bulk Action so mass update form will be open and Click on the Update Button from the mass update form and it’ll display an alert popup as shown in the below screenshot.

Step 42:

Check in Active Campaigns, Contact matched record(as per conditions) is updated as shown in the below screenshot.

Step 43:

Check log in Email Software Integration Sync Log module as shown in the below screenshot.

Step 44:

If Sync SuiteCRM to Active Campaigns is Enabled and you click on other sliders like Sync Active Campaigns To SuiteCRM and Sync Active Campaigns To SuiteCRM(Using Webhook) then it’ll show an alert message because at a time only one slider is enabled out of these three sliders as shown in the below screenshot.

Once you click on “Ok” Button from Alert Box then the previously enabled slider is disabled and the current slider will be enabled as shown in the below screenshot.

If you click on “Cancel” Button from Alert Box then no changes are applied for the current clickable slider as shown in the below screenshot.

Step 45:

Enable Switch Slider of Sync Active Campaigns To SuiteCRM and click on the Save Button as shown in the below screenshot.

(Notes : If Sync Active Campaigns To SuiteCRM is enabled then All Active Campaigns Contacts records will sync in SuiteCRM using Scheduler.)

Step 46:

Enable Switch Slider of Sync Active Campaigns To SuiteCRM(Webhook) and click on the Save Button as shown in the below screenshot.

If Sync SuiteCRM to Active Campaigns or Sync Active Campaigns to SuiteCRM is Enabled and you click on other sliders like Sync Active Campaigns To SuiteCRM(Webhook) then it’ll show an alert message because at a time only one slider is enabled out of these three sliders. Once you click on “Ok” Button from Alert Box then the previously enabled slider is disabled and the current slider will be enabled and If you click on “Cancel” Button from Alert Box then no changes are applied for the current clickable slider.

(Notes : If Sync Active Campaigns To SuiteCRM(Webhook) is enabled and setup Webhook in Active Campaigns for Contact added & Contact updated then All Active Campaigns Contacts records will sync in SuiteCRM while create or update records in Active Campaigns using Webhook.)

Step 47:

Go to Step-2 Module Mapping, add new Module Mapping for Target List, fill up required fields and Click on SYNC FIELDS Button to Save all Active Campaigns Contact list fields for future synchronization processes.

(Notes : If Batch Management is enabled and condition matched records is greater than or equal to 100 then record will sync based on Batch size once click on Sync SuiteCRM to Active Campaigns Button from Step 3 and other records will sync in backend using Scheduler.)

Once you click on the SYNC FIELDS Button, it will display an alert message as shown in the below screenshot.

Step 48:

After that click on the Next Button to move on Step 2 “Field Mapping”. Click on Add Mapping Button to Add Mapping between SuiteCRM Target List Fields and Active Campaigns Contacts List Fields then click on Next Button to apply Conditions for a particular module as shown in the below screenshot.

Step 49:

Once you click on the Next Button to move on Step 2 “Field Mapping”. Click on Add Mapping Button to Add Mapping between SuiteCRM Target List Fields and Active Campaigns Contacts List Fields then click on Next Button to apply Conditions for a particular module as shown in the below screenshot.

Step 50:

Add Conditions for a particular module and click on SAVE Button it will display List view of Module Mapping as shown in the below screenshot.

Step 51:

To Update Record, Click on the pencil icon from the Listview of API Configuration page as shown in the below Screenshot.

Step 52:

To Delete Record, Check the Checkbox and Click on the “DELETE” Button as shown in the below screenshot.

Step 53:

Now Create two Target List, also select related Contacts/Leads based on Module Mapping Configuration to that list in SuiteCRM as shown in the below screenshots.

Step 54:

Now Go to Step-3 Synchronize, Select Email Software as Active Campaigns, List of Mapping Modules and click on SYNC SUITECRM TO ACTIVE CAMPAIGNS Button as shown in the below screenshot.

Step 55:

Summary Report is generated as shown in the below screenshot.

Step 56:

Check in Active Campaigns account two Contact List has been created with related Contacts/Leads as shown in the below screenshot.

Step 57:

After Synchronization of Contacts List, log is generated in the Email Software Integration Sync Log module as shown in the below screenshot.

Step 58:

Now manually create a new List with related Contact in Active Campaigns account as shown in the below screenshots.

Step 59:

Now click on SYNC ACTIVE CAMPAIGNS TO SUITECRM Button and it’ll Generate Summary Reports as shown in the below screenshot.

Step 60:

Now check, new Target Lists with related Contacts/Leads are created in SuiteCRM as shown in the below screenshot.

Step 61:

After Synchronization of Contacts List, log is generated in the Email Software Integration Sync Log module as shown in the below screenshot.

Step 62:

Now Go to Step-4 Automatic Synchronize and select List of Mapping Modules for Contact List and save it as shown in the below screenshots.

(Notes : If Sync SuiteCRM to Active Campaigns is enabled then you can also do synchronization by clicking on save Button as well as using Mass Update.)

Step 63:

Now Create one new Target List in SuiteCRM and click on the SAVE Button and it’ll sync a particular list to Active Campaigns as shown in the below screenshot.

Step 64:

Also check in Email Software Integration Log Module, log is recorded for Automatic sync of Contacts List from SuiteCRM to Active Campaigns as shown in the below screenshot.

Step 65:

Now Update Target Lists in SuiteCRM and Save it as shown in the below screenshot.

Step 66:

Also check in Email Software Integration Log Module, log is recorded for Automatic sync of Contact List from SuiteCRM to Active Campaigns as shown in the below screenshot.

Step 67:

Enable Switch Slider of Sync Active Campaigns To SuiteCRM and click on the Save Button. List view Page will display as shown in the below screenshot.

(Notes : At a time only one slider is enabled out of these three sliders. If Sync Active Campaigns To SuiteCRM is enabled then All Active Campaigns Contact List records will sync in SuiteCRM using Scheduler.)

Step 68:

Enable Switch Slider of Sync Active Campaigns To SuiteCRM(Webhook) and click on the Save Button. List view Page will display as shown in the below screenshot.

(Notes : At a time only one slider is enabled out of these three sliders. If Sync Active Campaigns To SuiteCRM(Webhook) is enabled and setup Webhook in Active Campaigns for List added then All Active Campaigns Contact List records will sync in SuiteCRM while creating records in Active Campaigns using Webhook.)