[New] Setting up Salesforce on the Hopin platform

  • Updated

organizers_only.jpgadvanced.png

image6.png

Before we get started...

Salesforce integrations are notoriously complex given the vast number of possible Salesforce configurations. To address this we have made our Salesforce integration as dynamic as possible, allowing you to map the objects and fields in your specific Salesforce configuration to Hopin.

Additionally, we have recently revamped our Salesforce<>Hopin App and so if you are using the previous version, you can take a look at the guide here.

Which plans is the Hopin<>Salesforce integration currently available on?

The Salesforce integration is available on Hopin's Pro, Business and Enterprise plans.
You can find an overview of our Hopin licenses on our pricing page, feel free to contact our sales team if you'd like to discuss an upgrade.

What are the capabilities of the Hopin<>Salesforce integration?

1. Export registrations from Hopin to a Salesforce object (optional).

2. Import registrations from Salesforce object into Hopin's invitation system (optional).

3. Synchronise Registration & Attendance status from Hopin to Salesforce.

4.Export custom registration Q&As.

Note: If you are using Salesforce to send your magic links, the Magic Links/Manage Invitations tab in the Event Dashboard will not update the ticket status to "Invited". You will need to use Salesforce to track if you have sent the invitations. However, once a registrant accepts their magic link, their Hopin magic link status will change to "Registered".

How often does the Hopin<>Salesforce integration sync?

The Salesforce integration syncs in real-time.

What data is being synced between Hopin<>Salesforce

We are currently syncing First Name, Last Name, Email, custom form questions between the platforms. We are actively working towards syncing the whole Registration Object (headline, website).

Integration guide

Note: When you click Connect on the Salesforce integration it will take you to a new screen that will take you through the authorization process and the setup of all the above workflows. You can skip any of the workflows by choosing the checkboxes of their respective functionalities, but you need to configure all the fields in all of the screens for any of the functionalities to work.

You'll need a Pro, Business or Enterprise plan to use the Salesforce integration.

Salesforce Setup:

To configure all the screens, you will need:

1. One object to store Event Information (e.g.- Campaign).

2. One object to store Registration Information (e.g.- Lead/Contact).

3. A junction object to store Event Registration Info (e.g.- Campaign Member).

