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.

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 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 environment typically has 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. 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
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.

3. 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.

4. 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.

5. 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.

6. 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

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)

Automatic Retries

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