Voyado Engage Integration

This guide walks you through connecting Fluentos with Voyado Engage so that every lead captured by your campaigns is automatically sent to Voyado as a contact profile.

It also explains how to enable audience targeting for visitors arriving from Voyado links, so you can identify returning visitors and show campaigns only to specific Voyado Target Audiences.

You will need:

• Access to Voyado Engage with admin permissions
• A Fluentos account with an active website

1. Generate an API Key in Voyado

Before setting up the integration in Fluentos, you need to create an API connection in Voyado Engage.

1. Log in to Voyado Engage.

2. On the left side, select Administration.

3. Go to Config Hub -> Integrations & External systems -> API Connections.

4. Click Add API-connection.

5. Fill in the form:

   • Name -> select Other
   • Other name -> type Fluentos
   • Type -> select Ecom
   • API-allowlist -> leave empty (unless your security policy requires IP whitelisting)

   

6. Click Save.

After saving, the new connection appears in the list. Click Copy API key to copy it to your clipboard.

API Key

Voyado allows you to copy the API key at any time. You will need it in the next step.

Find Your Base URL

Your Voyado instance URL is visible in your browser’s address bar when you are logged in. It follows this format:

https://your-instance.voyado.com

Staging Environment

Voyado staging environments typically have a different base URL than production. Make sure to use the correct one. It follows this structure: https://your-instance.staging.voyado.com

If you are unsure about your URL, contact your Voyado account manager.

2. Find the Soft Identification Key in Voyado

If you want to use audience targeting, you also need the Soft Identification Key from Voyado.

1. Log in to Voyado Engage.
2. On the left side, select Administration.
3. Go to Config Hub -> Integrations & External systems -> Soft Identification.
4. Copy the Encryption key.

This key is used by Fluentos to decrypt the visitor identifier from the Voyado link parameter value (e.g. ?eclub=VALUE).

What This Key Is Used For

The Soft Identification Key is only needed if you want Fluentos to identify visitors from Voyado links and use Voyado Target Audiences for campaign targeting.

Keep This Key Secure

Treat the Soft Identification Key like a secret. If it is incorrect, Fluentos will not be able to decrypt the identifier, and audience targeting for Voyado visitors will not work.

3. Add the Integration in Fluentos