If you want to use custom objects instead of the objects that were suggested above, you need to make sure that you have 2 objects (to store Event and Registration info) and 1 junction object (to store Event registration info). Please refer to this salesforce doc to create a junction object.

  • Exporting registrations from Hopin to a Salesforce object

    Find below what you'll need to do to enable this workflow.

    1. To get started, you will need to install the Salesforce app to your Hopin Organization. You can access the app store by going to your Organization Dashboard and heading to the Apps tab. Then click on Discover More on App Store. 

    Integrations-Hopin.png

    You can find Salesforce under the CRM category, or you can follow this link to go directly to the page. Click Install app to add the Salesforce app to your Organization.

    salesforce.png

     

    2. Login to Salesforce when prompted.

    image8.png


    3. Once authentication is successful click Next.

    image7.png

    4. On the next screen you will find the various events, from both Hopin to Salesforce and from Salesforce to Hopin, please select the checkboxes based on the functionalities you require. Once selected click Next to proceed. These are the options available:

    • Import Registrations: Imports registrations from salesforce to Hopin, creates a magic link and updates the magic link back in salesforce for each registration.
    • Export Registrations: Exports Registrations from Hopin to Salesforce and sets their status as ‘Registered’ in salesforce once they register for the event.
    • Export Custom Registrations Q&As: Exports Registrations from Hopin to Salesforce and sets their status as ‘Registered’ in salesforce and also exports the Custom Registrations Qs & As for the respective registrant if you have configured questions for your event in Hopin.
    • Export Attendee status: Exports Registrations from Hopin to Salesforce and sets their status as ‘Attended in salesforce once they attend the event.

    image8.png

    5. On the next screen you will need to configure the object where event information is stored.

    Select the object and wait for 2-3 secs. You will then see a mapping screen where you need to map fields that would contain the Hopin's ticket integration code and Event Name. This Hopin's ticket integration code allows us to correctly map your Salesforce registrations to the correct Hopin event and ticket. The code should be at the event level in Salesforce (e.g., at the Campaign level).

    In the example below, we have used the Campaign object to store event information, and we have added a ticket integration code field to the Campaign, on which Campaign Members (registrants) are created. If you have multiple tickets for the same event you can create that field as a picklist field.

    image12.png

    The integration code can be added to any object that is used for events. Return to the 'Import registrations' screen and choose the Salesforce object that contains the 'integration code' field.

    image20.png

    If you do not need the functionalities of Export Registrations/Export Attendance/Export custom Registrations, you do not need to configure the field for Event Name.

    Once configured click on Next to proceed.

    6. On the next screen, you will need to configure the object where registration information is stored, and map the fields that would contain the first name, last name and email of the person/registrant who would be attending the event. In the example below, we have used Lead object to store registrant information and have mapped the fields accordingly. You can also use contact object or any custom object. Click on Next to proceed.

    image15.png

    7. On the next screen select your 'Event registration' object in Salesforce (in this example we've used the Campaign Member as an event registration object) and map the Hopin fields to the correct fields on that object. Here's what they mean:

    • First Name: Please select the field where we can find the first name of the registration.
      Last Name:
      Please select the field where we can find the last name of the registration.
      Email :
      Please select the field where we can find the email of the registration.
    • Magic Link: The field is required to be able to pass a magic link back to Salesforce. Please make sure the selected fields as length of minimum 100. If you wish to send your magic link emails from Hopin and not from Salesforce, you don't need to complete the mapping of this field.
    • Salesforce Event Object: This field should contain the object ID of the Map Event screen (the Campaign ID in this case).
    • Salesforce Registrant Object: This field should contain the object ID of the Map Registrant screen (the Lead ID in this case).
    • Headline: If you want to have headline information to be captured during magic link creation configure a field for it.
    • Status: If you want functionality for Export Registrations/Attendee/Custom functionalities map the field for status. If it is a picklist field, make sure that it has picklist options of ‘Registered’ & ‘Attended’.

    image5.png

    8. Click Next to proceed

    9. If you have selected the checkbox to Export Registration & Custom Registrations Q&As in Screen 2, and you have created a Custom Registration Form for your event on Hopin, wait for 1-3 sec you will find a mapping screen where you can map the Custom registration questions to salesforce fields.

    The fields provided in the dropdown menus are based on the object that is selected on the previous ‘Configure Event Registration Object’ screen and if you have also configured fields under the object map the custom registration questions to respective fields.

    Tip: You can use the same questions between two or more events by simply making sure it is written correctly in each event.

    image14.png

    10. Click Finish.

  • Testing the Salesforce integration

    Now we can test the integration.

    1. You'll need to have a Hopin event set up with at least one ticket created.

    In your event on Hopin, go to your Event Dashboard > Registration > Tickets and find the ticket’s integration code. Copy the link to the ticket by clicking on the small square next to the ticket name and paste it into a browser tab.

    image16.png

    The end of the URL (after the =) is your integration code.

    image17.png

    2. Go to Salesforce and create a new record under your ‘Event’ object (in our example, the Campaign), and add the 'Integration Code' you just copied to the field that you created in your Salesforce object for the ticket integration code.

    image18.png

    3. Create a new 'registration' in Salesforce (in our case, a Campaign Member).

    image19.png

    4. Navigate back to your Hopin account, and the registration should be imported into the 'Magic Link Invites' page under 'People > Magic Link Invites'.

    image20.png

    5. Return to Salesforce, and the magic link field that you created on your 'registration' object should be populated with the magic link:

    image21.png

    Exporting registrations

    If you'd like to test a registration export, you can follow the below steps.

    1. First, you can create a registration form in Hopin to check that it's pushed into salesforce.
    image22.png

    2. Register for the event in the registration page (if you have already registered with your account, you can de-register yourself in the 'Attendees' page).

    image1.png

    3. You're now registered for your event, and you can go and check that this has been pushed to Salesforce correctly and has set the status to Registered. Also, if you have configured the mapping for Custom registration Q&A you can see that if the question is answered by the registrant, then it will map to the respective fields configured on the record in salesforce.

    image2.png

    4. If the same person attends the event the status would be set to Attended.

    image3.png

Things to consider

Please note that in order for data to be updated from Salesforce to Hopin and back again, Salesforce has a few settings that need to be taken into consideration:

  1. If you are using Pardot with Confirmed Opt-In Process to add data to your Salesforce instance, please read this article about the steps that need to be taken
  2. If you are using a Data Import Wizard in Salesforce, please note that Workflow Executions are disabled by default, and you will need to enable this in the wizard.
  3. If you are using Salesforce integrations that modify your data (Pardot/LeanData/etc.), please make sure that the automation users (which those integrations need in order to function) have the "Send Outbound Messages" permission enabled at the account level.

 

Was this article helpful?