Import Registrant Data from Salesforce to Zuddl

Salesforce is a CRM that equips sales, marketing, service teams, and the admin team with the customer information required to administer its interaction with them. The Salesforce - Zuddl integration lets you import campaign members in Salesforce as a registrant to a Zuddl event/webinar.


Integration

The Salesforce integration can be split into two main steps:

  • Global-level integration - Installing Salesforce
  • Event-level integration

Prerequisite

If your organization requires you to create a special user with required permissions for integration purposes, you need to create an API-only user profile in your Salesforce with Modify All Data or Modify All permissions. Learn how to create an API-only user profile.

Install the app

The following steps show how to install Salesforce on Zuddl.

If you’ve already installed the Salesforce integration to export Zuddl registrants to Salesforce, you can skip this step.

On the Zuddl common dashboard,

  1. Click on Integrations on the left navigation.
  2. On the Salesforce card, click on View Details button.
  3. Inside the Salesforce integration details page, click Install app.
  4. On the Salesforce authentication window, click on New authentication.
  5. On the Create a new authentication page, enter the following details and click Create.
    1. Your authentication name: A unique name for you and Zuddl to identify your authentication.
    2. Salesforce instance type: Select either Production or Sandbox to authenticate your Salesforce production or sandbox instance with Zuddl. Use the Sandbox instance to test out the integration and later authenticate your production instance.

      Create a New Auth.png

      If you wish to test out the integration on your sandbox instance, for the first time you can authenticate by selecting the Sandbox instance. Later, if you wish to connect your Salesforce production instance, you need to uninstall app and re-Install app to (from the common dashboard) create a new authentication for your Production instance.

  6. On the consent screen, click Allow to grant access to the required permissions.

    Consent Page.png

  7. In the Lead Source field, enter a value for the lead source in Salesforce whenever a lead is created through the integration. Defaults to Events.  You can change it to ‘Webinar’ as required.

    Lead Source.png


  8. Click Finish. This creates the authentication for your Salesforce instance.

Once the installation is done and the authentication is successful. You must set up the event-level integration for every event/webinar individually to establish this data flow.

How it works

The Salesforce to Zuddl integration requires a Salesforce Campaign in order to import campaign members as registrants into a Zuddl event/webinar. You can link any Salesforce campaign to a Zuddl event/webinar for the integration to import registrants from. You can add multiple campaigns as the source, the integration imports all the campaign members as registrants to your Zuddl event/webinar.

The registrants appear in People > Attendees with the status “Registered”.


Note:

  • The integration imports all the existing members and new members added to the Campaign as registrations into Zuddl.
  • The integration does not import any registrant email address from Salesforce that already exists in the Zuddl event/webinar.

Event-level integration

Warning

Before you enable the event-level integration, ensure that the “Event invitation” email for attendees has been toggled on from the Communication menu. Without this enablement, registrants will not receive any event invitation.  

Event Invitation.png

Learn how to set up email communication for your event.

Learn how to set up email communication for your webinar


In Salesforce, you can leverage the Campaigns object to track event-level data that comes from Zuddl. A Zuddl event/webinar must be tied to a Salesforce campaign to receive registrant details. A campaign ID is used to link a Zuddl event/webinar with a Salesforce campaign.

  1. Inside the Zuddl dashboard, go to Integrations.
  2. On the Salesforce integration card, click Customize in the Import section. The Import section shows a Disabled status before turning on the integration.

    Import.png

  3. Toggle on the integration. This enables the integration settings.

    Sync Now Button.png

    A new Lead in Salesforce is added as event/webinar registrant in Zuddl. Under the Lead custom fields tab, map any custom Lead fields in Salesforce to suitable custom fields in your Zuddl registration form.

    Prerequisite

    A Zuddl registration form with all the required fields must be created before you start with the mapping.

    • Select a custom field in the Zuddl registration fields dropdown.
    • Choose a suitable Lead field from the Lead fields dropdown.
    • Lead Custom Field Options.png

  4. Click +Add field to add map more fields in the same way.
  5. Click Save.

    For the registrants that have been already synced to Zuddl, it is important to map the custom Contact fields in Salesforce to custom registration form fields in Zuddl to ensure that updated field values are passed to your event/webinar.

    You can also pass campaign member fields to Zuddl using this mapping.

    Under the Contact custom fields tab, map any custom fields added to your Salesforce instance to suitable registration form fields in Zuddl.  

    Prerequisite:

    A Zuddl registration form with all the required fields must be created before you start with the mapping.

    • Select a field in the Contact fields dropdown.
    • Choose a suitable custom field from the Zuddl registration fields dropdown.

    • Contact Custom Field Options.png

  6. Click +Add field to add map more fields in the same way.
  7. Click Save.
  8. Next, on your Salesforce instances, go to the campaign page. The URL of the campaign page contains the campaign ID. Copy the campaign ID from the Salesforce URL.

    Campaign ID.png

  9. Paste the copied campaign ID on the Campaign ID field and click Save.

    Enter Campaign ID.png

All existing members of the campaign and all new members added to the campaign are added to the Zuddl event/webinar as registrants.

Note:

  1. Ensure that both Zuddl and Salesforce object fields have compatible data types. If fields with incorrect data types are mapped, there could be a loss in data.
  2. Once the integration is turned on, the integration status changes to Active on the Import section as shown below.

Integration Active.png

More options

For each campaign Id, there are additional options as explained below:

  • Edit: This option lets you edit a previously entered campaign Id. This stops importing campaign members from the old campaign and starts from the other campaign. The registrant imported so far by the previous campaign Id does not get deleted.
  • Delete: This deletes the campaign and stops importing from the same. Deleting a campaign from Salesforce does delete the existing registrants in Zuddl.