Platform Integrations Setup Guides

Here we will go through the available plugins in our CMS allowing for easy integration with 3rd party solutions you may be using.

Introduction to the integration options (Video)

Registration Platforms with existing API Integration 

Each come with a step by step guide in this chapter. If you need further support please contact live chat or your dedicated Project Manager. 

Export & Import

Simply export your registrant list from your registration platform and import list into the CrowdComms Platform 

import.png

Create an API integration with the CrowdComms Event Platform 

  • Setup API Integration using our public api - https://papi.crowdcomms.com/
  • This will require development work from the registration platform. All the details are outlined on the Public API including end points and how to create the required integrations 

papi.png

Use Zapier to build integrations with supported apps

Steps to setup Zapier integration: 

Note: CrowdComms provide an in platform registration offering, along with integrations with a number of leading registration providers. Zapier is an option for customers to self manage integrations with their preferred platforms where an integration does not currently exist and import / export is not suitable. 

zapier.png

Custom Integration
In order to investigate any custom integration, please send the below information for the required platform integration. 

Please note custom integrations are not always possible and the above information will be required to explore feasibility, costs and timelines. Custom integrations will be considered and if appropriate scheduled taking into consideration existing development commitments. Any custom integration can take significant time and requires extensive testing in order to implement. 

Eventsforce Integration Setup Guide

Before you can connect your event to CrowdComms, you will need to generate an API user within your Eventsforce account, and generate an API key. Instructions on how to do this can be found here:

If you find you have any trouble with the setup, then you will need to get assistance from Eventsforce direct before we can start the setup with our platform. To do this, you can start a chat with an Eventsforce support agent from within your admin area.

From our side, please note that our system only allows group names up to 50 characters long. So you will need to bear this in mind with your fields that you wish to pull through into cc groups

Please note: You need to make sure that within Eventsforce all your custom fields are set up to apply to 'this event only'. If you set them up as 'available to all events' then they will count as event-spanning, aka profile level questions. They are then carried within your Eventsforce profile as Custom Data. This will NOT pull through via the API, which only pulls through your event specific registration data, so please make sure your questions and answers are correctly configured before setting up your API. 

We don't filter the registration or payment status when requesting the attendees from Eventsforce. However, the Eventsforce API states that if no registration status is specified, by default it will only return complete registrations. Therefore, we will only get complete registrations pull through to the CrowdComms cms. If you need further information on this, please refer to their documentation here.

Connecting EF to CrowdComms

  1. Log into the CrowdComms dashboard with your Credentials
  2. Click to edit the app that requires integration
  3. Click on “Plugins” at the very bottom of the left hand menu

    Picture1.png
  4. Click on the “eventsforce” Tile

    Picture2.png

  5. Enter the following.
    - Client I.D
    - Event I.D
    - API Key
  1. Click “Save”

Automatic Field Mapping

The above steps may be all you need to do depending on the fields set up on your reg form. The following information will pull across as standard:

Attendee Information:

Sessions set up in eventsforce will pull into a new agenda module in CrowdComms, so you won’t need to create one. The session details which pull across are:

Abstracts are also added to the sessions as documents

Custom Field Mapping

Now that the EF connection details have been inputted & saved, you can now click on the “Custom Fields” TAB to input any custom fields required.

  1. Click on the “Custom Field” TAB

    Picture3.png

  2. Click on “Create New”

    Picture4.png

  3. Enter the Name of the EF Field required to be pulled through

    Picture5.png

  4. Select the type (Custom Field or People Group)

    Picture6.png

  5. Select the exact group/field to be mapped. Which drop down is available as to select here will depend on which ‘type’ you selected in step 4.

    Picture7.png

  6. Click “Create” (You will now receive a message to say if the field mapping has been saved or not)

    Picture8.png

  7. Repeat the process as necessary

Notes

Picture9.png

 

IDLoom Integration Setup Guide

Please note: This is a self-service guide for when setting up your own idloom account with our platform. These instructions will not apply if we have set up registration for you in our CrowdComms account. In that case please speak to your support agent who can set it up for you.

There are two main elements to setting up your integration with idloom. Part one is within the IDLoom CMS itself, where you will create the integration. This will generate your API key. The second part, is within the CrowdComms CMS, where you will link the integration and relevant event to the platform.

IDLoom Setup

You will want to do this one you have your event all set and ready to go.

Step 1 – Navigate to the Integrations tab (the one that looks like </>)

  1. Click to 'add integration' and select 'custom integration' from the box that pops up
  2. Fill in the name
    N.B. this will usually be the name of the event but it doesn’t matter what you call it
  3. In the box for ‘Available for profiles’ select the profile that your event is set to
  4. Check the boxes for ‘Allow API access’ and ‘Activate webhooks’
  5. Click save – this will then generate your API key

Screenshot 2022-07-26 105252.png

N.B. Once you click save, you will see both your API key and your account name. It would be good to make a note of this at this point, or do the next steps in a new tab so you can easily access all the bits you need.

Step 2 – Navigate to your profile

  1. Go to geeks – integrations
  2. Click the toggle to set your integration to 'active'

    Screenshot 2022-07-22 220224.png

  3. Press save

