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
Log into your Visit by GES account.
In the right navigation bar, click My information then Developer access.
On the page, Generate an API access key.
Then copy the generated API access key.
Step 2: Set up the Visit by GES integration in Swapcard
Sign in to your Swapcard account.
Navigate to your Event page within the Communities section.
In the left navigation bar, go to Event Builder, then select Integrations.
On the integration selection page, choose Visit by GES from the list of integrations.
Copy the values displayed in Step 4 - Set up Visit by GES, using the corresponding API access key fields.
Click on Submit.
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.
Registration Types XML
visitor
: To be mapped with People on Swapcard.Registration Types XML
partner
: To be mapped with Exhibitor on Swapcard.
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" |
|
| "Registration State" |
|
| "Attendance State" |
|
| "Action Code" |
|
| "Registration Time" |
|
| "Registration Type" |
|
| "Form" |
|
| "Visitor Profile Url" |
|
| "Visitor Partner Code" |
|
| "Visit Connect URL" |
|
| "Visit Discover URL" |
|
| "Visit Confirmation Document" |
|
| "Visit Embedded Document" |
|
| "Contact - ID" |
|
| "Contact - Title" |
|
| "Contact - First Name" |
|
| "Contact - Last Name Prefix" |
|
| "Contact - Last Name" |
|
| "Contact - Nationality" |
|
| "Contact - Date Of Birth" |
|
| "Contact - Gender" |
|
| "Contact - Company (Visitors Only)" |
|
| "Contact - Vat Number" |
|
| "Contact - Coc Number" |
|
| "Contact - Company Phone" |
|
| "Contact - Company Fax" |
|
| "Contact - Company Website" |
|
| "Contact - Job Function" |
|
| "Contact - Department" |
|
| "Contact - Phone 1" |
|
| "Contact - Phone 2" |
|
| "Contact - Fax" |
|
| "Contact - Email" |
|
| "Contact - Website" |
|
| "Contact - Address" |
|
| "Contact - House Number" |
|
| "Contact - House Number Suffix" |
|
| "Contact - Postal Code" |
|
| "Contact - City" |
|
| "Contact - State" |
|
| "Contact - Country" |
|
| "Contact - Reference" |
|
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 |
| "Stand Number" |
|
| "Stand Size" |
|
| "Barcode Scanner Count" |
|
| "ScanApp Count" |
|
| "Registration URL Link" |
|
| "VisitConnect Invite Link" |
|
| "Licenses Link" |
|
| "Contents Link" |
|
| "Contact - ID" |
|
| "Contact - Type" |
|
| "Contact - Title" |
|
| "Contact - First Name" |
|
| "Contact - Last Name Prefix" |
|
| "Contact - Last Name" |
|
| "Contact - Nationality" |
|
| "Contact - Date Of Birth" |
|
| "Contact - Gender" |
|
| "Contact - Vat Number" |
|
| "Contact - Coc Number" |
|
| "Contact - Company Name (Partners Only)" |
|
| "Contact - Company Phone" |
|
| "Contact - Company Fax" |
|
| "Contact - Company Website" |
|
| "Contact - Job Function" |
|
| "Contact - Department" |
|
| "Contact - Phone 1" |
|
| "Contact - Phone 2" |
|
| "Contact - Fax" |
|
| "Contact - Email" |
|
| "Contact - Website" |
|
| "Contact - Address" |
|
| "Contact - House Number" |
|
| "Contact - House Number Suffix" |
|
| "Contact - Postal Code" |
|
| "Contact - City" |
|
| "Contact - State" |
|
| "Contact - Country" |
|
| "Contact - Reference" |
|
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.