Skip to main content

Dotdigital Integration

Swym-Dotdigital Integration

Updated over a week ago

This integration connects Swym apps with Dotdigital, enabling you to send personalized, triggered emails based on customer shopping journey data like wishlist activity and back-in-stock subscriptions.

How It Works

Swym uses Dotdigital APIs to send emails. The process involves setting up API authentication in Dotdigital, creating email templates for various alerts, and then configuring Swym with the corresponding template IDs. Swym tracks user actions and triggers the relevant emails through your Dotdigital account.

Requirements

  • Wishlist Plus and/or Back in Stock Alerts app installed.

  • Swym Starter plan or higher.

  • Email templates created in Dotdigital for enabled messages.

Configuration Steps

  • Note: This integration requires intervention from the Swym support team.

  • Create API User in Dotdigital:

    1. Log into Dotdigital, go to the settings menu (user-gear icon), and open the Access section.

    2. Click API User > New User. Note the API endpoint for later.

    3. Enter a description, create and confirm a password, and click Save. Remember the email (username) and password.

  • Configure in Swym Admin:

    1. Log into Swym Admin and go to Integrations. Click Configure on the Dotdigital card.

    2. Under Authentication, enter the Username (email) and Password from Step 1.

    3. For Host Name, enter the API Endpoint from Step 1 without the "https://" (e.g., r1.api.dotmailer.com).

    4. Click Save Changes.

  • Enable Integration:

    1. To use Swym's default templates: Click the Enable button in the General section. This creates a support ticket for the Swym team to complete the setup.

    2. To use your custom templates:

      • Create and upload your HTML email templates in Dotdigital (Email Campaigns > Custom Templates).

      • Open each uploaded template and find its Template-ID in the browser's URL.

      • In Swym Admin's Dotdigital configuration, scroll to the Events section and enter the corresponding Template-IDs for each message type. Click Save Changes.

    3. Scroll up to the General section and click Enable. This will notify the Swym support team to validate and finalize the setup.

  • Enable 'Add To Mailing List' Feature

    1. Ensure authentication credentials are set up correctly.

    2. In the Swym Admin, under the Marketing Lists section for Dotdigital, click Fetch List IDs.

    3. Select the desired Dotdigital list from the dropdown menu.

    4. Click Save Changes. The Swym support team will review and enable the feature.

Merge Tags:

Use the provided merge tags like {{merge-tags}} in your Dotdigital templates to populate dynamic content such as product name (Title), price (Price), and image URL (ImageURL). A full list is available in the source documentation for different email types (Auth, ShareWishlist, Backinstock, etc.).

Did this answer your question?