Step 3 - Navigate to your event

  1. Go to ‘Analytics & tracking’ to get the ‘Event UID’

    Capture10.PNG

    N.B. Make a note of this, as well as your event name as written in the idloom CMS, or again leave this tab open.

CrowdComms CMS

Now go to the corresponding platform in the CC dashboard and follow these steps:

  1. Go to plugins – idloom
    N.B The ‘idloom account’ and ‘idloom server’ information will be pre-filled with our CrowdComms account data. You will need to override this with your own. Please fill in your account name and server info (the server will always be idloom.events)
  2. Enter your API key

    Capture11.PNG
  3. Press save

Automatic Field Mapping

The following fields will map across by default:

Title –> Title
First Name –> First Name
Last Name –> Last name
Email –> Email
Job Title –> Job title
Company name –> Company
Phone/Mobile number –> Phone number

N.B. Your information will only map across automatically if using the default idloom fields for this information.
If you create a new custom field and just call it 'first name' or 'company' for example, the system will not automatically know where you want to map this to. All custom fields will need to be mapped manually. If you are unsure if you have used a default field or created a new one, the easiest way to check is by toggling on 'display field names'

Screenshot 2022-10-17 083943.png

All default fields will display the name, whereas fields you have created will all say 'free_fieldX' with x being a number that will change depending on where in your list of additional fields created it is.

N.B All other default CrowdComms fields can be mapped into, e.g ‘About’, ‘Address’ and all social media fields if required (perhaps as a way of getting speakers to self-populate their profiles), it just means you have to manually map them using the CMS. Any other form fields/questions will also need to be set up as custom fields in the CrowdComms CMS before you can map them

Key Considerations
The mapping between the default fields is hardcoded and therefore no other idloom fields can be mapped into them. You will need to consider this if you want these fields displayed under a different name in CrowdComms. An example would be if you want the company name to display under ‘organisation’ rather than ‘company’. You have 2 options here, either create a custom field in idloom with a corresponding custom field in CrowdComms, and link them. Or you would use the default field in idloom (as you can re-name them) but bearing in mind this would pull into the company field in CrowdComms. To change this, this would be part of a custom design request that you would need to check with your support manager. We could then get this changed on our end via custom design. We would only advise using this second option, if it is key to have this field visible under a person’s profile from within the main people list, rather than having to click in to see all custom fields. So please weigh up the best setup for your specific event.

  1. Click on the ‘Events’ tab at the top which should now have become selectable from completing step 3.

    Capture.PNG

  2. Fill out your event ID (UID) and event name as found on the ‘analytics & tracking’ section within your event – geeks.
  3. Click save
    N.B. This will then add the integration to the platform.

    Capture2.PNG

  4. Click the pencil icon to map custom fields
  5. Select the ‘Default People Group’ top right that you would like registrants to pull into if required. (If blank they will default to the ‘everyone’ group).

    Capture3.PNG

    N.B. If no custom fields are required, then setup is now complete. Otherwise, please continue as below.

  6. Under ‘Field Integrations’ click ‘create new’ to begin mapping custom fields
    N.B At the top of this section it says ‘idloom field’ or ‘idloom field’. For the moment please ignore the second box of the same name, as this needs to be updated by the devs. The first box will have a drop down of all fields, categories and options on your registration form.

    Capture4.PNG

  7. Select your field/category/option from the list
    N.B. With the country field, because of a change on idloom’s end this will now only pull through the country code by default. If you need the whole name to pull across you will have to speak to your support manager as this will require a bespoke setup we will need to do for you.

  8. On the line below, choose where you want to map it to by finding the corresponding box for the field/category/option you chose. i.e if you chose to map a field, then you can now only select options from the profile field or custom field boxes.
    N.B. idloom fields can only map to cc fields (profile and custom depending on what’s relevant) and categories and options can only map to sessions or groups.

    Capture5.PNG

  9. If your field is a tickbox, then also remember to tick this box. This is required as idloom will send the information through as binary i.e. a 1 or a 0 and ticking this box will turn it into a yes/no.

    Capture12.PNG

Useful Information
  1. Registration status: Canceled, Rejected, Not coming, To contact
  2. Payment status: Waiting for payment, Canceled
Troubleshooting

Errors in the cms

Data not pulling


Zoom Integration Setup Guide

Streaming Zoom into CrowdComms

If you prefer to live stream a Zoom session straight into the CrowdComms video player which benefits from recording the session on demand in the CrowdComms video library, you can see steps to live stream Zoom here. Details on how to use the CrowdComms live stream module can be found here, this supports being able to include a stream from Zoom.

This is an alternative approach that bypasses the integration between CrowdComms and Zoom and uses stream keys to host the Zoom meeting in the CrowdComms platform. 

Zoom Integration Guide

This guide covers how to integrate your Zoom account to link both your Zoom Meetings and Zoom Webinars to seamlessly sit within the CrowdComms player. Please note, you can run a maximum of two parallel Zoom sessions at once using the integration.

Important: Zoom integration requires the sessions and webinars to be recorded on Zoom. The recordings will not automatically be available in the CrowdComms video library, however the Zoom recording can be uploaded after the session to the CrowdComms video library for on demand viewing. 

To integrate Zoom into our platform, you will need access to the following; 

