Skip to main content
All CollectionsEvent BuilderIntegrationsThird-Party Connectors
Setting Up a Visit by GES Integration in Your Event
Setting Up a Visit by GES Integration in Your Event
Updated over 2 months ago

This page contains the setup guide and reference information for the Visit by GES integrations.

This integration is part of Free, Starter, Professional, Enterprise subscription. Contact your Account Manager for more information.

Prerequisites

  • An active Visit account with a list of events (ensure you have access, especially if you are not the owner)

Setup guide

Step 1: Set up Visit by GES

  1. Log into your Visit by GES account.

  2. In the right navigation bar, click My information then Developer access.

  3. On the page, Generate an API access key.

  4. Then copy the generated API access key.

Step 2: Set up the Visit by GES integration in Swapcard

  1. Navigate to your Event page within the Communities section.

  2. In the left navigation bar, go to Event Builder, then select Integrations.

  3. On the integration selection page, choose Visit by GES from the list of integrations.

  4. Copy the values displayed in Step 4 - Set up Visit by GES, using the corresponding API access key fields.

  5. Click on Submit.

  6. Select your event for integration - The integration displays all events your account has access to, including upcoming and past events.

Your Visit event has been successfully linked with your Swapcard event.

You have the flexibility to adjust your integration settings according to the specific data requirements. It's crucial to highlight that the synchronization will only begin when you manually start the integration process and finish the necessary mapping.

Supported sync modes

The Visit by GES integration supports the following sync modes :

Feature

Supported?

Yes

Yes

Webhook - Overwrite

Yes

Managing Incremental Sync with Visit by GES

Visit manages incremental synchronization through a Revision mechanism. This mechanism is stateful, requiring Swapcard to keep track of the previously returned revision to retrieve newly created or updated records in Visit.

Stateful Revision Mechanism

In a stateful revision mechanism, Swapcard must maintain awareness of the revision number from the last successful synchronization. This enables the integration to request records created or updated since the last synchronization date.

Time-Based Integration Approach

Common integration practices often adopt a time-based approach, where all records created or updated based on the last successful synchronization date are requested. However, Visit's API restrictions may result in certain records being overlooked during incremental sync.

Handling Discrepancies

In case of discrepancies between Visit and Swapcard, it is advisable to perform a Full Refresh - Overwrite. This ensures a comprehensive synchronization, addressing any potential gaps in the incremental sync process.

Supported streams

This integration is supporting the following Visit by GES streams

Capturing deleted records

The Visit by GES integration does NOT capture deletions for records in the Visitors, Partners streams.

When a record is deleted on Visit, it needs to be MANUALY deleted on Swapcard accordingly.

Object Mappings

The list of available objects for mapping in the Visit by GES integration is generated through various streams.

As the Vist by GES JSON API does not support the retrieval of Registration Types at Event Level and returning all the Registration Types, as recommanded by Visit GES the Swapcard integration employs a combination of the n200 legacy XML API and the Visit JSON API endpoint.

For each Registration Types XML of types visitor and partner, the Swapcard integration creates the appropriate objects to be mapped.

Stream Dependencies

In the context of integration functionalities, records are automatically linked with their corresponding records within Swapcard. For instance, if Visitors are associated with Partners on Visit, the integration will replicate these dependencies within Swapcard.

Visitors → Partners

The Visit by GES integration automatically links the Visitors from Visit by GES with their respective Partners from Visit by GES.

The integration utilizes the partner.id field from the Visitors stream.

The id of Partners is employed as the main identifier to uniquely link records and store them within the Client Id field on the Swapcard side.

Streams supporting fields

Visitors

Registrant Field

Mapping Label

Type

reference

"Reference"

string

registrantState

"Registration State"

string

attendanceState

"Attendance State"

string

actionCode

"Action Code"

string

registerTime

"Registration Time"

string

registrationType.name

"Registration Type"

string

form.name

"Form"

string

visitorPortalUrl

"Visitor Profile Url"

string

partner.id

"Visitor Partner Code"

string

visitConnectURL

"Visit Connect URL"

string

visitDiscoverURL

"Visit Discover URL"

string

confirmationDocumentURL

"Visit Confirmation Document"

string

embeddedDigitalBadgeURL

"Visit Embedded Document"

string

contact.id

"Contact - ID"

string

contact.title

"Contact - Title"

string

contact.firstName

"Contact - First Name"

string

contact.lastNamePrefix

"Contact - Last Name Prefix"

string

contact.lastName

"Contact - Last Name"

string

contact.nationality

"Contact - Nationality"

string

contact.dateOfBirth

"Contact - Date Of Birth"

string

contact.gender

"Contact - Gender"

string

contact.company

"Contact - Company (Visitors Only)"

string

