CRM migration
Field-level mapping, validation, and rollback between Pega Customer Engagement Suite and Salesforce Sales Cloud. We move data and schema; workflows are rebuilt natively in Salesforce Sales Cloud.
Pega Customer Engagement Suite
Source
Salesforce Sales Cloud
Destination
Compatibility
9 of 12
objects map 1:1 between Pega Customer Engagement Suite and Salesforce Sales Cloud.
Complexity
BStandard
Timeline
6-10 weeks
Overview
Moving from Pega Customer Engagement Suite to Salesforce is a structural migration because Pega's case-based data model does not map 1:1 to Salesforce's Account-Contact-Opportunity model. Pega treats every customer interaction as a case instance with configurable routing, SLA rules, and decision logic; Salesforce uses standard objects where Cases are service-trackable but not the primary relationship container. We extract Customer Profiles to Contact and Account, map Work Object histories to Salesforce Cases or Activity records depending on whether they represent service or sales engagements, and resolve the parent-record lookup chain before any bulk insert to avoid foreign-key failures. Pega's Next-Best-Action decisioning, Case Type routing rules, and low-code workflows do not migrate; we deliver a written specification document for each so the customer's Salesforce admin or implementation partner rebuilds them post-migration. Pega's per-case billing model is replaced by Salesforce's per-user model, which we model during scoping to ensure the destination tier is cost-justified against historical case volume.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a Pega Customer Engagement Suite object lands in Salesforce Sales Cloud, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Pega Customer Engagement Suite
Customer Profile
Salesforce Sales Cloud
Contact + Account
1:manyPega Customer Profiles store contact information, interaction history, and preferences. They map to Salesforce Contact (with standard fields: FirstName, LastName, Email, Phone, MailingAddress) and the related Account (CompanyName becomes Account Name; industry, annual revenue, and website map to Account fields). Relationships to organization-level entities in Pega become Account-Contact hierarchy lookups in Salesforce. We resolve the Account before inserting Contacts so the AccountId foreign key is satisfied at insert time.
Pega Customer Engagement Suite
Case
Salesforce Sales Cloud
Case
1:1Pega Cases represent service requests, complaints, and inquiries. Each case instance carries pyStatusWork, pyAssignment, and SLA metadata. We map Case ID to Salesforce Case Number, Case priority to Priority, the Pega assigned user to Salesforce OwnerId via User email lookup, and the customer reference to ContactId or AccountId on the Case. Closed and open case statuses map to Salesforce Case Status picklist values that we configure in the destination org before migration.
Pega Customer Engagement Suite
Work Object
Salesforce Sales Cloud
Case or Task
1:1Work Objects are case instances created from Case Type templates with pyStatusWork and pyAssignment fields. We extract all work object records including current assignment, stage, and audit history. If the Work Object represents a service interaction, it maps to Salesforce Case; if it represents a sales or operational process, it maps to Task or Event with a WhatId pointing to the related Account or Opportunity. The mapping decision is made during scoping based on the Case Type category in Pega.
Pega Customer Engagement Suite
Entity
Salesforce Sales Cloud
Account, Contact, or Custom Object
1:1Pega Entities are core data model objects that map to database tables. Organizations often add custom entities beyond Pega's standard ones. We audit every Entity in the source system during discovery, map standard entities to Salesforce standard objects (Account, Contact, Product2), and map custom entities to Salesforce custom objects with __c API names. We pre-create the destination schema including all custom fields, lookup relationships, and validation rules before any data import.
Pega Customer Engagement Suite
Data Page
Salesforce Sales Cloud
Custom Object or Custom Fields
1:1Data Pages are cached data structures used by Pega applications to retrieve and display information. We extract the cached data values and map them to equivalent custom objects or custom fields in Salesforce. If the Data Page represents a reference dataset (country codes, product lists, pricing tiers), it becomes a Salesforce Custom Object; if it represents a single attribute on a Contact or Account, it becomes a custom field on that object. The dependency on the parent Entity is resolved before insert.
Pega Customer Engagement Suite
Case Type
Salesforce Sales Cloud
Case Record Type + Case Status
lossyCase Types define the template for cases including stages, steps, assignments, and routing rules. We document Case Type configurations as specifications for manual rebuild in Salesforce as Case Record Types and Case Status values. The Case Type name becomes the Record Type label; stage transitions become Case Status picklist entries. This is not an automated migration because Pega's routing logic and SLA enforcement have no direct Salesforce equivalent.
Pega Customer Engagement Suite
Custom Fields
Salesforce Sales Cloud
Custom Fields
1:1Custom fields extend standard Pega objects and are associated with Rules. We extract field names, data types, and all populated values. Each custom field maps to a Salesforce custom field of the equivalent type (text to Text, numeric to Number, date to Date, picklist to Picklist). Multi-value fields map to Salesforce multi-select picklists. Field-level mapping is required due to differences in Pega's property model and Salesforce's field type constraints.
Pega Customer Engagement Suite
Assignment Record
Salesforce Sales Cloud
Task + User
1:1Pega assignment records track who is responsible for a Work Object at each stage. We extract assignment history (assignee, timestamp, status) and map it to Salesforce Task records with TaskSubtype=Call or Task (depending on assignment type) linked to the parent Case or Work Object. The Pega assignee email resolves to Salesforce User OwnerId via the User mapping table.
Pega Customer Engagement Suite
Case History / Audit Trail
Salesforce Sales Cloud
CaseComment + EmailMessage
1:1Pega stores a complete audit trail for each case including status changes, user actions, and system events. We extract the case history and map it to Salesforce CaseComment records for human-authored notes and to EmailMessage or Task records for automated system events. Timestamps preserve the original Pega creation and modification dates via Salesforce CreatedDate and LastModifiedDate fields.
Pega Customer Engagement Suite
SLA Configuration
Salesforce Sales Cloud
Case Milestones
lossyPega SLA rules define entitlement time targets per case type and priority. We document SLA configurations as a written specification for Salesforce Case Milestones (Service Cloud) or as custom fields (FirstResponseDate, ResolutionDate) on the Case object. SLA breaches map to a custom text field recording the Pega SLA status at migration time. This is configuration rather than data because Salesforce milestones are calculated at runtime, not stored historically.
Pega Customer Engagement Suite
Decisions (Next-Best-Action)
Salesforce Sales Cloud
None
1:1Pega's Decision Manager and Next-Best-Action rules are AI-driven logic trees specific to Pega's decisioning engine. These cannot be extracted and translated to other platforms. We deliver a written specification for each Decision rule documenting its trigger conditions, business logic branches, and recommended Salesforce Einstein Next Best Action or Salesforce Flow equivalent. Rebuild is scoped separately.
Pega Customer Engagement Suite
Workflows
Salesforce Sales Cloud
None
1:1Pega workflows (cases, processes, and service levels) are authored in Pega's low-code BPMN-adjacent syntax. The platform does not export workflows in a standard format compatible with Salesforce. We document every active workflow including its trigger, conditions, actions, and SLA configuration as a written specification for manual rebuild in Salesforce Flow. This is the highest-scope documentation deliverable for Pega-to-Salesforce migrations and typically requires a separate implementation engagement.
| Pega Customer Engagement Suite | Salesforce Sales Cloud | Compatibility | |
|---|---|---|---|
| Customer Profile | Contact + Account1:many | Fully supported | |
| Case | Case1:1 | Fully supported | |
| Work Object | Case or Task1:1 | Fully supported | |
| Entity | Account, Contact, or Custom Object1:1 | Fully supported | |
| Data Page | Custom Object or Custom Fields1:1 | Fully supported | |
| Case Type | Case Record Type + Case Statuslossy | Fully supported | |
| Custom Fields | Custom Fields1:1 | Mapping required | |
| Assignment Record | Task + User1:1 | Fully supported | |
| Case History / Audit Trail | CaseComment + EmailMessage1:1 | Fully supported | |
| SLA Configuration | Case Milestoneslossy | Fully supported | |
| Decisions (Next-Best-Action) | None1:1 | Fully supported | |
| Workflows | None1:1 | Not supported |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
Pega Customer Engagement Suite gotchas
Case-based pricing model is migration-critical
Version upgrades deprecate rules and break custom applications
Workflow and decision logic require complete manual rebuild
Limited documented bulk export API
Salesforce integration gaps reported in production
Salesforce Sales Cloud gotchas
Workflow Rules and Process Builder are retired
Bulk API batch quota exhaustion during large imports
Storage overage billing is non-obvious
Account-Contact many-to-many relationship mapping
Territory and team member import ordering dependencies
Pair-specific challenges
Migration approach
Discovery and source audit
We audit the Pega Customer Engagement Suite instance across version, custom Entities, Data Pages, Case Types, and active workflow count. We inventory every Customer Profile, Case, Work Object, Assignment record, and SLA configuration. We document which Decision rules and workflows are active versus archived. We model the per-case Pega licensing cost against Salesforce per-user tiers to confirm the destination edition is cost-justified. The discovery output is a written migration scope with record counts per object, a schema map of source Entities to destination objects, and a Decision-rule and workflow inventory requiring rebuild.
Data extraction strategy and connectivity
We establish data extraction access using Pega's native export tools, REST API for real-time objects, and direct database access where the customer grants schema-level permissions. We extract Customer Profiles first (the base entity for all lookups), then Case and Work Object records, then assignment history and SLA data. For archived or large-volume case histories, we coordinate database-level exports in batches to avoid Pega Cloud service health limits. We validate extraction completeness against the source record counts before proceeding to transformation.
Schema design and Salesforce destination setup
We design the Salesforce destination schema including standard object configuration (Case Record Types, Case Status values, Account-Contact hierarchy), custom objects (with __c API names matched to Pega Entity names), custom fields (with type-mapped Salesforce field types), and validation rules. We pre-create the schema in a Salesforce Sandbox (Full Copy or Partial Copy) and validate it with a subset of source records before production migration. We configure SLA-equivalent custom fields on Case (FirstResponseTarget, ResolutionTarget, SLAStatus) during this phase.
Lookup resolution and parent-record staging
We build the lookup resolution table that maps every Pega Customer Profile ID to its Salesforce ContactId and AccountId. This table is required before any Case or Work Object insert because Salesforce enforces foreign-key constraints. We also resolve Pega user assignee emails to Salesforce User IDs for OwnerId population. Any Pega Customer Profile that cannot resolve to a Salesforce Contact or Account goes to a reconciliation queue for the customer's admin to resolve before Case migration begins.
Sandbox migration and reconciliation
We run a full migration into the Salesforce Sandbox using production-like data volume. The customer's Salesforce admin reconciles record counts (Contacts in, Accounts in, Cases in, Tasks in), spot-checks 25-50 random records against the Pega source, and validates that SLA-equivalent fields populated correctly. Any mapping corrections and lookup failures are resolved here. The admin signs off the schema and mapping before we schedule production migration.
Production migration in dependency order
We run production migration in record-dependency order: Accounts (from Pega organization entities), Contacts (with AccountId resolved), Cases (with ContactId and AccountId resolved), Work Objects (mapped to Case or Task), Assignment history (as Task records), Case History (as CaseComment and EmailMessage), Data Pages (as Custom Object records), and Custom Fields on all objects. SLA documentation is written during migration and delivered as a separate specification file. Each phase emits a row-count reconciliation report before the next phase begins.
Cutover, validation, and workflow rebuild handoff
We freeze Pega writes during cutover, run a final delta migration of any records modified during the migration window, then enable Salesforce as the system of record. We deliver the Decision-rule inventory, Workflow specification document, and Case Type configuration document to the customer's Salesforce admin. We support a one-week hypercare window where we resolve any reconciliation issues. Workflow and Next-Best-Action rebuild in Salesforce Flow is a separate engagement scoped after migration unless explicitly included in the statement of work.
Platform deep dives
Pega Customer Engagement Suite
Source
Strengths
Weaknesses
Salesforce Sales Cloud
Destination
Strengths
Weaknesses
Complexity grading
Standard CRM migration. 2 of 8 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Pega Customer Engagement Suite and Salesforce Sales Cloud.
Object compatibility
2 of 8 objects need a mapping; the rest are 1:1.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
8-object category — typical timelines run 2–7 days end-to-end.
API constraints
Pega Customer Engagement Suite: Not publicly documented.
Data volume sensitivity
Pega Customer Engagement Suite doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during Pega Customer Engagement Suite to Salesforce Sales Cloud migration scoping. Not seeing yours? Book a call.
Walk through your Pega Customer Engagement Suite to Salesforce Sales Cloud migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Pega Customer Engagement Suite
Other ways to arrive at Salesforce Sales Cloud
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.