Migrate from Unthread to Puzzel Case Management

MIGRATION OVERVIEW

Why teams migrate from Unthread to Puzzel Case Management

There is no native migration path between Unthread and Puzzel Case Management, and no third-party migration tool supports this specific pairing. Unthread's Slack-native, conversation-centric data model—built around Conversations, Customers, Accounts, Tags, and Ticket Types—must be structurally translated into Puzzel's contact-centre-oriented schema of Tickets, Organisations, Teams, Categories, Forms, and Form Fields, with no 1:1 entity mapping available. All data must be extracted via Unthread's REST API (paginated at 100 records with cursor-based iteration) and loaded into Puzzel one ticket at a time through API ticket channels, while Slack-proprietary markdown, user mentions, and threaded message hierarchies require custom transformation into standard HTML. Automations, SLA rules, and AI workflows cannot be migrated programmatically and must be rebuilt manually in Puzzel.

KEY CHALLENGES

What makes this migration complex

These are the architectural mismatches and technical hurdles specific to a Unthread to Puzzel Case Management migration.

Most Critical

No Native Export Path

Unthread lacks a bulk CSV export for ticket data, requiring all extraction to be performed through its REST API with cursor-based pagination at 100 records per page.

Incompatible Data Models

Unthread's Conversations, Customers, Accounts, Tags, and Ticket Types do not map 1:1 to Puzzel's Tickets, Organisations, Teams, Categories, Forms, and Form Fields, requiring deliberate structural translation decisions for each entity.

Slack Markup Translation

Slack-proprietary formatting including user mentions (<@U12345>), channel references, and Block Kit markup must be parsed and converted into standard HTML to avoid rendering as raw text in Puzzel.

Thread Flattening Complexity

Hierarchical Slack conversation threads must be flattened into chronological ticket interactions while preserving reply chains and the distinction between internal and external messages.

Attachment URL Expiration

Slack-backed file URLs used by Unthread typically expire within hours, requiring all attachments to be downloaded and re-uploaded before cutover to avoid permanent data loss.

Automation and SLA Rebuild

Automations, SLA rules, and AI workflows from Unthread cannot be migrated programmatically and must be manually recreated within Puzzel's configuration framework.

MIGRATION RISK ASSESSMENT

Every migration risk, already solved

Migration between platforms is full of edge cases. Our engineers have identified every risk from Unthread to Puzzel Case Management and built proven solutions for each one.

Migration Challenge ClonePartner Status

High Complexity —

Solved

Tickets (Conversations)

Unthread conversations must be structurally translated into Puzzel tickets with no 1:1 mapping, and threaded Slack messages must be flattened into chronological interactions without losing reply context.

Solved

Message History

Each conversation's full message thread must be individually fetched via the API, and Slack markdown, user mentions, and Block Kit formatting require custom parsing to render correctly in Puzzel.

Solved

File Attachments

Slack-backed file URLs expire rapidly and return HTTP 403 errors after expiration, so all attachments must be downloaded proactively before cutover or they are permanently lost.

Solved

Custom Fields (Ticket Types)

Unthread Ticket Type fields—particularly multi-user-select and conditional fields—do not map cleanly to Puzzel's Form Fields and require explicit per-field transformation logic.

Solved

Automations and SLA Rules

No programmatic migration path exists for automations, SLA rules, or AI workflows—all must be manually audited and rebuilt from scratch in Puzzel.

Solved

Custom Engineering —

Handled

Customers / Contacts

Customer records must be mapped to Puzzel Contacts and Organisations, but Unthread's Slack-user-based customer identity model differs from Puzzel's email-centric contact structure.

Handled

Accounts / Organisations

Unthread Accounts must be translated into Puzzel Organisations with appropriate contact associations, requiring deduplication and relational integrity checks.

Handled

Tags and Categories

Unthread Tags must be mapped to Puzzel Categories, which may have different hierarchy and cardinality constraints requiring consolidation or restructuring.

Handled

Knowledge Base Articles

Articles require extraction from Unthread and reformatting for Puzzel's content structure, with embedded media and internal links needing manual review.

Handled

Clean Transfer

Agent / Team Assignments

Agent and team structures are relatively straightforward to recreate in Puzzel's Teams configuration, though Slack-based user IDs must be mapped to Puzzel agent identities.

Clean

5 high-complexity solved

4 custom-engineered

1 clean transfers

CUSTOM MIGRATION

Fully customizable engineer-led migration

Tailor your migration from Unthread to Puzzel Case Management exactly to your needs with our flexible customization options. Our experts will configure the perfect migration plan for your business.

Migration Filters

Data Types

ZERO DOWNTIME

Your timeline. Our engineers.

A dedicated engineer runs your migration, planned around your schedule and your data.

No babysitting a wizard. Avoid debugging errors yourself.

Looking for a more detailed migration timeline?

Contact our team

