Cordial

This integration is in beta

The‍
Cordial
integration is currently in beta.
As with all beta tests, not everything will be perfect. If you run into any issues, please submit a support ticket.

Connecting Lexer and Cordial

Cordial is a marketing and data platform that allows marketers to create, scale, and optimize personalized experiences across email and mobile. Lexer supports connecting to both the Cordial API and SFTP. This allows us to both pull and push data between the two systems respectively.

In this article, we explain how to establish an API connection that lets you consume campaign engagement data from Cordial, as well as connecting Lexer to your Cordial SFTP, which enables the activating of Lexer Segments into Cordial for campaign segmentation and personalization.

Benefits of a Cordial integration

Integrating your Cordial account with Lexer provides a number of benefits, such as:

  • Importing your contacts as enriched profiles.
  • Creating attributes that can be used for customer segmentation and analysis

Integration in a nutshell

Here's a summary of how Cordial integrates with Lexer:

Direction

What direction does the data flow?

✅ Data in: enriched customer profiles.

✅ Data out: Enriched customer segments ready for activation.

Type

Lexer’s integration with this product allows you to pull data into the hub from these sources.

✅ Email

⬜️ SMS

Source method

How the system connects with Lexer.

✅ File (S3)

Destination method

How Lexer connects with the system.

✅ File (SFTP)

Status

Is this integration live and working?

Full Release

Lexer product compatibility

What Lexer products is the integration compatible with?

✅ Compare

✅ Segment

✅ Track

⬜️ Activate

⬜️ Listen

⬜️ Respond

⬜️ Serve

Attributes

No attributes will be created as part of this integration.

Attributes

This integration allows for some flexibility, the output of the integration depends on your available data and what you send through to Lexer. In addition, your attributes could be named in a different way to other clients. If you would like a list of attributes related to this integration, please email your Success Manager.

Attributes

What attributes are created when integrated with Lexer?

Cordial Relationship

✅ Cordial Record

Cordial Email Engagement

✅ Email Source

✅ Number of Emails Sent

✅ Email Engagement Category

✅ Email Opt-In Status

✅ Campaigns Sent

✅ Email Open Rate

✅ Email Click Rate

✅ Email Subscribe Date

✅ Last Email Open

✅ Open Date

✅ Campaigns Opened

✅ List Name

✅ Date of Last Open

✅ Date of Last Click

✅ Click Dates

✅ Last Email Click

✅ Campaigns Clicked

Attributes

These are the standard attributes Lexer can create when you connect this integration, however, this will depend on the data available and what you're sending through to Lexer. Also note, your attributes may be named differently.
If you have any questions, or would like to discuss any custom options, please reach out to your Success Manager.

Connecting to the Cordial API

Connecting to the Cordial API requires you to create an API key within Cordial's UI. Cordial have this helpful guide that explains the process.

When creating an API Key in Cordial you must whitelist IP addresses. This ensures that only Lexer's servers can communicate with your Cordial data. Make sure you add all 9 IP addresses below:

  • 13.236.23.243
  • 3.105.80.117
  • 3.104.174.102
  • 3.104.16.54
  • 3.105.15.111
  • 3.105.117.64
  • 52.26.215.110
  • 52.26.99.95
  • 52.89.188.197

Once your key has been generated, navigate to Integrations via Manage within Lexer.

  1. Find the Cordial tile and click on it.
  2. Click Integrate Cordial.
  3. Name the integration appropriately if you are connecting more than one account so you can easily differentiate.
  4. Paste in your API key.
  5. Click Save Integration.
The final step!
Once you've added your Cordial account credentials to the Cordial tile in the Hub, please contact your Success Manager, or Lexer Support (support@lexer.io) to complete your Cordial set up and configuration.

You've now successfully connected your Cordial account to Lexer via the Cordial API. Lexer can now start consuming your campaign engagement data, enriching your CDP profiles.

Connecting your Cordial SFTP

You can link your Cordial and Lexer hubs via SFTP to enable sending of customer profiles from Lexer, into Cordial. This allows the enrichment of Cordial data, as well as the adding of new records.

