Puzzel Case Management to Tidio Migration

MIGRATION OVERVIEW

Why teams migrate from Puzzel Case Management to Tidio

The core problem

Migrating from Puzzel Case Management to Tidio is a fully custom migration with no vendor-supported connector or native migration path. Puzzel is built around structured ticket queues with skill-based routing, category hierarchies, and organisation-level grouping, while Tidio organises data around contacts with attached conversations, a ticketing layer, contact properties, and departments — creating fundamental data model incompatibilities that require deliberate field-level mapping. Puzzel's CSV export captures only ticket metadata and omits full message threads, internal notes, and attachments, making REST API extraction mandatory for a complete migration. On the load side, Tidio's live ticket-creation API does not support createdAt timestamp overrides, so historical tickets must be loaded via JSONL file import (Plus plan and above), followed by a post-load enrichment pass via the Tidio OpenAPI to apply tags and custom fields that the JSONL schema does not natively support.

Why this matters for your migration

KEY CHALLENGES

What makes this migration complex

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

Most Critical

No Native Migration Path

Tidio publicly documents migration connectors for Zendesk, Intercom, Gorgias, and LiveChat, but provides no vendor-authored connector or documented path for Puzzel Case Management, requiring a fully custom extraction, transformation, and load pipeline.

Blocks all downstream imports if mapped wrong

Incomplete CSV Export Coverage

Puzzel's CSV export captures ticket-level metadata such as reference numbers, statuses, and timestamps, but strips full message threads, agent replies, internal notes, and file attachments, making API extraction mandatory for any migration preserving conversation history.

Historical Timestamp Preservation

Tidio's live POST /tickets/as-contact endpoint does not expose a createdAt parameter, stamping all created tickets with the current server time, so historical tickets must be loaded exclusively via the JSONL file import path available on the Plus plan and above.

Post-Load Tag and Custom Field Enrichment

Tidio's JSONL import schema does not include tag or custom-field payloads, meaning any Puzzel categories or form field values mapped to Tidio tags or ticket custom fields require a separate post-load enrichment pass using PATCH /tickets/{ticketId} via the Tidio OpenAPI.

Structural Data Model Divergence

Key Puzzel constructs — including Teams, Categories, Form Fields, and Organisations — have no direct Tidio equivalents and must be remapped to Tidio departments, tags, contact properties, and ticket custom fields, each requiring pre-creation in Tidio before any data can be loaded.

Attachment Staging Complexity

Tidio's JSONL import requires attachment references to be publicly accessible URLs, meaning all binary files extracted from Puzzel must be downloaded locally, re-keyed by ticket reference, and staged on a publicly accessible cloud storage bucket before the import can proceed.

MIGRATION RISK ASSESSMENT

Every migration risk, already solved

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

High complexity

Attachments

Attachments require a multi-step process of binary extraction from Puzzel, local storage with ticket-keyed filenames, public cloud staging, and URL reference in JSONL — any broken or non-public URL in the import payload will cause attachment loss for that ticket.

Solved
Organisations

Tidio has no native organisation entity, so Puzzel organisation associations must be flattened into contact or ticket custom properties, resulting in a structural loss of organisation-level grouping and relational hierarchy that cannot be fully reconstructed.

Solved
Tags and Categories

Puzzel categories do not map directly to Tidio tags or custom fields, and because the JSONL import schema excludes tag payloads entirely, all category-to-tag mappings must be applied via a post-load PATCH /tickets/{ticketId} enrichment pass, creating a two-phase dependency that increases failure surface.

Solved
Custom Fields

Puzzel form fields must be pre-mapped and pre-created as Tidio ticket custom fields or contact properties before loading, and because the JSONL import schema does not carry custom field values, all field data requires a separate post-load API enrichment pass that must be correctly sequenced after ticket creation.

Solved
SLAs and Automated Workflows

Neither Puzzel SLA policies nor automated routing workflows are migratable via API or file import into Tidio — both must be manually rebuilt from scratch inside Tidio's SLA management settings and no-code Flows builder, representing a complete configuration loss with no automated path.

Solved

Custom engineering

Tickets

Ticket metadata migrates reliably via JSONL import with preserved createdAt timestamps, but the process requires a Plus plan subscription, correctly structured JSONL files, and valid UTF-8 encoding — invalid sequences cause full file rejection at Tidio's validation stage.

