Settings for the Salesforce integration

Salesforce integration makes it possible for you to bring the participant information that Lyyti has created automatically to Salesforce. You can create new leads and update existing leads and contacts.

Lyyti events should match to corresponding Salesforce campaigns and participants are added as campaign members. 

To activate the Salesforce integration you need to have sufficient rights (Salesforce Professional with API interface as an added service or Enterprise license).

You activate the integration by logging in to Salesforce from Lyyti with chosen Salesforce account. We recommend that you create a separate Salesforce account for the management of the integration. In this way the rights and settings are always up to date and following possible changes is easier.

You can always first create the integration to Salesforce Sandbox test environment and when everything is in order move the integration to the live account. Maybe try first with only one event.

The settings of the integration enable many different use cases. You can either create or not create new leads, you can import participants to Salesforce from Lyyti as leads or contacts and you can decide separately from each piece of information if it's updated to Salesforce or not.

 Activating the integration

I order to activate the integraation you need Main user rights in Lyyti. Settings can be found from the main menu under Admin section Settings--> Salesforce.

1) Activate the integration: If your organisation uses some other login address than https://login.salesforce.com (e.g. https://organisation.salesforce.com), click Customise authentication address. Then activate the integration by logging in with the chosen Salesforce account.  The activation works according to Salesforce logic, so if you need to change the Salesforce password every 30 days you also need to update the activation in Lyyti every 30 days.

2) Settings:

On the Settings tab you define how participants are exported to Salesforce. 

Exporting participants: Choose what statuses the participants can have to be exported from Lyyti to Salesforce. Then choose which campaign member status corresponds to which Lyyti status. The dropdown always shows all the statuses defined in Salesforce. 

Tip! Create a Salesforce campaign template where you create the statuses and always copy this template. In this way you don't have to create the statuses from scratch every time to a new campaign. Note! Campaign Member Statuses are copied only in the Classic view. In the Lightning view these must be added by hand. 

Managing participants: In this section you define how the participant information from Lyyti is managed in Salesforce. If you only want to see the status of such participants that are exported from Salesforce to Lyyti (and ignore participants that don't already exist in Salesforce) don't select the option Create new enrollments from Lyyti in Salesforce.

If you do want to create new leads or contacts from the participants select the option mentioned above. Then choose if the participants are shown in Salesforce as leads or contacts. In sales related events we recommend to use leads because it's easy to check their validity.

When you are using the open registration link and you want to recognise existing leads and contacts choose Link participants to existing contact or lead. The participants are primarily recognised from their email address and secondarily through their name.

Update object with Lyyti participant information: Choose this option if you want to update existing leads and contact with the information they give in the Lyyti registration page. The function can for example help you keep your customer register up to date. You can choose one by one what information is actually updated. 

3) Fields:

On Fields tab you define which fields in Lyyti and Salesforce match each other and what information is exported from Lyyti to Salesforce.

In the first column are the Salesforce fields (Lead, Contact and CampaingMember). In the second column you have Lyyti's standard questions and participant’s report fields. The information from these fields can be imported to Salesforce. If you have allowed the information to be updated to Salesforce here's where you can choose what information is really updated. 

You can also define a default setting for each field. This is a good idea when you want a specific information to be imported to Salesforce but you don't need to show the field to the participants in Lyyti's registration page.

You should also take some time to carefully think through the mandatory fields. If a field is mandatory in Salesforce but not in Lyyti, you shoudn't choose the information to be exported to Salesforce because if participants are missing that mandatory information they will not be imported to Salesforce. If possible it's best to keep the same fields mandatory in both Salesforce and Lyyti.  

4) Notifications

On Notifications tab you are shown such participants that couldn't be exported to Salesforce for some reason. Most common reason is that the participant is missing some mandatory information.