To connect both hubs, you first need to have your Cordial SFTP whitelisted by Lexer. This involves generating a Public Key in Cordial's UI, and then sending that to Lexer Support or your Success Manager. You will also need to provide the three IP addresses below;

  • 75.26.3.241/32
  • 52.9.134.47/32
  • 52.9.134.92/32

Creating a Public Key in Cordial

You will first need to login to your Cordial account to create a Public Key. Once logged in:

  1. Under your username, in the top right hand corner, navigate to Account Settings.
  2. On the left hand side of screen, click on Secrets Vault.
  3. Create a new "secret" (key) by clicking the New button, and giving it a name, and description.
  4. After you save it, a pop up will appear with a long string of numbers, letters and symbols. You will need to send this to Lexer Support or your Success Manager.

From here, our team will ensure your key and the IP addresses above are whitelisted against your Lexer SFTP. Once we've notified you that this has been done, you will be able to start transferring CSV files containing records from Lexer into Cordial.

Using a FIXED VALUE field to make audiences "segment ready" in Cordial

To ensure you can recreate your Segment in Cordial, you will need to use the FIXED ATTRIBUTE VALUE field. Given we are effectively sending across a CSV of customer data, this is simply adding a column to that CSV file.

Create a new Segment in the hub to determine the target audience you intend to activate to Cordial. To learn more about how to create a segment, click here.

Navigate to Engage > Activate.

  1. Click on New Activation.
  2. Open your activation account, in this example we have opened, “Cordial Test”.
  3. Find the segment you created earlier in the process. In this example we have included the Zero Profile Segment.
  4. Give the activation a name. Make sure you record this name, this will become the name of the file once it arrives in Cordial. For example, if your activation name is 210112 High Value customers, it will be. 210112_High_Value_customers.csv in Cordial
  5. Add any attributes you want to send to Cordial. In our example, the default attributes have been included, Email and First name. You can add more if you would like.
  6. Now, click Create New Fixed Value.
    1. Set the field value to "1".
    2. Add a name to the segment column (Note: Any spaces will be converted into underscores).
    3. If you are just making a single segment, one fixed value will suffice.
    4. If you also wanted to add a group level coupon code, you could do that here.
  7. Determine whether you would like to Append activation name to included profiles. In most cases, you'll want this ticked.
  8. Determine whether you would like to split your audience. The default setting is Don't Split.
  9. Agree to the terms.
  10. Click Run Activation.

Sending records to Cordial

  1. Determine the segment you would like to send to Cordial.
  2. Navigate to Cordial and login.
  3. Navigate to Contacts > Import Contacts.
  4. Select the SFTP option, and enter the details as displayed in the table below. If you are unsure about any of these please contact Lexer Support (support@lexer.io).
  5. Next to Authentication select Saved Key and drop the drop down select your previously saved public key.
  6. You can elect to have your file imported instantly or on a schedule, if you want to maintain the audience in Cordial select schedule.
  7. Click Continue and follow the prompts to import your data and name your import.
  • Server Domain (AU customers): au.transfer.lexer.io
  • Server Domain (US customers): us.transfer.lexer.io
  • Port: 22
  • Path: exports/cordial/<file_name>.csv
  • Username: eg Lexer would be lexer


Finally, you can click RUN ACTIVATION / RE-RUN ACTIVATION

You're done!

Congratulations, your Cordial account should now be integrated and activated in Lexer. We've gone through what Cordial is, the type of integration it is, its benefits, and how to integrate and activate it. There's a lot of steps to follow here and if you feel stuck or confused please don't hesitate to reach out to Lexer Support (support@lexer.io) if you need any help.