1. Open the Fluentos Dashboard at app.fluentos.com.
2. On the left side, click Integrations.
3. Click the Add New Integration button.
4. Fill in the fields:
   • Integration Name -> give it a name, e.g. Voyado Production
   • Select Integration -> choose Voyado Engage
   • Enabled -> toggle it on
   • Voyado Engage API URL -> paste your Voyado base URL (e.g. https://your-instance.voyado.com)
   • Voyado Engage API Key -> paste the API key you copied from Voyado
   • Soft Identification Key -> paste the Encryption key from Voyado only if you want to use audience targeting
5. Under Notification Recipients, add one or more email addresses to receive alerts if the integration encounters errors.

6. Click Validate Connection to confirm everything is working. You should see “Integration Status OK” at the bottom.
7. Click Save to finish.

Validation Fails?

Double-check that your API URL starts with https:// and does not have a trailing slash. Also verify the API key was copied correctly - a single missing character will cause a failure.

Soft Identification Key Is Optional for Basic Lead Sync

If you only want to send campaign leads into Voyado, you can leave Soft Identification Key empty. It becomes relevant when you enable Voyado-based audience targeting.

Audience Targeting Settings

To identify visitors from Voyado links and target campaigns by Voyado Target Audiences, toggle on Enable audience targeting in the integration.

When enabled, two additional fields appear:

• Link parameter -> the URL query parameter Fluentos reads from the landing page (e.g. eclub in ?eclub=VALUE).
• Cookie name -> the cookie where Fluentos stores the link parameter value to identify returning visitors.

Recommended defaults:

• Link parameter -> eclub.
• Cookie name -> use the default provided by Fluentos unless you are already storing the value in a cookie from Voyado Engage. In that case, use the same cookie name.

How it works:

1. A visitor lands on your website from a Voyado link containing the configured parameter (e.g. ?eclub=VALUE).
2. Fluentos reads the parameter value from the URL.
3. Fluentos stores the value in the configured cookie for one year.
4. On later page views, Fluentos uses the stored value to check the visitor’s Voyado audience membership and evaluate targeting rules in the campaign’s Display Rules.

When Does Audience Targeting Apply?

• Enable audience targeting is turned on in your Voyado integration, and
• The campaign has Display Rules configured with Target by audience.

If either condition is not met, Fluentos will not look up or evaluate any audience membership.

Use Matching Values

The Link parameter in Fluentos must match the parameter used in your Voyado links. If Voyado sends eclub but Fluentos is configured to read a different parameter, identification will fail.

Requirements for Audience Targeting

• Audience targeting enabled in the Voyado integration
• The correct Soft Identification Key
• The correct Link parameter
• A valid Cookie name

If any of these are missing or incorrect, lead sync will still work, but visitor identification and audience-based campaign targeting will not.

4. Profile Sync Strategy

When you connect a campaign to your Voyado integration, you can choose how Fluentos handles contacts that may already exist in Voyado. This is called the Profile sync behavior and it appears when you set up the campaign integration mapping.

Strategy	What it does
Create or overwrite (replace)	Creates a new profile if it doesn’t exist. If a profile with that email already exists, Fluentos overwrites the mapped fields with the new submitted values. This is the default and recommended option for most use cases.
Create new only	Only creates new profiles in Voyado. If a profile with that email already exists, the submission is skipped entirely.
Update existing only	Only updates profiles that already exist in Voyado. If no profile is found for the submitted email, nothing happens.

Which Strategy Should I Pick?

• Use Create or overwrite for newsletter sign-ups and lead capture - it covers both new and returning visitors.
• Use Create new only if you are running a contest or giveaway and want to avoid duplicate entries overwriting existing member data.
• Use Update existing only if you want to enrich existing member profiles without accidentally creating incomplete contacts.

5. Connect a Campaign to Voyado

Once the integration is saved, you can link it to any campaign that has form fields (inputs, checkboxes, etc.).

1. Open your campaign in the Fluentos editor.
2. Go to the Publish tab -> Integrations.
3. Select your Voyado integration.
4. Choose the Profile sync behavior that fits your use case (see above).
5. Under Assign Components to Integration Fields, map each form component to a Voyado field.
6. Optionally, add Fixed Values for fields that should always be the same (e.g. countryCode = SE).
7. Click Save.

Field Mapping Reference

Below are the most commonly used Voyado fields you can map your campaign components to:

Voyado Field	Description
email	Contact’s email address - required for every submission
firstName	First name
lastName	Last name
mobilePhone	Mobile phone number
countryCode	Two-letter country code, e.g. SE, NO, DK
lang	Language code, e.g. sv, en
street	Street address
city	City
zipCode	Postal code
birthDay	Birthday in YYYY-MM-DD format
gender	Gender
externalId	External identifier (can be used instead of email)
source	Where the contact came from, e.g. Fluentos

Communication Preferences (Fixed Values)

Use Fixed Values to control marketing consent flags. Set these to true or false:

Field	What it controls
acceptsEmail	Email marketing consent
acceptsSms	SMS marketing consent
acceptsPostal	Postal mail consent

Set Consent via Fixed Values

If your campaign is a newsletter sign-up, add a fixed value acceptsEmail = true so every contact that submits the form is automatically opted in for email in Voyado.

6. Using Voyado Audience Targeting in Campaigns

After enabling audience targeting in the Voyado integration, you can target campaigns to specific Voyado audiences from the campaign editor.

1. Open your campaign in the Fluentos editor.
2. Go to the Publish tab -> Display Rules.
3. Under Audience Targeting, toggle on Target by audience.
4. Select your Voyado integration as the Data Source.
5. Set the Rule (e.g. In audience or Not in audience).
6. Select the Audience from the dropdown — audiences are fetched directly from Voyado.

When a visitor arrives from a Voyado link, Fluentos identifies them using the stored cookie value and checks their Voyado audience membership. The campaign is shown only if the visitor matches the configured audience rule.

Best Use Case

Use this when you want to show campaigns only to visitors who belong to specific Voyado audiences, for example VIP members, loyalty segments, or campaign-specific CRM groups.

Lead Sync and Audience Targeting Are Separate

The Voyado integration can be used for both lead/profile sync and audience targeting, but they are separate capabilities. You can use lead sync without audience targeting, or use both together.

7. Testing Your Setup

1. Create a test campaign with at least an email input field.
2. Publish it and submit a test entry with your own email.
3. Go to Voyado Engage and search for the email you submitted.
4. Verify the contact was created and all mapped fields are filled in correctly.

Use a Real Email

Voyado may reject obviously fake email addresses. Use a real email for testing to avoid false errors.

Test Audience Targeting

If you also enabled audience targeting:

1. Make sure your Voyado link contains the configured parameter, for example ?eclub=VALUE.
2. Open that link in a browser.
3. Confirm the visit happens on a page where the Fluentos script is loaded.
4. Verify that the configured cookie is created in the browser.
5. Open a campaign that targets a Voyado audience and confirm it behaves as expected for that visitor.

Use an Incognito Window

Testing in a private/incognito window makes it easier to verify whether the cookie is being created from a clean state.

8. Troubleshooting

Integration validation fails:

• Verify the base URL starts with https:// and has no trailing slash
• Make sure the API key was copied in full - Voyado keys are long

Contacts not appearing in Voyado:

• Check that email is mapped in your campaign integration - it is required
• Look at the integration status in Fluentos for any error indicators
• Confirm your profile sync strategy is not set to “Update existing only” when you expect new contacts to be created

Automatic Retries

If Voyado’s API is temporarily unavailable, Fluentos automatically retries the submission. You will be notified by email if retries are exhausted.

Field values not syncing:

• Double-check the field names are selected correctly in the mapping
• Voyado field names are case-sensitive
• If using fixed values, make sure the value format matches what Voyado expects (e.g. true/false for preferences, YYYY-MM-DD for dates)

Audience targeting does not work:

• Verify Enable audience targeting is turned on in the Voyado integration
• Confirm the Soft Identification Key matches the Encryption key from Voyado
• Confirm the landing page URL contains the configured parameter, for example eclub
• Check that the Link parameter in Fluentos matches the parameter used in your Voyado links exactly
• Verify the configured cookie is created in the browser after visiting from a Voyado link
• Make sure the Fluentos script is loaded on the landing page where the visitor arrives