The VWAM–CDP integration turns customer conversations into structured, actionable data. Instead of conversational insights being lost after a session, they are captured as profile properties and stored in the BlueConic CDP. Use real-time customer intent and preferences across your entire marketing ecosystem for personalization, segmentation, email, ads, and more.
With this integration, you can:
Capture high-intent data from conversations
Automatically extract preferences, needs, and signals directly from chat interactions.Build a unified customer profile
Combine conversational data with all other customer data in the CDP.Activate data across channels
Use captured attributes for personalization, segmentation, email, ads, and more.Reduce setup complexity
No data mapping or duplication—profile properties are shared between VWAM and the CDP.
Before you begin
Ensure you have a CDP tenant created.
Ensure you have a VWAM workspace ready to authenticate.
Profile Properties are only available after a CDP connection is established.
Set up the VWAM–CDP integration
Connect VWAM to the CDP
Log into the BlueConic CDP.
Click Connections and select VWAM as a connection
Enter the name and metadata for this connection.
Under Authenticate select Connect and authenticate your VWAM workspace. Once connected, the Profile Properties section becomes available in VWAM, and VWAM can begin reading and writing data to the CDP.
Select the OAuth2 app you created in the prerequisites step. Once authenticated, you will be able to select from your already-defined OAuth2 applications set up in the CDP.
Note: the OAuth2 app selector only becomes available after authentication is complete. When the connection is saved and turned on, these credentials are shared with VWAM.
Create and manage profile properties
Profile properties define the data you want to capture from conversations. Create them in VWAM or directly in the CDP.
Option A: Create in VWAM
Go to Profile Properties in VWAM.
Click Create Property.
Define the following:
Name (required)
Description (optional, but recommended — helps guide the AI)
Type:
Predefined — AI selects from a fixed list of values; ensures clean, consistent data
Dynamic — AI extracts the most relevant value from conversation context; useful for open-ended inputs
Once created, the property is automatically available in the CDP.
Option B: Create in the CDP
Go to the Profile Properties section in the CDP.
Create the property.
Add it to your VWAM connection. The property appears in the VWAM UI and can be used immediately.
Tip: Always fill in the description field. Profile property names alone are often not descriptive enough for the AI to reliably identify the right values in a conversation.
Configure how values are captured
VWAM uses AI to identify and extract values during conversations. How this works depends on the property type:
Predefined properties
AI selects from a fixed list of values
Ensures clean, consistent data
Dynamic properties
AI extracts the most relevant value from conversation context
Useful for open-ended inputs
Launch your chat experience
Deploy and Publish your VWAM chat agent.
Confirm your site has the CDP script installed — if it's not detected, VWAM automatically injects it
Go live.
As consumers interact with your chat, the AI extracts relevant attributes in real time, sends data directly to the CDP, and updates profile properties instantly.
FAQ
Do I need a CDP connection to use profile properties?
Yes. Profile properties are only available once your VWAM workspace is connected to a BlueConic CDP tenant.
Where is the data stored?
All profile properties are stored in the CDP, not in VWAM. VWAM acts as the interface for creating and managing them.
Can I create properties in both VWAM and the CDP?
Yes. The integration is two-way: properties created in VWAM are automatically available in the CDP, and properties created in the CDP are available in VWAM once added to the connection.
Is there any data mapping required?
No. VWAM and the CDP share the same profile properties, so no mapping layer is needed.
When is data captured?
Data is captured in real time during the conversation, not after the session ends.
What happens if AI can’t determine a value?
For predefined properties: no value will be stored if there’s no match.
For dynamic properties: AI will return the best possible value based on context.
Can I control which properties VWAM writes to?
Yes. When using properties created in the CDP, you can choose which ones VWAM can read and write to through the connection.
How can I use this information for integrations?
Once the data is passed to the CDP, you can leverage profile properties in all the Connections you have setup within the CDP. They can also be used to launch Dialogues and other activations.
How does the system handle anonymous users?
Once a CDP connection is set up, the CDP script runs within the VWAM chat experience and begins capturing data for all users—including anonymous visitors.
If a user is anonymous, their data is still collected and stored in the CDP.
When that user later becomes known (for example, by logging in or submitting an email), the CDP can merge the anonymous profile with the known profile.
This ensures that early intent signals from conversations are not lost.
To fully take advantage of this, you should configure profile merge rules within the CDP. Once merged, this data can be used for more advanced activation, such as personalization or sending data to downstream systems like your ESP.