Updated:
April 4, 2023
Did this page help you?
Thank you! Your feedback has been received!
Oops! Something went wrong while submitting the form, for assistance please contact support@lexer.io
Welcome to Lexer!
Fundamentals
Getting started
Our glossary
Fundamentals
Getting started
Integrations
Fundamentals
Setup
My account
Fundamentals
Setup
Manage team
Fundamentals
Setup
Group permissions
Fundamentals
Setup
Classifications
Fundamentals
Setup
Out of the box segments
Fundamentals
Setup
Lexi your AI companion
Fundamentals
Lexi
Browser guide
Fundamentals
Security
Corporate networks
Fundamentals
Security
Emergency contact
Fundamentals
Security
Multi-factor authentication
Fundamentals
Security
Single sign-on
Fundamentals
Security
Trust and compliance
Fundamentals
Security
Lexer's Identity Resolution
Fundamentals
Identity Resolution
Lexer's ultimate troubleshooting guide
Fundamentals
Troubleshooting
Troubleshooting tech issues
Fundamentals
Troubleshooting
Troubleshooting integrations
Fundamentals
Troubleshooting
Troubleshooting Activate
Fundamentals
Troubleshooting
Troubleshooting Respond
Fundamentals
Troubleshooting
Help! My data is missing from the Hub
Fundamentals
Troubleshooting
Understanding APIs at Lexer
Data
Data Onboarding
Providing JSON data to Lexer
Data
Data Onboarding
Providing CSV data to Lexer
Data
Data Onboarding
Upload using SFTP
Data
Data Onboarding
Upload using S3
Data
Data Onboarding
Lexer data specification
Data
Lexer Data Specification
Customer data specification
Data
Lexer Data Specification
Commerce data specification
Data
Lexer Data Specification
Marketing data specification
Data
Lexer Data Specification
Compliance data specification
Data
Lexer Data Specification
Data formatting and validation
Data
Getting Started with APIs
Authentication and API token creation
Data
Getting Started with APIs
Rate limits
Data
Getting Started with APIs
Response codes and common errors
Data
Getting Started with APIs
Product imagery
Data
Getting Started with APIs
Currency conversion
Data
Getting Started with APIs
Lexer’s APIs overview
Data
Lexer’s APIs
Bulk write API
Data
Lexer’s APIs
Chatbot user API
Data
Lexer’s APIs
Activity API
Data
Lexer’s APIs
Visualize API
Hidden from nav
Profile read API
Data
Lexer’s APIs
Lexer Javascript Tag basics
Data
Lexer Javascript Tag
Lexer Javascript Tag technical guide
Data
Lexer Javascript Tag
Lexer Javascript Tag use cases
Data
Lexer Javascript Tag
dataLayer configuration: Shopify
Data
Lexer Javascript Tag
Customer segment CSV export
Data
Data off-boarding
Export to CSV
Measure
Listen
Data in Lexer's CDXP
Data
Customer Data
Lexer's attributes
Data
Customer Data
Attribute value types
Data
Customer Data
Data source - CRM
Data
Customer Data
Data source - Email
Data
Customer Data
Partner data - Experian
Data
Customer Data
Partner data - Mastercard
Data
Customer Data
Partner data - Roy Morgan
Data
Customer Data
GDPR and CCPA requests
Data
Customer Data
Upload data files
Data
Customer Data
File upload API
Data
Lexer’s APIs
Segment overview
Understand
Segment
Creating segments
Understand
Segment
Smart Search
Understand
Segment
Export attribute results
Understand
Segment
Contact a customer
Understand
Segment
Fixing a disabled segment
Understand
Segment
Profile tab
Understand
Segment
Compare segments
Understand
Compare
Compare attributes
Understand
Compare
Activate overview
Engage
Activate
Ongoing activations
Engage
Activate
Audience splits
Engage
Activate
A/B splits
Engage
Activate
Control group splits
Engage
Activate
Inbox filtering
Engage
Respond
Ignored Senders
Engage
Respond
Forms for service
Engage
Respond
Workflow states
Engage
Respond
Bulk changes
Engage
Respond
Scheduled replies
Engage
Respond
Message templates
Engage
Respond
Customer profiles
Engage
Respond
Grouped messages
Engage
Respond
Automation rules
Engage
Respond
Where do your best customers live? Use geographic insights to maximize media spend and conversion
Grow
Where do your best customers live? Use geographic insights to maximize media spend and conversion
Suppression audiences: How to use them and maximize your media effectiveness
Enrich
Suppression audiences: How to use them and maximize your media effectiveness
Measure campaign effectiveness: Track your KPIs and report on campaign performance
Enrich
Measure campaign effectiveness: Track your KPIs and report on campaign performance
Converting prospects: Acquire customers from your current, engaged prospect base (and save your ad spend!)
Acquire
Converting prospects: Acquire customers from your current, engaged prospect base (and save your ad spend!)
Understanding customer intent: Effective message personalization for buyers who shop outside their gender
Grow
Understanding customer intent: Effective message personalization for buyers who shop outside their gender
Deepen customer understanding: Use third-party data to identify insights for personalized messaging and increased engagement
Grow
Deepen customer understanding: Use third-party data to identify insights for personalized messaging and increased engagement
Basket analysis: Increasing customer lifetime value through targeted product bundling
Grow
Basket analysis: Increasing customer lifetime value through targeted product bundling
Persona building: Personalize your messaging for maximum return on your campaign investments
Grow
Persona building: Personalize your messaging for maximum return on your campaign investments
Driving customer loyalty: Identify, keep, and grow your most loyal customers
Retain
Driving customer loyalty: Identify, keep, and grow your most loyal customers
Increasing customer lifetime value: Upselling strategies
Grow
Increasing customer lifetime value: Upselling strategies
Reactivating lapsed customers for retention and growth
Retain
Reactivating lapsed customers for retention and growth
Welcome offer strategies: Using the Hub for analysis
Acquire
Welcome offer strategies: Using the Hub for analysis
Creating customer forms: Best practices
Enrich
Creating customer forms: Best practices
Connecting your MarTech stack with Lexer!
Enrich
Connecting your MarTech stack with Lexer!
Identifying win-back customers using the Second Last Order: Date attribute
Retain
Identifying win-back customers using the Second Last Order: Date attribute
Understanding your customers' purchasing habits with the Order Sequence filter
Grow
Understanding your customers' purchasing habits with the Order Sequence filter
Maximizing customer communications in Respond
Retain
Maximizing customer communications in Respond
Using Product Recommendation in the Hub to encourage repeat purchases
Grow
Using Product Recommendation in the Hub to encourage repeat purchases
Encouraging customer loyalty using birthday campaigns
Retain
Encouraging customer loyalty using birthday campaigns
Increasing customer lifetime value: Converting your one-time buyers into two-time buyers
Grow
Increasing customer lifetime value: Converting your one-time buyers into two-time buyers
Collecting zero-party data using Lexer Forms
Enrich
Collecting zero-party data using Lexer Forms
Measuring your data over time with Track
Enrich
Measuring your data over time with Track
UTM Creation Guidelines
UTM Creation Guidelines
UTM Creation Guidelines
Brand Assets
Brand Assets
Brand Assets
GTM guide to creating marketing materials with Lexer
GTM guide to creating marketing materials with Lexer
GTM guide to creating marketing materials with Lexer
How to use the Lexer Form Builder
How to use the Lexer Form Builder
How to use the Lexer Form Builder
Explore our standard integrations
Explore our standard integrations
Explore our standard integrations
Operating a CDP Practice LP
Operating a CDP Practice LP
Operating a CDP Practice LP
LP Sales Enablement
LP Sales Enablement
LP Sales Enablement
Video Training Courses LP
Video Training Courses LP
Video Training Courses LP
Purpose and Mission
Purpose and Mission
Purpose and Mission
Brand & Marketing LP
Brand & Marketing LP
Brand & Marketing LP
Stage 3 - QBRs and Customer insights
Stage 3 - QBRs and Customer insights
Stage 3 - QBRs and Customer insights
Client Onboarding Journey
Client Onboarding Journey
Client Onboarding Journey
Start your CDP Practice
Start your CDP Practice
Start your CDP Practice
Lexer Messaging
Lexer Messaging
Lexer Messaging
Pain point conversations
Pain point conversations
Pain point conversations
Lexer Ideal Customer Profile & Positioning
Lexer Ideal Customer Profile & Positioning
Lexer Ideal Customer Profile & Positioning
Referral Partner Program Overview
Referral Partner Program Overview
Referral Partner Program Overview
Demo Hub Guide
Demo Hub Guide
Demo Hub Guide