Speed

The migration timeline depends on both our turnaround time and yours.

We can complete a migration in under a day when the accounts are connected and the sample migration is approved promptly.

Background Sync

We also support migrating the newest records first, so you can go live faster while the rest of the data is synced in the background.

Data Volume Impact

Larger data volumes may require longer migration windows.

Continuous Operation

Weekend migrations minimize disruption to your customer service operations.

MIGRATION TIMELINE

Your Unthread to Puzzel Case Management migration, step by step

See how long your migration will take from start to finish. Drag the slider to estimate based on your data volume.

How many records are you migrating?

<10K 50K 100K 250K 500K 1M 2M 5M 10M+

Checklist ~3 days

Sample 1 day

Review ~2 days

Full 2 days

Delta 1 day

Your team ClonePartner

Estimated total

~9 business days

Migration Checklist

1 day · ClonePartner ~2 days · Your team

We prepare the optimal data mapping as a shareable spreadsheet. Your team reviews, approves, and adds any customizations.

Sample Migration

1 day · ClonePartner

We run a test migration with a representative sample of your data to verify mapping accuracy and identify any potential issues before the full run.

Review & Approve

~2 days · Your team

Your team reviews the sample migration results, confirms data accuracy and mapping, and gives the go-ahead for the full migration.

Full Migration

2 days · ClonePartner

We execute the complete migration of all your data to your new Puzzel Case Management, with real-time progress tracking and comprehensive logging.

Delta Migration

1 day · ClonePartner

We capture and transfer any new data that was added or updated during the main migration to ensure no data is lost. This final sync keeps everything current.

Pros and cons of different migration options

Choosing the right approach is key because migrating from Unthread to Puzzel Case Management isn't just about moving data – it's about protecting customer relationships.

Feature / Criteria	ClonePartner	Automated Tools	CSV Import	In-house migration
Custom Scripting for complex data	✓ Engineers build & maintain	✗ No	⚠ Manual	✓ Yes – but costly
Sandbox & Pilot Migrations	✓ Full sandbox + pilot plans	⚠ Limited	✗ No	⚠ Often Informal
Manual validation & reconciliation	✓ Automated + manual QA	✗ No	✓ Yes (Manual)	✓ Heavy manual effort
Backup & rollback plan	✓ Robust procedures	✗ No	✗ No	⚠ Often incomplete
Handles automation and integrations	✓ Full support	⚠ Partial	✗ No	⚠ Possible but fragmented
Post-migration engineer support	✓ Dedicated engineers	✗ No	✗ No	⚠ Limited SLA
Adaptable to API changes	✓ Proactive adaptation	✗ No	⚠ Manual fixes	⚠ Slower response
Turnaround / SLA predictability	✓ Predictable SLAs	⚠ Fast but brittle	⚠ Slow and manual	⚠ Often slower
Data Security & Compliance	✓ High – enterprise grade	⚠ Medium (depends)	⚠ Low (manual)	⚠ Hidden gaps common
Pricing predictability	✓ Transparent & fixed	⚠ Low (per-job)	⚠ Low (manual hours)	⚠ High/variable OPEX
End-to-end project management	✓ Full E2E delivery & PM	✗ No	✗ No	⚠ Often partial
Business impact & opportunity cost	✓ No diversion of staff	✗ No	✗ No	⚠ Diverts engineering

What does an Engineer-led migration mean anyway?

Speed & Accuracy: Our Blended Method

We blend automation (smart scripts, bulk APIs) with human expertise for speed without risk. Our engineers manually check every mapping, validation, and exception.

You get:

Speed of automation for bulk record migration
Precision of engineers verifying integrity and business logic
Pilot migrations and sandbox testing to catch issues early
Real-time validation reports and rollback readiness

Result: 50x faster migrations than manual imports — with near-zero error rates.

Handling the Tricky Tech and API Details

The Unthread and Puzzel Case Management APIs each behave differently, which is where our engineers shine. We build custom logic to handle the data quirks where generic tools typically break.

We handcraft API logic for:

Field mapping and transformation
Pagination, rate-limit handling, and throttling
Preserving conversation threads, attachments, and internal notes
Syncing custom fields, SLAs, and macros without breaking structure

Our scripts: Natively retry failed calls, re-queue large attachments, and ensure data parity.

No Guesswork

We don't just promise smooth migrations—we measure and prove them. Every client receives a Migration Validation Report with all metrics.

Typical results across projects:

100% record-count parity between your Unthread data and Puzzel Case Management
Zero downtime during staged cutovers
99.9% attachment integrity (verified via checksum)
Full automation and preservation of all business rules

Our standard: Includes full SLA preservation and 48 hours of engineer-assigned support post go-live.

We Adapt to Your Setup (Not the Other Way Around)

No two teams configure Unthread or Puzzel Case Management exactly the same way—with unique automations and data. We customize every migration script to fit your exact workflow, tags, and triggers.

