iContact

Last synced 3 months ago by Aron Gosselin

GETTING STARTED GUIDE: How to set up a new connection?
ALL FEATURES EXPLAINED: All our features/functionality explained in detail - no app-specifics.

iContact is email marketing app, that allows you to create, send, segment and track emails. iContact makes it easy for SMEs to choose from their collection of results-orientated features to suit any budget.

Supported iContact Integrations

Step 1: Choose your apps

In setting up a sync connection, you first choose the apps that contain the contacts data you need synced. We have provided a handy search bar to quickly get to the apps you're looking for. After you select the first app, you immediately proceed to select the second app. We will connect to these apps in a second step.

Step 2: Authorize your apps

In order to use PieSync, you need to have registered accounts with the apps you selected. At this point, you'll need to connect PieSync to these apps so we can fetch the contacts data configuration. You do this for both apps. Below you can find the authorization process for iContact, the instructions for the other app will appear on screen, or consult them separately on this page.

Authorizing iContact
  1. To be able to connect to your iContact account, we need you to grant PieSync access to your data. In order to do this, go to this link in your iContact application and enter 19ef0dc6e6e211ddae813605715932cc as Application ID. Provide the password that you've entered below.
  1. Next to that, we would also require your iContact username, typically an email address, which you use to log into your application.
  2. Choose the iContact account you want to sync with.


  1. If you logged in using an agency account, choose the iContact Client Folder you want to sync with. Not an agency? Just click next.


If you have previously set up a connection with any of these apps, you do not need to go through these steps again, unless you need a different iContact account or folder.

For iContact PRO clients, you will need to migrate to the new iContact PRO platform before activating your PieSync integration. For more info, please contact your Strategic Advisor or iContact Support.

Step 3: Choose your contact type

Choose whether you want to sync Contacts or Leads. The availability to sync Leads depends on whether your app supports multiple contact entities (e.g. Salesforce, Copper, ZohoCRM,..).

If you want to sync multiple contact types, you can do this by setting up another connection with the same applications.

Step 4: Configure your sync

Once you authorized  2 apps, you tell PieSync how we should keep your contacts data in sync. By default, PieSync proposes a two-way sync with a drop-down to allow for one-way syncs (do I need one-way or two-way?).

A two-way sync starts off with 2 rules. Each rule fulfills the conditions of each side of the sync. PieSync looks at all the data stored on each side, so you can define exactly what data needs to move from one side to the other.

If you need a simple all-to-all sync, this is all you need to set up (ie. don't change anything to the default setup). Starter plans are limited to two of these rules, but the Pro plan and onward allow for more.

Through PieSync you can and you should tweak the sync so that not only contacts get synced, but you also respect the segmentation, tags, groups, categories, custom attributes, subscription status, ... of the apps that the contacts live in. In a PieSync rule, you can choose to add a filter and add actions to syncs. 

What you can do depends from app to app. Typically, in the if-clause you define a segment of your contacts. In the then-clause, you perform actions such as adding the contacts to the counterpart of that same segment in the other app. Combine this with other actions you can perform as a result of a sync, and the possibilities are truly endless.

[IF] Supported Conditions/Filters
  • in List (Subscribed, Pending, Unsubscribed)…
  • not in List…
  • Status in List equals…
  • Status in List does not equal…
  • Contact Status…
  • Added On…
  • Bounce Count…
  • Business…
  • Contact ID…
  • Email Address…
  • Fax…
  • First Name…
  • Last Name…
  • Phone…
  • Prefix…
  • Suffix…
  • Custom fields...
  • in connected app...

[THEN] Supported Actions
  • add to List…
  • set Contact Status to 'Do Not Contact' 
  • set Status in List to Unsubscribed 
  • update Business…
  • update Email Address…
  • update Fax…
  • update First Name…
  • update Last Name…
  • update Phone…
  • update Prefix…
  • update Suffix…
  • update custom fields

Sync options

In addition to setting up sync rules, PieSyncs presents a series of app-dependent options. These include: 

  • a toggle to help avoid duplicates - possibly hard-coded by default
  • you should choose your master app so that during the initial sync, conflicting changes can be resolved. if iContact is empty at the time of syncing, there will be no conflicts.
Mappings

A contact is more than just a name and an email address. There are other contacts attributes too that can be carefully mapped with one another in a sync. 

  • PieSync's default field mapping shows you default fields we will always keep in sync and details how we mapped them between the two apps you have connected. You cannot change these fields.
  • In the custom field mapping, you'll be able to map fields stored in your apps that we didn't find logical counterparts for. This includes default fields as well as custom fields. The customizable field mapping is set up and shown in the white part below the default field mapping in the configuration. You can add an unlimited amount of mappings and remove, enable/disable them anytime. 


Syncing back the contact status or list membership status

You have the ability to sync back the contact status into your CRM. An easy way to do this would by setting up a direct mapping from the Contact status field into a custom text field over in your other app. Here, the field on the right is a custom text field which will populate with a simple text label "Normal, Bounced, DNC, Pending, Invitable".

There are CRM's that can take in that piece of text that in turn trigger workflows if this is what you need to happen. However, you can also have PieSync directly change certain attributes based on what is happening inside of iContact. This would require setting up specific filters or actions from the PieSync Rules like so:

For this particular case, we update an Accepts Mailing field in Salesforce but it's up to you to decide what should happen in your CRM. Syncing to Salesforce? We have compiled some typical setups.
Starting your sync

Make sure no other integrations are running next to PieSync for the accounts you have connected in PieSync. Other integrations will have access to your data and have the ability to manipulate as well. For this reason, we kindly ask you to use PieSync and nothing else to keep your data in sync. Other integrations running in parallel with PieSync are a no-go!

In case you have a lot of contacts in your applications, the initial sync will take some time, even if you configured PieSync only to sync a subset of your contacts. During the initial scan, we need to process all of your contacts (also the contacts outside the chosen subset) to avoid duplicates during the sync. After the initial sync, it should never take much longer than five minutes for updates to show.

Step 5: Monitor your connection in the Dashboard

Once the connection is running, the activity monitor will be your real-time view into PieSync's operations. It provides insight into: 

  • new contacts being created from your first app to your second app that didn't exist yet
  • new contacts being created from your second app to your first app that didn't exist yet (if you did a 2-way sync)
  • updates made to contacts that had been synced & matched up before: the update is now also synced up
  • whether your synchronization is active or not - you can pause the connection should you so wish

Thanks to the feedback we have already received, we created a list of popular apps that we’re going to work on very soon. By  voting them up in our pipeline, YOU decide which connectors we’ll release first. If you don’t see your app on the list or need any further help, drop us a line - support@piesync.com.  Don't forget to read our blog for the latest in productivity, apps, and technology!


How did we do?


Powered by HelpDocs