The Zoom API and Client SDKs are not available to Basic Accounts. If you have a basic account and want to set up an integration with our platform, you will need to speak to Zoom directly to discuss upgrading your account. If you are not the account owner or an admin on the account, you may also need to check that you have been given developer privileges.


Step 1. Zoom Developer Platform
  1. Once you are logged into Zoom Marketplace, you will need to navigate to ‘Develop’ at the top right-hand menu of the page and click ‘Build App’ from the dropdown.

Screenshot 2023-05-30 at 11.58.03.png










2. You will be brought to the Basic Information Page, select 'Admin-Managed' for how the app is managed. 

3. Please note the Client ID and the Client Secret to paste into the CMS later.

4. Add the following redirect URL: https://api-cms.crowdcomms.com/cms/integrations/zoom/redirect-callback/

5. Click continue until you reach the 'Embed' page Toggle on Meeting SDK and click continue.

6. You will then be brough to the 'Scopes' page, click the plus to 'add scope'. Select the following options


image.png


7. Click 'Continue'

8. Now the app should be configured for integration. Scheduling the meetings/webinars to be imported into the CrowdComms platform will be done through the normal Zoom process.

Please note: As the integration is set up by one central person's Zoom account, we recommend using the 'alternative hosts' option, so that whoever is running each specific meeting is able to start it. You will need to then communicate the meeting link with them as you would outside of the platform.


Step 2. CMS

1. Log into the CrowdComms CMS Dashboard with your credentials.
2. Select the App you wish to create the Zoom integration.
3. Click on Integrations
4. Then, click on Zoom

Screenshot 2023-05-30 at 13.06.53.png

If you have an existing integration, created via the old integration setup using JWT keys, you do not need to unlink your integration. To avoid losing existing data, simply update the Client ID and Client Secret fields using the new credentials obtained in Step 1 and click 'Save changes'

5. Paste the Client ID (API Key) and Client Secret (API Secret) you took note of earlier
Please note: If you forgot to make a note of this earlier, you can go back to the developer platform and find them here.
6. Click on 'Authorise' 
Please note: Your browser will need to allow popups in order for the authorisation to work. This is to generate the success message. Without this, the CMS will generate an error and you won't be able to import your meetings.
7. You will receive a successful authorisation message (If authentication has failed, see troubleshooting section) 
8. Click on 'Libraries' 
9. Click on 'Zoom meetings and Webinars'

SG1.png

10. Click on 'Import Events' and choose to either Import Meetings or Import Webinars

SG2.png

11. Select the meeting(s) and or Webinar(s) you wish to import (Example shown for Import meetings)

SG3.png

12. Click 'Submit' (At this point, you can select the pencil edit icon to edit a meeting/Webinar. You can update the title, add a Poster image and/or change the description - this change will only be visible in CC)

SG4.png

13. Click on 'Modules' 
14. Click on 'Agenda' 
15. Select your agenda session and click on the 'Edit' icon 
16. Click on the 'Features' tab

SG5.png

17. Within Content Features, use the drop-down menu under 'select a zoom webinar' or 'select a zoom meeting' to select your webinar/meeting

SG6.png

18. Click 'Save Changes'. Your integration is now set up and ready to test via the front-end Event App.

SG8.png


Step 3. Event App Platform
  1. Log into FE (Front-end) using your credentials 
    2. Go to the Agenda module 
    3. Click on the meeting/Webinar (NOTE; if you are hosting the meeting/Webinar, you will need to return to Zoom to start the session) 
    4. Click on "Join meeting"

We advise that hosts join ONLY via zoom as normal to avoid any feedback loops/repeated audio. Zoom session details should be pre-filled for participants, allowing them to join the session.

FE-Join.PNG

The host will have to start the meeting before anyone else is let in the meeting, and zoom controls on microphones and cameras etc will be there also, same as normal. Once the session is over you can simply 'leave meeting' in the usual fashion. 


Best Practices


Notes

Troubleshooting 

If you are have an error message when authorising the integration via the plugins page, please check the below with your setup in zoom:

CMS

Front End

If you still face trouble after going through this guide, please contact your support agent.



Developer Accounts
https://marketplace.zoom.us/docs/sdk/native-sdks/developer-accounts

User Role Management:
https://support.zoom.us/hc/en-us/articles/115001078646-Role-Based-Access-Control

Zoom User Types & Roles:
https://support.zoom.us/hc/en-us/articles/201363173-Account-types


Zoom Integration Vs Desktop Features

The main thing to remember with our zoom integration, is that it is not simply zoom as you know it via other means, but accessed via the platform. The integration uses what is called the zoom web SDK which has different features to the desktop client and mobile app.

More than likely, you are used to using the desktop client which has the most features. Below is a comparison of the features you can expect to find via the desktop client vs the web client, and therefore what you can expect to see via our integration.

Important: CrowdComms are not able to provide support with issues related to the Zoom meeting itself or restrictions with the Zoom SDK. We can assist with setting up the integration which will output your Zoom meeting seamlessly in the CrowdComms platform utilising the Zoom SDK functionality available.  

As updates to the Zoom SDK are released, these will be updated to the CrowdComms / Zoom integration. 

Feature
Windows/macOS (Desktop Client)
Platform Integration (Web Client)
 Start or join meeting

Join a meeting without signing in

Join a meeting in progress

Sign in using Zoom account, Google, Facebook, or SSO

