Superoffice integration

With the SuperOffice integration, you can import selections to Lyyti events, as well as export participant data from Lyyti to SuperOffice. The integration creates new Persons from Lyyti event participants, or connects participants to existing Persons/Contacts in SuperOffice if the email addresses match on both ends. The integration also creates new Projects per each Lyyti event, if exporting to SuperOffice is selected in the event.

Connecting the integration

In order to connect the integration, you need to have Admin user rights in Lyyti. The integration is always connected to a Lyyti company, and the settings apply to the whole company too. Here are the required steps:

1. Find SuperOffice Settings under your company settings (click on your company name on the top right corner)
   
   
   
   
    
2. On the SuperOffice Settings page, click on "Activate integration".
   
   
    
3. Once redirected to SuperOffice's login page, log in with your SuperOffice username and password
   
   
   
4. After returning back to Lyyti, you'll see that the integration is now active
   
   

Configuring the integration

After successfully connecting the integration, you can configure integration settings and fields.

Settings tab: set defaults

1. Default Project Type: select a default project type for your new projects that are created from Lyyti events
2. Default Project Status:  select a default status for projects that are created from Lyyti events
3. Create new Contact (Company) for new Persons: decide whether or not you want the integration to also create a contact in SuperOffice, when a new Person is created.
   
   TICKED: if you don't yet have a Company in SuperOffice, the integration will create one and assign ContactIDs for Persons
   
   UNTICKED: New Persons are created without ContactID, and they are sent to the "Default Selection" defined in step 3

Selections tab: select a default selection for orphan participants created in SuperOffice from Lyyti event participants (Persons without a ContactID

1. Current: the selection currently used for Orphan participants
2. Search for a selection: write at least three characters --> select a Selection --> Save

Fields tab: connect Lyyti standard questions to fields under SuperOffice's Person object
 

1. SuperOffice Field: list of fields under the connected SuperOffice environment's Person object
2. Update: tick this checkbox field-by-field, when you want the integration to overwrite the connected field in SuperOffice for an existing Person/Contact with the participant's answer given in Lyyti event to the connected standard question.
3. Lyyti Field: select a standard question to be mapped to a SuperOffice Field
4. Default: if a participant doesn't provide an answer to the connected standard question, or the question is hidden on Lyyti's registration page, you can define a default value that is set for the connected SuperOffice field for eact Person/Contact

Connecting an event to SuperOffice

Once you've set everything up, it's time to connect the event to SuperOffice. 

1. Navigate to "Event information" under "Event" on the left hand side menu in your Lyyti event
2. Tick the checkbox for "Export to SuperOffice"
3. A new project will be created in SuperOffice, which is connected to your Lyyti event. Participants will be exported to this newly created selection based on the company's SuperOffice integration settings.

Importing a Selection from SuperOffice to a Lyyti event

You can import participants from a selection to an event in Lyyti. The feature is found on the Participants page within each Lyyti event. 

NOTE 1: Importing from a selection is possible only if you've first ticked the "Export to SuperOffice" checkbox in your event

NOTE 2: The import will skip all Selection members who haven't given consent to e-marketing in SuperOffice.

1. Navigate to the Participants page in a Lyyti event
   
   
    
2. Click on "Add participants" and select "Add from SuperOffice"
   
   
    
3. First, search SuperOffice selections (minimum of three characters are required for the search to function)
   
   
    
4. Second, select the Selection from the drop-down menu below and click on "Import participants"
   
   
5. Lyyti will show an informative pop-up of the results of your import:
   
   
   
   1. Total in selection: how many members there are in total in the selection 
   2. Imported: how many members were imported as participants in Lyyti
   3. Skipped (no consent): how many members were skipped because they haven't given e-marketing consent in SuperOffice
   4. How many members were skipped, because they already exist as participants in the Lyyti event (based on email address)
    
6. Navigate back to the Participants page, and you'll see a list of newly created participants