Handled
Ticket Messages

Full conversation threads are supported within the JSONL ticket payload and sequenced by timestamp, but they cannot be extracted from Puzzel via CSV and require successful API access through a configured API Ticket Channel with global access permissions.

Handled
Internal Notes

Internal notes are supported in the JSONL import via type: internal message entries, but private notes in Puzzel are only accessible via API if the API channel has global access, and notes without this flag will be silently omitted from the extract.

Handled
Contacts

Contacts can be imported via POST /contacts/batch or created implicitly through the JSONL ticket import, but Tidio's contact API has no native upsert operation, meaning duplicate contacts can be created if the same email appears across multiple import passes.

Handled

Clean transfer

Agents and Operators

Agent and team data is used to inform Tidio operator and department configuration, but Tidio provides no bulk operator import API, so operators must be manually created in the Tidio admin panel before the JSONL import runs to allow correct operatorEmail and departmentName resolution.

Clean

What Our Customers Say

Real migration stories

Direct Review

“One of the easiest migrations I've ever been through. The team took care of everything — all our data, customer interactions and macros. The process was clear, straightforward and we felt supported all the way. An absolutely seamless experience for our support team and our customers.”

Direct Review

“Fantastic at both guiding us through the process and helping us fix things as they come up and dial them in.”

Reviewed on G2

“The ease of the process and that ClonePartner was informing me what was going on at every step. If you're on the fence, do it. ClonePartner are great!”

Direct Review

“They were SO helpful. We had a few hiccups because our migration was in the middle of the process, but they were really flexible and did multiple delta migrations for us. We were able to map a lot of our old ticket data so it's usable for comparisons in the future.”

Direct Review

“Overall a great experience. We had to go back a few times to get everything just right, which was totally expected. The transition was smooth, and there was no data loss.”

See all customer stories →

CUSTOM MIGRATION

Fully customizable engineer-led migration

Tailor your migration from Puzzel Case Management to Tidio 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 Puzzel Case Management to Tidio 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 Tidio, 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 Puzzel Case Management to Tidio 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 Puzzel Case Management and Tidio 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 Puzzel Case Management data and Tidio
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 30 days of engineer-assigned support post go-live.

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

No two teams configure Puzzel Case Management or Tidio 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 Puzzel Case Management to Tidio. Can't find what you're looking for? Talk to our team.

Can I use Puzzel's CSV export for a full Tidio migration?

No. Puzzel's CSV export captures ticket metadata (reference, status, team, categories) but strips full message threads, agent replies, internal notes, and attachments. For a complete migration with preserved conversation history, you must extract via the Puzzel REST API.

What Tidio plan do I need for an API-based migration?

You need at least the Plus plan for full OpenAPI access and the JSONL ticket import feature. Rate limits range from 10 requests/minute on entry plans to 120 requests/minute on Premium. For datasets over 10,000 tickets, Premium is strongly recommended to avoid multi-day enrichment times.

Does Tidio deduplicate contacts on import?

No. Tidio's POST /contacts endpoint always creates new contacts and does not support upsert. Running the import twice creates duplicates. You must de-duplicate source data before loading and maintain a Puzzel-to-Tidio ID mapping table to track created contacts.

How long does a Puzzel Case Management to Tidio migration take?

A mid-size migration (10,000–50,000 tickets) typically takes 2–4 weeks: 3–4 days planning, 3–5 days extraction, 3–5 days transformation and testing, 2–3 days production loading, and 2–3 days validation and cutover. Smaller datasets can compress to 1–2 weeks.

Can I migrate SLAs and automated workflows from Puzzel to Tidio?

No. SLA policies, inbound rules, event-based workflows, and virtual agent configurations cannot be migrated programmatically. These must be manually recreated in Tidio using its SLA settings and Flows builder.

How long does the Puzzel Case Management to Tidio 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 Puzzel Case Management 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 Puzzel Case Management to Tidio?

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 Puzzel Case Management→Tidio migration.

Contact our team

Ready to start your
Tidio 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 Puzzel Case Management to Tidio with precision & ease

Why teams migrate from Puzzel Case Management to Tidio