contact.vatNumber

"Contact - Vat Number"

string

contact.cocNumber

"Contact - Coc Number"

string

contact.companyPhone

"Contact - Company Phone"

string

contact.companyFax

"Contact - Company Fax"

string

contact.companyWebsite

"Contact - Company Website"

string

contact.jobFunction

"Contact - Job Function"

string

contact.department

"Contact - Department"

string

contact.phone1

"Contact - Phone 1"

string

contact.phone2

"Contact - Phone 2"

string

contact.fax

"Contact - Fax"

string

contact.email

"Contact - Email"

string

contact.website

"Contact - Website"

string

contact.addresses[0].address

"Contact - Address"

string

contact.addresses[0].houseNumber

"Contact - House Number"

string

contact.addresses[0].houseNumberSuffix

"Contact - House Number Suffix"

string

contact.addresses[0].postalCode

"Contact - Postal Code"

string

contact.addresses[0].city

"Contact - City"

string

contact.addresses[0].state

"Contact - State"

string

contact.addresses[0].country

"Contact - Country"

string

contact.reference

"Contact - Reference"

string

Explore the Connect URL

The visitConnectURL field is frequently employed by customers to grant direct access to Vist by GES badges. To facilitate seamless integration in embedded mode, Swapcard automatically includes embedded=true query parameters for proper embedding.

Questions

The questions field in the Visitors section serves as a means for Swapcard integration to implement a custom fields approach. This is commonly used to fetch registration form inquiries.

The mapping of questions between the answers in the Visitors section and the questions in the Event section relies on the name of the questions. Unfortunately, this method is susceptible to mismatches. Regrettably, Visit by GES currently lacks a unique identifier for questions.

Partners

Partners Field

Mapping Label

Type

standNumber

"Stand Number"

string

standSize

"Stand Size"

string

barCodeScannerCount

"Barcode Scanner Count"

string

scanAppCount

"ScanApp Count"

string

registrationUrlLink

"Registration URL Link"

string

visitConnectInviteLink

"VisitConnect Invite Link"

string

licensesLink

"Licenses Link"

string

contentsLink

"Contents Link"

string

contact.id

"Contact - ID"

string

contact.type

"Contact - Type"

string

contact.title

"Contact - Title"

string

contact.firstName

"Contact - First Name"

string

contact.lastNamePrefix

"Contact - Last Name Prefix"

string

contact.lastName

"Contact - Last Name"

string

contact.nationality

"Contact - Nationality"

string

contact.dateOfBirth

"Contact - Date Of Birth"

string

contact.gender

"Contact - Gender"

string

contact.vatNumber

"Contact - Vat Number"

string

contact.cocNumber

"Contact - Coc Number"

string

contact.companyName

"Contact - Company Name (Partners Only)"

string

contact.companyPhone

"Contact - Company Phone"

string

contact.companyFax

"Contact - Company Fax"

string

contact.companyWebsite

"Contact - Company Website"

string

contact.jobFunction

"Contact - Job Function"

string

contact.department

"Contact - Department"

string

contact.phone1

"Contact - Phone 1"

string

contact.phone2

"Contact - Phone 2"

string

contact.fax

"Contact - Fax"

string

contact.email

"Contact - Email"

string

contact.website

"Contact - Website"

string

contact.addresses[0].address

"Contact - Address"

string

contact.addresses[0].houseNumber

"Contact - House Number"

string

contact.addresses[0].houseNumberSuffix

"Contact - House Number Suffix"

string

contact.addresses[0].postalCode

"Contact - Postal Code"

string

contact.addresses[0].city

"Contact - City"

string

contact.addresses[0].state

"Contact - State"

string

contact.addresses[0].country

"Contact - Country"

string

contact.reference

"Contact - Reference"

string

Limitations & Troubleshooting

Connector limitations

Rate limiting

The Visit by GES integration is designed to operate smoothly within typical usage scenarios and should generally not encounter limitations imposed by the Visit by GES API. However, its functionality is dependent on the capabilities of the Visit by GES API. If you encounter rate limits issues, kindly contact the Visit by GES support team for assistance.

Incremental Sync - Overwrite

Integration with Visit by GES is subject to limitations imposed by the provider's API when it comes to incremental updates. For more details, please consult the Managing Incremental Sync in Visit by GES section.

Object Mappings

The recently developed Visit by GES API lacks support for Registration Types, as indicated in Object Mappings, which may result in potential challenges when attempting to retrieve registration uniform types.

Changelog

Version

Date

Subject

1.0.5

2024-05-12

Add webhooks + Visit v2 API

Enhancement

Please be aware that any enhancements to this integration, which encompass any requirements not covered by the existing integration state, will be subject to custom development processes and associated costs.

Did this answer your question?