Our engineers adapt for:

Custom fields, ticket forms, and workflows
Multi-brand or multi-language setups
Historical imports and partial (date-based) migrations
Integration re-mapping for CRMs, chat, or feedback tools

The promise: If your data doesn't fit a standard template, we build one just for you.

Enterprise-Grade Security & Compliance

Your customer data is precious. Our migration process maintains the highest standards of security and regulatory compliance.

SOC 2 Type II

Independently audited compliance with rigorous security standards

ISO 27001

Certified information security management system

GDPR

Full compliance with EU data protection regulations

HIPAA

Certified for handling protected health information

AES-256 Encryption

Bank-grade encryption for all stored credentials

Latest TLS

Secure transfer protocol for all data in transit

Role-Based Access

We follow role-based access control for every migration project

Scheduled Deletion

Automatic data purging after migration completion

FAQ

Frequently Asked Questions

Everything you need to know about migrating from Unthread to Puzzel Case Management. Can't find what you're looking for? Talk to our team.

Can I export data from Unthread as CSV?

No. Unthread does not offer a native CSV export for ticket data. All data extraction must go through the Unthread REST API (api.unthread.io/api/). List endpoints are paginated at 100 records per page using cursor-based pagination. You'll need a script to extract conversations, messages, customers, accounts, tags, and ticket types via POST /list endpoints.

Does Puzzel Case Management support bulk ticket import via API?

Puzzel Case Management supports ticket creation through API ticket channels configured in Settings > Ticket Channels > API with Basic Token or OAuth authentication. Tickets are created one at a time — there is no documented bulk import endpoint, so you'll need to loop through records with rate-limit handling.

How long does an Unthread to Puzzel migration take?

A typical mid-size migration (5,000–25,000 conversations) takes 2–4 weeks: 2–3 days for planning and mapping, 3–5 days for extraction, 3–5 days for transformation and test loading, 2–3 days for production loading and delta sync, and 2–3 days for validation and cutover. Smaller datasets under 1,000 conversations can be completed in 1–2 weeks.

What data is lost when migrating from Unthread to Puzzel?

You'll lose Slack-native threading context (threads become flat replies), Slack Block Kit formatting (must convert to HTML), conditional Ticket Type Field visibility logic, the built-in Knowledge Base (Puzzel CM has no native KB), AI auto-resolution workflows, and Slack-specific metadata like channel IDs and thread timestamps. Automations and SLA rules must be rebuilt manually in Puzzel's Event Rules.

Is there a third-party tool that migrates Unthread to Puzzel automatically?

No. At the time of writing, no third-party migration tool supports the Unthread-to-Puzzel Case Management pairing natively. You'll need either custom API scripts, a middleware platform like Pipedream for small ongoing syncs, or a managed migration service.

How long does the Unthread to Puzzel Case Management migration take?

Most migrations complete within 1–5 business days, depending on data volume and complexity. We provide a detailed timeline after the initial assessment and can often complete small migrations in under 24 hours.

Will my team lose access to Unthread during the migration?

No. Your source system remains fully operational throughout the entire migration. We run the migration in the background with zero downtime to your current operations.

Will there be downtime when migrating from Unthread to Puzzel Case Management?

No. Our migration process is designed for zero downtime. We use a staged approach with background sync and a fast cutover, ensuring no disruption to your live business operations.

How do I validate that everything migrated correctly?

Every client receives a Migration Validation Report with comprehensive metrics including record-count parity, attachment integrity verification via checksum, and full audit logs. We also offer unlimited sample migrations so you can verify before committing.

Do I need professional help for this migration?

While simple migrations can sometimes be handled in-house, professional help ensures zero data loss, proper field mapping, and preservation of relationships between records. Our engineer-led approach catches edge cases that automated tools miss.

Does ClonePartner provide guidance before committing?

Yes. We provide a free consultation and assessment. We'll review your data structure, discuss your requirements, and provide a detailed migration plan and fixed-price quote before you commit to anything.

Still have questions?

Book a free 30-minute consultation with our migration engineers. We'll walk you through the exact approach for your Unthread→Puzzel Case Management migration.

Contact our team

Ready to start your
Puzzel Case Management Migration?

Join hundreds of businesses who have successfully migrated with ClonePartner. Let's discuss your migration needs and build a plan that works for you.

Book free consultation

Attention to Detail

We meticulously handle every aspect of your migration, ensuring no data is lost during transfer and mapping every field correctly between platforms.

Custom Solutions

Every business is unique. We tailor your migration strategy to match your specific requirements, workflows, and data structures.

Security & Compliance

Your customer data is handled with enterprise-grade security protocols, ensuring compliance with GDPR, HIPAA, and industry standards.

Migrate from Unthread to Puzzel Case Management with precision & ease

Why teams migrate from Unthread to Puzzel Case Management