Start an instant meeting.

Schedule one-time or recurring meeting

 

Share your screen in a Zoom Room by entering in the sharing key or meeting ID.

 

Display upcoming meetings

 

Display synced calendar events (if you added a third-party calendar service)

 

View, edit, start, or delete your scheduled meetings

 

Participants are pre-assigned to breakout rooms (if set up by the host)

In meeting controls (participants and hosts)

Join computer audio


(A)

Mute/unmute mic

Start/stop video

Invite others to join meeting

Change your screen name for the meeting

Non-verbal feedback

Share screen


(B)

In-meeting chat

Start cloud recording

Start local recording

 

Request remote control


(D)

Give remote control

 

Gallery View and Active Speaker View

Participant in breakout rooms

Self-select breakout room

 

Answer polls

Language interpretation

Live transcription

Reclaim host

In meeting controls (hosts and co-hosts)

Create, edit, and launch polls

Start and manage breakout rooms (host only)

View pre-assigned participants in breakout rooms (if set up in web portal)

 

Live stream meeting

 

Report a participant for inappropriate behavior

 

In-meeting security controls (hosts and co-hosts)

Lock meeting (don't allow other participants to join the meeting in progress)

Place the attendee in a virtual waiting room

Control if participants can share screen

Control if participants can use in-meeting chat

Control if participants can unmute or rename themselves

Enable/disable video receiving

 

Webinar controls 

Launch question and answer session

Launch polls

 

Live stream webinar

 

Manage participants (hosts)

Stop a participant's video

Assign a participant to be the host

Assign a participant to be a co-host

Allow a participant to start or stop a recording

 

Assign a participant to type closed caption

Change a participant's name that is displayed to other participants

Remove participant from meeting

Mute all participants/ask all to unmute

Automatically mute participants as they join the meeting

Play chime when participants join and leave

Don't allow other participants to join the meeting in progress

Control who participants can chat with

Put a participant on hold

Share screen controls

Share whiteboard

 

Share device audio 

 

Annotate on shared screen or whiteboard

 

Pause your current shared screen

Show or hide names of annotators

 

Stop a participant's screen share (host and co-host only)

 

Control if multiple participants can share screen simultaneously

Side-by-side mode

 

Profile 

Add a personal note

 

Change profile photo or screen name
Note: On the desktop client, you will be redirected to the web portal to change your screen name

 

Manually change your status

 

Chat 

Mark messages as unread

 

Edit your sent messages

 

Delete your sent messages, images, or files

 

Save images or files sent in the chat

 

Add messages to your starred list and view all messages you have starred

 

View starred messages in a specific chat

 

Use your personal chat space

 

Send images or files

 

View all files sent or all files received in chat

 

Share sent or received chat files with contacts

 

Send a capture of the current screen

 

Send animated GIFs

 

Send code snippets

 

Send emoticons

 

Encrypted chat

 

Store chat message history

 

Invite contacts to an existing chat

Channels

Change notifications for new channel messages

 

Add channels to your starred list and view channels you have starred

 

Create a channel

 

Edit a channel (must be a channel admin)

 

Invite members to a channel

 

Contacts

Add contacts

 

Add contacts to your starred list and view contacts you have starred

 

Directory for contacts, channels, and Zoom Rooms

 

Add contact to auto-answer group

 

 Settings

Automatically join meeting by computer or device audio

 

Automatically mute when joining meeting

 

Automatically call phone number to join meeting

 

 

Insert a link preview whenever a chat message contains a link

 

Change notification settings for chat

 

Manage blocked contacts

 

Display meeting reminders

 

Display connected meeting time

 

Display closed captions (if available)

 

Automatically disable your video when joining a meeting

 

Touch up appearance

 

Virtual Background

 

 

Note (A): Joining computer audio on Safari is only available for webinar attendees.

Note (B): Screen sharing on Microsoft Edge requires Windows 10 Pro or Enterprise. It is not supported on Windows 10 Home. If you are running Windows 10 Home and need to share your screen, we recommend using Chrome or Firefox. Screen sharing is not supported on Safari.

Note (C): If you joined a meeting on an iOS or Android device, you can't request remote control or give remote control. The participant who is screen sharing with the Zoom desktop client must give you remote control.

Note (D): Requesting remote control of content shared from the desktop client or mobile app is currently supported, but not content shared from another web client.

Note (E): Self-selection on the Zoom mobile app and ChromeOS is available for meeting participants, but not for the host launching breakout rooms. Self-selection of breakout rooms has to be enabled and launched from the desktop client.

Google Analytics Integration

Google Analytics (GA) is a free web analytics service that tracks and reports website traffic, it works by the inclusion of a block of JavaScript code on pages on our platform. The tracking operation retrieves data about the page request through various means and sends this information to the Analytics server.

Integrated properties can then be viewed for the analytical data captured to be used for report creation. qGpGA.png

To integrate an CrowdComms application with Google Analytics the user must first have a Google Analytics account which can only be created by a user with a gmail email address and Google Profile. The user then needs to generate a GA property which is achieved by going to Admin>Accounts>Create Account. At this point the user then needs to generate either a Universal Analytics (UA) property or a Google Analytics 4 (GA4) property.

How each is set up can be found here . As a general rule the Universal Analytics property should only be used for existing applications and due to attrition eventually not be used at all. A Google Analytics 4 property should be used for new applications recently created. 

CMS - GA Integration

Depending on which property is being used will depend on which Tag integration is selected. 

  1. Navigate to CMS>Plugin>Tags. You will see a thumbnail for Google Analytics.
  2. Select Google Analytics to the taken to the integration options.

Integration of Google Analytics 4

  1. On the GA integration screen there will be the empty field "Measurement ID". This value can be found from your GA property. Navigate to Admin>Data Stream>Stream to find the "Measurement ID".
  2. Input the "Measurement ID" value in the empty CMS field "Measurement ID".
  3. Select the "Save" button.

hr4GA4-Measurement-ID.png

This will complete the integration for the GA4 property.

Integration of Universal Analytics

  1. From the GA integration screen in CMS select the "Universal Analytics" tab. This will direct the user to the UA integration screen with a field called "Tracking ID". This value can be found from your UA property. Navigate to it by Admin>Property Settings. The "Tracking ID" is displayed here but it is also the the property number itself. 
  2. Input the "Tracking ID" value in the empty CMS field "Tracking ID".
  3. Select the "Save" button.

UA-Tracking-ID.pngThis will complete the integration for the UA property.

Requirements For User Data Capture

To permit GA to capture data from a user logged into the Front End of the application the user needs to Accept the cookie consent notification for "Analytic Cookies".

Cookie-Consent.pngThe settings on a users browser and device must also permit the transmission of this data and is done differently depending on the device and browser being used. Please see below the different settings for each scenario:

Chrome Web -Standard Protection enabled

Chrome-Web.png

Chrome Android-"Safe Browsing" and "Do Not Track" disabled.

Android-Chrome.png

Safari Web- "Prevent Cross Site-Tracking" disabled.

Safari-Web.png

iOS Safari- "Prevent Cross Site-Tracking" and "Block All Cookies" disabled.

iOS-Safari.png

Edge Web-Tracking Prevention disabled. 

BxZEdge.png

Firefox Web-Set to Custom and disable "Tracking Content".

lfsFirefox.png

 

Eventboost Integration

Eventboost is an all-in-one event management software and online registration platform which is now able to be integrated with the CrowdComms platform. 

In order to complete the integration there first must be an event created by Eventboost which will have a unique Client ID and Secret. Only Eventboost are capable of generating this information so usually it should only ever be Eventboost that will complete the integration with CrowdComms software. However on the occasions when someone other than Eventboost are generating a integration the user will need to contact Eventboost/CrowdComms client to retrieve the Client ID and Secret before attempting integration.

The user will also need to be able to login the Eventboost site as a registered user/On a 30 day free trial to retrieve the additional required data.

Eventboost Integration

1/ Navigate to CMS>Required App>Plugins>Eventboost which will display the Eventboost Account Details

Eventboost-Thumnail.png

Eventboost-integration.png

2/ On the Eventboost site click on "New Event" to create a an event button or the "My Events" to display existing events the user has already created. 

 

3/ Select the "Event Schedule" and select a date for the event from the calendar

Eventboost-Event-Schedule.png

4/ Change "Event Type" to "Public event"

5/ Change "Event Format" to "Virtual event"

Eventboost-settings.png

6/ Click "Yes" button on warning modal

7/ Change "Event Language" to the appropriate language

8/ Untick "Event options" for "Registration" unless you wish the users to complete a registration process on Eventboost and carry that data over within the integration of the user profiles.

9/ On the created event, update with a "start time", "end time", and "description".

Eventboost-times.png

10/ Click on the "Save" button.

11/ Click "ok" on the warning modal.

12/ Click on the "gear" button next to the session

13/ Select the "no" node and "ok" button.

14/ Click on the "Save" button.

15/ In CMS using the Eventboost details for the "Secret" and "Client ID" update the corresponding Eventboost integration fields

16/ Using the "Event ID" from the event made on the Eventboost website, update the "Event ID" field in CMS

17/ Update the "Session import method" to "Managed schedules" and click on the "save" button

eventboost-integration-screen.png

Eventboost Custom Fields

You can also map additional delegate's profile information from Eventboost using the Custom fields Tab.

1/ Click on "Custom Fields" tab

2/ Click on "Create New" button

3/ Input a reference into the "EB Field"

4/ From the "type" select "Custom Field"

5/ From the "Customer field" drop down select a custom field that exists within CMS for the app

6/ Click on the "Save" button

 

 

Cvent Integration Setup Guide

Cvent Integration Training Guide

  1. Prerequisites
  2. Integrating Cvent into CMS
  3. Webhooks
  4. Post configuration
  5. Custom Fields
  6. Useful Links


Prerequisites to Integrate with CMS


When the Cvent integration is correctly setup, only attendees who have been created from the point of the integration being setup will be synced with your CrowdComms platform.


How to Integrate Cvent with CMS

Before you initiate the integration you will need to set up an Application in the Cvent Developer Portal. Within the Application, you may select all of the EVENT scopes (please click on the link for more information https://developers.cvent.com/docs/rest-api/overview). However, access to ALL scopes is not essential, the minimum required are as follows:
event/events:read
event/custom-fields:read
event/registration-types:read
event/contacts:write
event/sessions:read
event/attendees:read

Picture.png


Next you will need to populate the cms fields with the relevant information

  1. Client I.D – can be obtained from Cvent Developer Portal after an Application has been created
  2. Client Secret – can be obtained from Cvent Developer Portal after an Application has been created
  3. Host – the Endpoint host varies based on which server region your Cvent account is hosted in. This can be also identified based on your event’s URL, starting with either https://api-platform.cvent.com or https://api-platform-eur.cvent.com
  4. Event I.D – can be obtained from the Cvent Events Portal
  5. Session Import Method – a dropdown menu, which enables you to select how you would like to import your Cvent sessions to your CrowdComms Event App. The options are:
    a.  Managed Schedule – Your Cvent session will be imported to your delegate’s tailored agenda. Please refer here to read more about Managed Schedule.
    b.  Personal Agenda – Your Cvent session will be imported to your delegate’s favourited agenda. Please refer here to read more about Personal Agenda.
  6. Default People Group – the default people group to which all Cvent attendees will be added
  7. Two-Way Integration toggle – switch on this toggle of you want to sync cms data into Cvent, otherwise by default attendee data will only pull from Cvent into the CMS

    On a two way integration, we can only sync changes to attendee details to Cvent, but we cannot sync changes to session details back to Cvent

Picture1.png

A module named Cvent agenda will be created in the CMS after the integration is set up. Do not delete this module if you want to sync your Cvent sessions into the cms (refer to Setting up the webhook configuration section below)


Setting up Webhooks

To allow continuous synchronization from Cvent to CrowdComms you will need to set up Webhooks in the Cvent Event Portal.

Syncs from Cvent to CMS can take up to 20 minutes. Syncs from CMS to Cvent is more or less instant

After you have saved the integration details in the CMS you will then be shown the Webhooks section which contains the Webhook URL and Webhook Token

Picture8.png

1. Adding a webhook configuration

2. Setting up the webhook configuration

Picture4.png

3. Adding Integration Points for data to be transferred

The API will only process the following webhook event types:

InviteeOrGuestModified
InviteeOrGuestCancelled
InviteeOrGuestAccepted
InviteeRegistersForCventSession
InviteeCancelsRegistrationForCventSession
ContactEdited

SessionCreated
SessionUpdated
SessionDeleted

4. Activating Webhooks for your event

For each event you want to integrate with a CrowdComms app you need to set up a new Webhook configuration


Post Configuration


Custom Fields

Upon successful integration only delegate's First Name, Surname and their Email is automatically synced, all other information needs to be set up using the Custom fields tab.

Click on the “Custom Fields” TAB in CMS

Picture5.png

Picture9.png

In case of a two-way integration we are unable to sync changes into Cvent on the following fields:
profileImageUrl
homeCountry
workCountry 



Useful links








Eventbrite Integration Setup Guide

Contents

  1. In and out of scope
  2. Access Requirements
  3. Integrating Eventbrite into dashboard (CMS)
  4. Custom Fields
  5. Useful Links/Notes


1. In and out of scope

In scope

Out of  scope


2. Access requirements

Client will need access to the below to integrate with CrowdComms dashboard


3. Integrating Eventbrite into dashboard (CMS)

3.1 Log into CrowdComms dashboard (CMS)

3.2 Select an App

3.3 Click on “Plug Ins”

3.4 Click on the “Eventbrite” tile

Eventbrite-tile.png


Note: The client will need to access their Eventbrite account to retrieve the API Token and the Event ID.

i. Log into Eventbrite account
ii. Navigate to “Account Settings” on the dropdown from the right-hand menu

Eventbrite-account-setting.png


With existing API keys

iii. Navigate to Developer Links and click on “API Keys”
iv. Click on the expand arrow to expose the API keys, secret and tokens
v. Record or copy the “Private token” to populate the API token field on CrowdComms dashboard (CMS)

Eventbrite-API-key.png

CMS-API-Token.png


Without an API key

vi. Navigate to https://www.eventbrite.co.uk/platform/
vii. Click on “Get a free API key”
viii. Follow authentication process. To learn more about Eventbrite authentication process, click here.

Creating-API-key.png


ix. To locate the Event ID, navigate to “Manage my events” on the dropdown from the right-hand menu

Eventbrite-manage-event.png


x. Select on the relevant event that you want to integrate with your CrowdComms app

Eventbrite-events.png


xi. Scroll down to the bottom of Event Dashboard to locate the Event ID. Your Event ID can be found in the red highlight box as shown below:

Eventbrite-event-ID.png


xii. Record or copy the Event ID and populate the Event ID field on CrowdComms dashboard (CMS)

CMS-event-ID.png


3.5 Once both “API Tokens” and “Event ID” fields on the dashboard (CMS) are populated, click “Save”

3.6 There are two ways to check for a successful integration:
(a) On CrowdComms dashboard (CMS)

Successful-integration.png

(b) On Eventbrite platform (Account Settings > Developer Links > Webhooks)
The new integration will have created a webhook and you can identify which webhook is yours by finding the app shortcode in the webhook link

Eventbrite-webhooks.png


4. Custom Fields

4.1 Click on the “Custom Fields” tab in CrowdComms dashboard (CMS)

4.2 Click “Create New”

CSM-custom-field.png


4.3 If you have added custom fields on your Eventbrite event, these custom fields will appear on the drop-down of the “EB field” field on CrowdComms dashboard (CMS).

4.4 You can also map additional delegate's profile information from Eventbrite using this field. For example: Job Title, Company etc.

4.5 You can map your Eventbrite custom field by selecting the Type field to map to CrowdComms:
(a) People Group
(b) Custom Field
(c) Profile Field

4.6 Based on the Type that you select, only the selected field will be available, and the other two will be unavailable

4.7 Click “Create”

CMS-custom-fields-mapping.png



**Useful tips**

Eventbrite doesn't send CrowdComms Deletions, so if you have removed any users from Eventbrite, you will also need to remove them manually from the CrowdComms platform.



Stova (Aventri) Integration Setup Guide

Stoav (Aventri) is an event management software and online registration platform. If you use Aventri to market your event and collect registration information from your delegates, you can now integrate your Aventri account to your CrowdComms platform.

Page content:

  1. Access Requirements
  2. Integrating Aventri into CrowdComms Content Management System (CMS) Dashboard
  3. Automatic Mapping from Aventri to CrowdComms
  4. Mapping of Custom Fields from Aventri to CrowdComms
  5. Setting up Webhooks to enable continuous synchronisation between Aventri and CrowdComms


1.   Access Requirements

1.1.   To start the integration with Aventri, you will need access to:

a.    Aventri account
b.    CrowdComms Content Management System (CMS) Dashboard


2.   Integrating Aventri into CrowdComms CMS Dashboard 

2.1    First, you will need to log in to CrowdComms CMS Dashboard 
2.2    Then select the Event App you wish to integrate with your Aventri registration platform
2.3    On the left-hand side menu, click on ‘Plug Ins’ and click on the ‘Aventri’ tile
2.4    Before you initiate the integration, please ensure that the status of your event in Aventri is ‘Live’
2.5    You will then see the ‘Account Details’ tab with several fields for you to populate. These fields need to be populated with your Aventri account information 

Retrieving Integration Information from Aventri

•    Log in to your Aventri Account
•    On the left-hand side of the screen, navigate on the hamburger menu, go to ‘Settings’ and click on ‘Account Settings’
•    You will then see several tabs, and several other sub-tabs, click on the ‘Integration’ tab and click on ‘API’
•    Record or copy the Account Key and paste it into the API key field in the CrowdComms CMS Dashboard
•    Record or copy the Account ID and paste it into the Account ID field in the CrowdComms CMS Dashboard
•    To locate your Event ID and the Endpoint Host, go to your event’s list and click on one of your events. 
•    The Event ID can be found next to the event’s name. Record or copy the Event ID and paste it into the External Event ID field in the CrowdComms CMS Dashboard
•    The Endpoint host varies based on which server region your Aventri account is hosted in. One indication can be seen on your event’s URL as shown in the example below. 
•    In the API Endpoint field, select from one of the dropdowns of either:
a.    Asia Pacific (APAC)
b.    North America (NA)
c.    Europe, Middle East, Africa (EMEA)
•    If the dropdown options are not applicable to you, use the Endpoint Override field to populate your relevant Endpoint hostname provided to you by Aventri.

Aventri fields.png

Note: To learn more about Aventri platform integration, please click here to access Aventri API documentation

2.6    Next, you will see a dropdown menu, which enables you to select how you would like to import your Aventri sessions to your CrowdComms Event App. The options are:

a.    Managed Schedule – Your Aventri session will be imported to your delegate’s tailored agenda. Please refer here to read more about Managed Schedule.
b.    Personal Agenda – Your Aventri session will be imported to your delegate’s favourited agenda. Please refer here to read more about Personal Agenda.

2.7    If you do not intend on setting up the Mapping of custom fields, you can select the Enabled checkbox now.  Otherwise, leave this unchecked until you have finished configuration.
2.8    Once all relevant fields on the Dashboard are populated, click ‘Save’.

Integrating the platforms.png


3.   Automatic Mapping from Aventri to CrowdComms

3.1    Upon successful integration, essential event sessions and delegate information will be imported from Aventri to the CMS Dashboard.
3.2    The event sessions which will be imported are:

a.    Session name
b.    Session time – If no start and end times were set on the Aventri session, the event start, and end times will be applied by default

3.3    The following delegate information will also map across by default:

a.    Delegate’s first name
b.    Delegate’s last name
c.    Delegate’s email
d.    Delegate’s company
e.    Delegate’s job title


4.   Mapping of Custom Fields from Aventri to CrowdComms

4.1    You can import other information from Aventri to CrowdComms, including additional delegate information or other custom fields which you have added to your Aventri account.
4.2    To do this, once you have created a successful integration, click on the ‘Custom Fields’ tab.
4.3    To map data from Aventri to your Dashboard, click ‘Create new field mapping.’
4.4    The ‘Aventri Field’ dropdown will display additional data that has not already been mapped automatically, which you can manually map to the Dashboard. Some examples include:- Address, telephone, and other custom fields which you may have added in Aventri.
4.5    You can choose where you want to map the selected Aventri data by selecting from one of the types below: 

a.    People Group
b.    Custom Field
c.    Profile Field

4.6    Please note that only Aventri’s Categories can be mapped to the CrowdComms’s People’s Group
4.7    Based on the ‘Type’ field that you select, only the selected field will be available, and the other two will be unavailable.
4.8    Click ‘Create’ to add customer mapping and click ‘Save’ to retain your configuration.
4.9    Repeat steps 3 – 7 to map additional fields.
4.10    Navigate to the ‘Account Details’ tab, check the ‘Enabled’ checkbox and click ‘Save’ to begin syntonisation of data between Aventri and CrowdComms.

Custom mapping.png


5.   Setting up Webhooks to enable continuous synchronisation between Aventri and CrowdComms


5.1    The purpose of these steps is to allow continuous synchronisation of data from Aventri to CrowdComms after the initial integration set up. It includes new users who register after you’ve set up your integration and existing users who updates their information in Aventri. 
5.2    To do this, log into your Aventri account
5.3    Go to the following URL, substituting in your Event ID: https://na-admin.eventscloud.com/loggedin/eReg/integrations/index.php?eventid=<eventid>
5.4    Copy your ‘Account key’
5.5    Scroll down to the ‘API Event trigger’ section and ensure that:

a.    ‘Event Scenario’ is set to ‘Event Created/Modified’
b.    ‘Content type’ is set to ‘application/x-www-form-urlencoded' (important)

5.6    Check the box that says ‘Sign Payload (Using JWT)’
5.7    In the new ‘Secret Key’ field that appears, paste the ‘Account key’ you copied earlier
5.8    Paste the following URL into the ‘Specify URL’ field: https://api.crowdcomms.com/cms/integrations/aventri/webhook/
5.9    Click ‘CREATE/UPDATE TRIGGER’
5.10    Copy your ‘Account key’ again
5.11    Click the menu on the top left, select ‘Events’, then ‘View all events’ and select the event you are integrating to your CrowdComms app
5.12    Click the pencil icon beneath the Event title, hover over the ‘Adv. Settings’ tab and select ‘Integrations’
5.13    Ensure that:

a.    ‘Attendee Scenario’ is set to ‘Registration / Modification’
b.    ‘Content type’ is set to ‘application/x-www-form-urlencoded' (important)

5.14    Check the box next to ‘Sign Payload (Using JWT)’
5.15    In the new ‘Secret Key’ field that appears, paste the ‘Account key’ you copied in step 4
5.16    Paste the following URL into the ‘Specify URL’ field: https://api.crowdcomms.com/cms/integrations/aventri/webhook/
5.17    Click ‘CREATE/UPDATE TRIGGER’

Stripe Integration

Stripe Integration for Paid Ticketing Training Guide

Enhance your event with our Registration Ticketing feature, now integrated with Stripe! This seamless integration enables you to offer paid experiences and products, providing a comprehensive and streamlined experience for your attendees.

Stripe Integration Step-by-Step

  1. Prerequisites
  2. Integrating Stripe into CMS
  3. Tax Rates
  4. Enabling Receipts
  5. Unlinking your Stripe Account
  6. Useful Links 
Trial Test (14).jpg

Doc's Image Editor.png

Pre-requisites

If you already have a Stripe Account you will just need the login details to link the account, if you are setting up a new Stripe Account the next steps will require:

Integrating Stripe into the CMS

  1. Log in to the CMS.
  2. Navigate to integrations on the left side menu.
  3. Select the Stripe Icon.
  4. Click the 'Connect to Stripe' button.
  5. You will be re-directed to Stripe, follow the prompts on screen to link your existing account or set up a new one.
  6. Once you have completed the prompts, your Stripe account will be linked to the CMS and ready to accept payments via your registration form.

To learn more about how to create paid tickets for your event please see our ticketing guide.

Setting Up Your Tax Rate

To ensure accurate and consistent data reporting, we recommend setting up your tax rate within the CrowdComms CMS. Follow these guidelines to avoid user errors and double taxation:

  1. Configure Tax Rate in CMS First:

    • Set your tax rate in the CrowdComms CMS before making any adjustments in Stripe.
    • Creating a Tax Rate should only be done in CMS which will replicate into Stripe.
  2. Stripe Tax Rate Activation:

    • Payments will not be processed if there is no active tax rate in Stripe, regardless of the tax rate set in the CMS.
    • Once generated, tax rates in Stripe remain "Active" and Stripe will always apply the most recent active tax rate.
  3. Managing Tax Rates in Stripe:

    • If you need to change the tax rate please do so in the CMS, it is advisable to set legacy Tax Rates to "Archived" in Stripe so its clear in Stripe which Tax Rate is currently being used.

By following these steps, you can maintain accurate and consistent tax application across both platforms. 

It is highly recommended to set your tax rate in the CMS and allow that information to be fed back to your Stripe Account via our platform. For information on setting the tax rate in the CMS please see here.

Enabling Receipts

For the customer receipts functionality, please ensure to enable receipts on your Stripe Account. You can find more information on how to enable receipts on Stripe here

To enable automated receipts, toggle Successful payments on in your Customer emails settings. Stripe only sends receipts to successful and completed payments. If the payment fails or is declined, a receipt will not be sent.

To ensure your customers receive their receipts you will also need to white list the Stripe Domain '@stripe.com'.

For more on white listing please see here.


Unlinking Your Stripe Account

Doc's Image Editor (1).png