Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.
Switching to DMLY is two jobs that run on different clocks.Your WhatsApp number is Meta’s business, not DMLY’s. A number lives on one WhatsApp Business
Account and can be connected to one Cloud API provider at a time, so moving it means moving it at
Meta and connecting it here. That part has waiting in it.Your data is DMLY’s business. Contacts, tags, custom fields, services and products all have
CSV importers. Everything else (chat history, opt-outs, past invoices, the automations you built
in your old tool) has no importer, and pretending otherwise is how people lose things. This page
says plainly which is which.
If you have never had WhatsApp Business before, you are not migrating anything; you are just
setting up. Go to Connect WhatsApp and
Set up your workspace instead.
Prefer to watch first? This walkthrough covers moving your number and contacts, and planning the cutover.
What moves, and what you rebuild
What
Comes with you?
How
Your WhatsApp number
Yes
Meta’s embedded signup, see below
Approved message templates
Only if your WhatsApp Business Account comes with you
Co-existence imports up to 180 days of one-to-one chats from the Business app. From any other source, nothing imports it: export it from your old tool and keep the file
The honest summary: people and things you sell move; conversations and behaviour do not.
Move your WhatsApp number
Coming from another provider
Wati, AiSensy, Interakt, 360dialog, Twilio, Respond.io and the rest are all WhatsApp providers;
Meta calls them Solution Providers or Tech Providers. Your number is registered for Cloud API
through one of them today, and only one provider can hold it at a time. Moving it is a Meta
action; DMLY picks it up at the end.Two things decide how much work is left over:
Who owns the WhatsApp Business Account. If the account is yours, in your own Business
Manager, it comes across with everything on it, including your approved templates. If your old
provider owns it and the number ends up on a different account, the templates stay behind and
you re-submit them. Check this before you do anything else; it is the difference between a
same-day switch and a week of template reviews.
Two-step verification. It has to be off on the number before you start. DMLY says so on the
connect screen.
Turn off two-step verification for the number before you start. DMLY’s connect page puts it
this way: “Please disable your 2FA from your WhatsApp Business Manager if you choose to proceed
with migrating from another Solutions Provider or Tech Provider.” A migration attempted with
2FA still on fails.
1
Get your house in order at Meta
In your own WhatsApp Business Manager, confirm you have admin access to the business that
holds the number, and turn off two-step verification for it.If your old provider owns the WhatsApp Business Account rather than you, this is the point to
ask them to release the number; that request goes to them, not to DMLY.
2
Note what you are about to lose sight of
Once the number moves, your old tool stops receiving on it. Export anything you still want
(chat transcripts, your opt-out list, campaign reports) while you can still log in there.
None of it can be imported into DMLY later.
3
Connect the number in DMLY
Go to Integrations → Channels, select Add account, then the WhatsApp tile, then
Connect a WhatsApp number. You are handed to Facebook to sign in, pick the WhatsApp
Business Account, add the number and verify it with the code Meta sends.Complete every screen. Stopping halfway returns you to DMLY with nothing granted.
4
Register the number
Connected is not the same as registered. Open Bot Setup → WhatsApp → Configuration, and if
the number shows Not registered, enter its 6-digit two-step verification PIN to register
it for Cloud API messaging.
5
Check what came with it
The Configuration tab reads your number’s quality rating and messaging limit tier straight
from Meta every time you open it; they are Meta’s record of the number, not DMLY’s, so check
them here rather than assuming a fresh start. Then open Templates and select Refresh
templates to see which of your templates exist on the account DMLY is now connected to.
Full detail on each of these steps, including what the error messages mean:
Connect WhatsApp.
Coming from the WhatsApp Business phone app
This is the case where you may not have to give anything up. By default, connecting a number to
the Cloud API takes it over exclusively and the WhatsApp Business phone app stops working on it.
Co-existence mode is the alternative: the phone app and DMLY share the same number.On the connect screen, below the main button, there is a separate section (Already using the
WhatsApp Business app?) with its own Connect in co-existence mode button. Use that one
instead of the main button. The rest of Meta’s signup is the same.What co-existence actually gives you:
You keep chatting from the phone. The app stays working on the number.
Messages you send from the phone app appear in the DMLY inbox too, on the same contact, so
the thread stays in one place. They are recorded as sent by you, and they are never routed to
your bot; a human is clearly already handling that conversation.
A contact record is created for anyone you message from the phone, so your list fills in as
you work rather than all at once.
Automation still runs on the number. If you would rather the bot stayed quiet on any
conversation you have personally answered from the phone, turn on Pause the bot when I reply
from the phone app; it pauses the bot for that one contact, and it is off by default.
Co-existence brings your recent chats over. When the number connects, DMLY asks Meta for the
Business app’s saved contacts and chat history straight away. Meta allows 24 hours for this,
once, and DMLY retries until that deadline passes.
Up to 180 days of one-to-one chats arrive. Group chats never do.
Media from the last 14 days arrives as files. Older media shows as a placeholder.
The app’s saved contacts go into an address book and are used to name your contacts. They
never create a contact on their own.
Imported history does not start flows or automations, raise unread badges or open the
24-hour window. Contacts it creates start closed.
None of this happens if you choose not to share your history in Meta’s signup flow.
Co-existence is a choice made once, at signup. Switching a number between modes means
disconnecting and reconnecting it. See
Delete a WhatsApp number.
Both the Co-existence badge and the pause toggle live on the connect page. Go back to it the
way you came: Integrations → Channels, Add account, then the WhatsApp tile; with a
number already attached it shows your connected number, the badge and the toggle instead of a
fresh connect form.They are not on the Bot Setup → WhatsApp → Configuration tab used for registering the
number a few steps above. That tab only shows a co-existence number’s status, as Business
app + Cloud API. Both screens are headed WhatsApp Cloud API Configuration, which is
the easiest wrong turn on this page; that one covers registration, profile, commerce and
calling.
Coming from no WhatsApp at all
Moving off a CRM, a booking system or a spreadsheet with no WhatsApp Business number in the
picture? Then there is nothing to migrate on the channel side.
Connect a fresh number and read
the 24-hour window before you import
anyone, because it changes what you can say to an imported list on day one.
Bring your contacts
The contacts CSV importer is the main road out of another CRM or a spreadsheet. Read
Import contacts from CSV for the full behaviour; this is what matters when
you are migrating.Connect your WhatsApp number first. The importer attaches every contact to the channel that is
selected when you run it, and it refuses to run at all with no channel active
(“Select a channel before importing.”). Importing before your number is live means importing
onto the wrong channel.
The columns
Take Download sample on the import page and match it. The header row is what the importer
reads: order follows your header, capitalisation and stray spaces are ignored, and any column
not in this list is thrown away.
Column
What it does
name
Required. A blank name skips the row, and the importer counts it for you.
country_code
Glued onto the front of phone, with nothing in between, to make the full number.
phone
Required. A blank phone skips the row, counted the same way.
email
Saved on the contact and used for matching. Not in the sample file, but it is read.
tags
Tag names separated by | or ,. Tags that don’t exist yet are created.
A JSON object of custom fields, for example {"company":"Acme"}.
Three things bite migrators specifically:
A CSV of email-only contacts imports nobody. Every row needs a phone number. If your old
tool was email-first, expect to lose the rows that have no mobile number.
Put the country code somewhere, once. If your export already has full international numbers
in phone, leave country_code empty; otherwise you get the country code twice and the
numbers are unreachable.
Quote anything containing a comma. An unquoted comma inside a note shifts every later value
one column right and pushes the last column off the end of the row.
It won’t duplicate people, but it isn’t read-only
Before creating anything, the importer looks for an existing contact anywhere in the workspace
with the same phone or the same email. On a match it adds the identity and fills blanks
rather than making a second person. That makes a second pass safe, but not harmless:
name, email, phone and stage are only filled in where they are empty.
Tags are replaced, not added to. A file with an empty tags column strips every tag from
everyone it matches.
Custom fields are overwritten on the keys your file sets.
The notes value is added again, on every run.
Migrating in stages? Export from DMLY between passes. Export on the Contacts page writes the
same seven columns the importer reads, so you can carry your current tags forward in the next
file instead of wiping them.Blank the notes column before you re-import that file, though. The export joins all of a
contact’s notes into one cell, and the importer adds the cell back as a fresh note, so every
round trip leaves another copy of the whole history stacked on the contact.
Importing does not start your automations
A contacts CSV import deliberately starts no contact automations. New contact, Tag
applied, Tag removed and Field changed do not fire for imported rows, so you don’t need
to pause anything first. The result message ends by saying so: “Automations that watch for new
contacts were not run.”The flip side: a welcome flow will not run for anyone you import. If you want imported people to
get a message, send them a broadcast instead.Webhooks still fire. A connected tool listening for contact.created or contact.tagged hears
about every imported row. See Triggers.
One more thing that stops a migration dead
Your plan caps how many contacts a workspace can hold, and the whole file is checked before a
single row is written, so an import that would take you over the cap imports nothing at all.
The check is deliberately cautious: rows that would only have matched someone you already have
still count toward the estimate. See Plans.
Carry your opt-outs across
If someone told your old tool to stop messaging them, that instruction does not travel with a CSV.
This is the one part of a migration with legal weight, so here is the plain truth.
DMLY has no way to import opt-out or suppression state. Not through the CSV importer, and
not through the API. A contact’s opted-out state is set when they
send a stop keyword on a channel, or when a flow’s Unsubscribe Contact step runs on them.
There is no field, column or endpoint that sets it in bulk. Everyone you import arrives
messageable, unless they had already opted out of this DMLY workspace before.
So decide deliberately, before you build the file:
1
Export your suppression list from the old tool first
Do this while you still have access. Once the number moves, that tool has nothing to show you.
2
Leave opted-out people out of the CSV
This is the safest option by a distance, and usually the right one. A person who is not in the
workspace cannot be broadcast to by accident, cannot be swept into a segment, and cannot be
messaged by a teammate who did not know. If you have no business reason to hold their record,
do not import it.
3
If you must keep them, tag them and exclude the tag everywhere
Give them a tag of your own in the tags column (Do not contact does the job) and add it
to Exclude contacts with tags on every segment and
broadcast audience you build.Use your own tag rather than the built-in Unsubscribe one. DMLY manages that tag itself:
it attaches it when someone opts out and removes it when they opt back in, so a marker you
applied by hand can vanish without you touching it.Understand what this is and isn’t: the tag is a filter you are applying by hand, not the
opt-out flag. Importing the Unsubscribe tag does not opt anyone out. Sequences,
automations and any audience where you forgot the exclusion will still send to them.
4
For the ones that really must never be messaged, block them
Your own tag stops nothing by itself: a teammate can still reply by hand. Once a contact is
really opted out in DMLY (after they send a stop keyword, or a flow’s Unsubscribe Contact
step runs on them), manual replies are refused too, until they are resubscribed. For an
imported contact who never opted out inside DMLY, blocking is the switch that disables the
inbox composer. It is set per conversation, so it is one at a time, which is exactly why option
two above is better for a long list.
Read Data, privacy and consent before you send anything to an
imported list. And remember the other half: importing a list is not consent. WhatsApp holds
you to what the contact agreed to, not to what your spreadsheet says.
Bring your catalogue
If you sell services or products, both have their own CSV importer and both only ever add.Services: columns name, type, category, duration_min, price, currency,
capacity, description, active. name is the only required one; type is appointment,
class or add_on and anything else imports as appointment. A row whose name matches an
existing service is skipped rather than overwritten, so a re-run never damages what you have.
An imported service is not bookable yet. The CSV has no columns for staff or working hours,
so every imported service arrives with an empty schedule and nobody assigned, while still
showing on your public booking page, offering zero times. Assign staff who have their own
Working hours, or set the service’s own weekly availability, before you point anyone at your
booking page. Full detail: Services.
Products: columns name, sku, price, cost_price, currency, tax_rate,
tax_inclusive, track_stock, stock_quantity, low_stock_threshold, category, active,
description. Every row with a name becomes a new product; nothing is matched against what
you already have, so uploading the same file twice gives you two of every product. Import once,
check, and make later changes in the app. Full detail: Products.
Tags and custom field definitions have CSV importers of their own: tags on
Contacts → Manage tags, where Import CSV and Download sample sit above the tag
list, and custom fields on Settings → Custom fields.Neither is a prerequisite for importing contacts: the contacts importer creates any tag it
doesn’t already have, and it writes whatever your custom_fields column contains without
checking it against your definitions. Import them anyway if you want your tag colours and a
tidy field list from the start. And note that a custom_fields column never registers its
keys on Custom fields, so importing three thousand contacts
carrying membership_no puts the value on every one of them while leaving your definitions
list empty.
Rebuild what can’t move
Message templates
Templates belong to your WhatsApp Business Account at Meta, not to DMLY and not to your old
provider’s software. That single fact decides your timeline:
The account comes with you → your approved templates come with it. Open Templates,
select Refresh templates, and they appear in DMLY with their current status pulled from
Meta. Nothing to re-submit.
The number lands on a different account → the templates do not follow. Every one you rely on
has to be recreated and submitted to Meta for review again.
On top of your own templates, DMLY submits its own built-in dmly_ templates for review the
moment a live number connects. Those cover appointment confirmations and reminders, invoices,
receipts, review requests and more. Until Meta approves them, the notifications that depend
on them are not sent at all to anyone whose 24-hour window is shut.
Meta reviews templates on Meta’s schedule. Plan around it: nothing you send to a cold contact
(no broadcast, no reminder, no receipt) works until the template it uses is Approved. This
is the longest lead time in the whole move, which is why the cutover plan below starts with it.
There is no importer for flows, and no format DMLY reads from another tool. Rebuild them in the
flow builder, and treat it as a chance to drop the branches nobody
used. Start from a ready-made template rather than a blank canvas where one fits.
Conversation history
Nothing imports past messages, from any source, with one exception: a number connected in
co-existence brings up to 180 days of Business app chats with it (see above). Otherwise the inbox
starts on the day you connect.
Do not try to backfill history through the API.POST /messages is a send; it routes
through the same path as the inbox composer and really delivers the message to the customer.
Replaying last year’s conversations through it would message your entire list.
Export transcripts from your old tool and keep the file somewhere you can search it. That is the
whole answer today.
Invoices, orders and past money
There is no CSV import for finance records. What exists is the
REST API, which can create invoices, orders and contacts
programmatically, so a large or complicated move can be scripted rather than typed.Two things to know if you go that way:
POST /invoices creates a draft. Nothing reaches the customer until you make the separate
POST /invoices/{invoice}/send call, so a backfill never emails or messages anyone an invoice
from years ago.
POST /appointments is different: booking through it sends the customer a confirmation and
seeds their reminders, exactly as a real booking does. Do not use it to replay a back catalogue
of past appointments.
A finance backfill starts automations, unlike a contacts import. Creating an
invoice fires Invoice created; creating an order fires Order created; and either one,
against a contact who isn’t a client yet, also fires Contact converted to client and
Lifecycle stage changed. A script that loads a year of invoices starts one run per record.
Set those four to Paused before you run it, and switch them back on afterwards.
For most businesses the pragmatic answer is: keep the old system read-only for a few months for
lookups, and start DMLY clean from the switchover date.
A cutover plan that keeps you trading
The order matters because template review is the only step that waits on someone else.
1
Two weeks out: set up DMLY alongside your old tool
Create the workspace, fill in your business details, invite your
team. Import your tags and custom fields. Nothing here touches your live number, so there is
no risk in doing it early.
2
Then: export everything from the old tool
Contacts, suppression list, chat transcripts, campaign reports, invoice records. You will not
get another chance once the number moves. Keep the files.
3
Then: import your catalogue and set availability
Services and products, then staff, working hours and booking rules. Check your booking page
offers real times before anyone sees it.
4
Turn off two-step verification on the number
At Meta, in your WhatsApp Business Manager. Do this before you attempt the connect, not
during it.
5
Move the number and connect it
Off-peak, on a quiet day. There is a gap between your old tool losing the number and DMLY
registering it, and messages sent to you during it can be missed, so pick the quietest hour
you have, not the busiest.
6
Immediately: get templates moving
Select Refresh templates. Whatever isn’t there, create and submit now, while you still have
other things to do. Everything downstream waits on this.
7
Send yourself a test message
From your own phone, to the number. If it appears in the Inbox, the channel
is genuinely live. If it doesn’t, stop and fix that before anything else:
No inbound messages.
8
Import contacts
Import the file with your WhatsApp channel selected. The import does not start automations,
so there is nothing to pause. Check the count that comes back against your row count.
9
Rebuild your automations, then broadcast
Build the flows you actually use, test each one on yourself, and only then send your first
broadcast, once its template is Approved and your audience excludes everyone who opted
out at the old tool.
When something goes wrong
The migration failed and the error mentions verification or 2FA
Two-step verification is still on for the number at Meta. Turn it off in your WhatsApp Business
Manager and run the connect again. DMLY warns about this on the connect screen before you
start, which is why it is the first thing to check.
Signup finished but DMLY says no WhatsApp Business Account was granted
The Facebook flow was not completed all the way through: closing the window early, or skipping
a permission screen, returns you with nothing granted. Retry the signup and complete every
screen. If it says the account has no phone number yet, finish verifying the number at Meta
first, then retry.
The number connected but nothing arrives in the Inbox
Check two things on Bot Setup → WhatsApp → Configuration: the number must show
Registered, and the WhatsApp Business Account must be subscribed. A number that is verified
but not registered cannot send or receive anything, even though DMLY shows it as connected.
A co-existence number is the exception: it shows Business app + Cloud API instead, and it
must never be registered, because registering it would cut it off from the phone app.
Full walkthrough: No inbound messages.
Your templates aren't in DMLY after the move
Select Refresh templates first, to sync now rather than waiting for the next automatic pass.
If they are still missing, the number is on a different WhatsApp Business Account from the one
that held them. Templates belong to the account, so they cannot be pulled across from elsewhere;
recreate and re-submit them. See Message templates.
Broadcasts have nothing to send
The broadcast picker lists Approved templates only. Draft, Pending and Rejected templates do
not appear at all. If everything is Pending, you are waiting on Meta; there is no way to
accelerate it from DMLY.
Fewer contacts imported than rows in your file
Almost always a blank name or a blank phone number. You don’t have to guess how many: the
message you land back on says “N contacts imported. M row(s) skipped — missing a name or a
phone number. Automations that watch for new contacts were not run.” Read that count first. If it matches your own tally of empty cells, nothing
else is wrong and you can fix those rows and re-run.If nothing imported, DMLY says so on the upload screen rather than reporting a green zero,
and that almost always means the header row doesn’t contain name, country_code and phone
spelled the way the importer expects. Take the sample file and copy its header exactly.
The whole import was blocked
Your plan’s contact cap. The file is checked in full before anything is written, so an import
that would take you over the cap writes nothing; there is no half-finished state to clean up.
See Plans and Choosing a plan.
Contacts arrived but you can't message them
Expected, and not an import problem. An imported contact has never messaged you, so they have no
open 24-hour window; they can only be reached with an approved template until they reply. See
WhatsApp rules and limits.
Your old tool still shows the number as connected
That is between you and them. DMLY cannot release, delete or change a number on another
provider’s account, and disconnecting in DMLY does not touch anything at Meta. See
Delete a WhatsApp number. Close the account down in the old
tool once you are satisfied DMLY is receiving.
Next
Set up your workspace
The full setup order, from business details to your first automation.
Connect WhatsApp
Connecting, registering and the rules that shape everything afterwards.
Import contacts from CSV
The full importer behaviour, column by column.
Data, privacy and consent
Opt-out, blocking and what each one actually stops.
Message templates
Build a template Meta will approve, and track its status.
API reference
Script a bulk or complicated move against the REST API.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DMLY","description":"DMLY is the WhatsApp-first customer engagement platform - unified inbox, chatbots, broadcasts, CRM, appointments and payments.","colors":{"primary":"#12715B","light":"#5EA28F","dark":"#0E5747"},"logo":{"light":"https://mintcdn.com/dmly/DoG8FVD9UVpfrD19/logo/light.png?fit=max\u0026auto=format\u0026n=DoG8FVD9UVpfrD19\u0026q=85\u0026s=7eda62740d42f25df6e609cfb033fd65","dark":"https://mintcdn.com/dmly/DoG8FVD9UVpfrD19/logo/dark.png?fit=max\u0026auto=format\u0026n=DoG8FVD9UVpfrD19\u0026q=85\u0026s=53cb5065825f4fecb021bf682d14482a","href":"https://dmly.io"},"favicon":"https://mintcdn.com/dmly/DoG8FVD9UVpfrD19/favicon.png?fit=max\u0026auto=format\u0026n=DoG8FVD9UVpfrD19\u0026q=85\u0026s=78e31d3f34df373daa56a61f9901ce65","appearance":{"default":"system"},"navbar":{"links":[{"href":"https://dmly.io/pricing","label":"Pricing"},{"href":"https://status.dmly.io","label":"Status"}],"primary":{"type":"button","label":"Open Dashboard","href":"https://dash.dmly.io"}},"footer":{"socials":{"website":"https://dmly.io"},"links":[{"header":"Product","items":[{"label":"DMLY","href":"https://dmly.io"},{"label":"Pricing","href":"https://dmly.io/pricing"},{"label":"Dashboard","href":"https://dash.dmly.io"}]},{"header":"Resources","items":[{"label":"API reference","href":"/api-reference/introduction"},{"label":"Status","href":"https://status.dmly.io"}]}]},"seo":{"metatags":{"og:site_name":"DMLY Docs"},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":400},"body":{"family":"Inter"}},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","claude","chatgpt","mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dmly","hasAudioNarration":false,"actualSubdomain":"dmly","customDomains":["docs.dmly.io"],"gitSource":{"type":"github","owner":"dmly-io","repo":"dmly-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd4246469364630c16e5f9","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":216},{"language":"default","tag":"Endpoints","count":167},{"language":"default","tag":"Guides","count":154},{"language":"default","tag":"Webhook events","count":95},{"language":"default","tag":"Messaging","count":65},{"language":"default","tag":"Agency API","count":57},{"language":"default","tag":"Workspace","count":45},{"language":"default","tag":"Business","count":30},{"language":"default","tag":"Appointments","count":25},{"language":"default","tag":"Automation \u0026 chatbots","count":22}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".update .prose-sm{font-size:1rem;line-height:1.75rem}.update .prose-sm>h2{font-size:1.625rem;line-height:1.25}.update .prose-sm>h3{font-size:1.25rem;line-height:1.75rem}.update .prose-sm code{font-size:0.875rem}#header h1,.mdx-content h2:not(.not-prose),.mdx-content h3:not(.not-prose),.mdx-content h4:not(.not-prose){font-weight:400}"}]}
{"page":{"pagePath":"getting-started/migrating-to-dmly","slug":"/getting-started/migrating-to-dmly","pageMetadata":{"title":"Migrate to DMLY","description":"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.","icon":"arrow-right-arrow-left","href":"/getting-started/migrating-to-dmly"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,Columns,Heading,Note,OptimizedFrame,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedFrame)_missingMdxReference(`OptimizedFrame`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Switching to DMLY is two jobs that run on different clocks.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Your WhatsApp number`}),` is Meta’s business, not DMLY’s. A number lives on one WhatsApp Business\nAccount and can be connected to one Cloud API provider at a time, so moving it means moving it at\nMeta and connecting it here. That part has waiting in it.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Your data`}),` is DMLY’s business. Contacts, tags, custom fields, services and products all have\nCSV importers. Everything else (chat history, opt-outs, past invoices, the automations you built\nin your old tool) has no importer, and pretending otherwise is how people lose things. This page\nsays plainly which is which.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`If you have never had WhatsApp Business before, you are not migrating anything; you are just\nsetting up. Go to `,_jsx(_components.a,{href:`/channels/whatsapp`,children:`Connect WhatsApp`}),` and\n`,_jsx(_components.a,{href:`/getting-started/setup-checklist`,children:`Set up your workspace`}),` instead.`]})}),`\n`,_jsx(_components.p,{children:`Prefer to watch first? This walkthrough covers moving your number and contacts, and planning the cutover.`}),`\n`,_jsx(OptimizedFrame,{className:`mint-w-full mint-aspect-video mint-rounded-xl`,src:`https://www.youtube.com/embed/j2UxmUkjejY`,title:`Migrate to DMLY`,frameBorder:`0`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share`,allowFullScreen:true}),`\n`,_jsx(Heading,{level:`2`,id:`what-moves-and-what-you-rebuild`,children:`What moves, and what you rebuild`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`What`}),_jsx(_components.th,{children:`Comes with you?`}),_jsx(_components.th,{children:`How`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your WhatsApp number`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Meta’s embedded signup, see below`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Approved message templates`})}),_jsx(_components.td,{children:`Only if your WhatsApp Business Account comes with you`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Refresh templates`}),` pulls them in from Meta`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your quality rating and messaging tier`})}),_jsx(_components.td,{children:`Held by Meta against the number`}),_jsxs(_components.td,{children:[`Read live on `,_jsx(_components.strong,{children:`Bot Setup → WhatsApp → Configuration`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contacts`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/contacts/import-csv`,children:`CSV import`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tags`})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`CSV import on `,_jsx(_components.strong,{children:`Contacts → Manage tags`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Custom field definitions`})}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`CSV import on `,_jsx(_components.strong,{children:`Settings → Custom fields`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Services`})}),_jsx(_components.td,{children:`Yes, as new services only`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/appointments/services`,children:`CSV import`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Products`})}),_jsx(_components.td,{children:`Yes, as new products only`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/offerings/products`,children:`CSV import`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Past chat and message history`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Only for co-existence numbers`})}),_jsx(_components.td,{children:`Co-existence imports up to 180 days of one-to-one chats from the Business app. From any other source, nothing imports it: export it from your old tool and keep the file`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Opt-outs and suppression lists`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`No`})}),_jsxs(_components.td,{children:[`No importer. See `,_jsx(_components.a,{href:`#carry-your-opt-outs-across`,children:`Carry your opt-outs across`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Past invoices, orders and payments`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`No importer`})}),_jsxs(_components.td,{children:[`The `,_jsx(_components.a,{href:`/api-reference/introduction`,children:`API`}),` can create invoices and orders programmatically`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Automations, chatbots and flows`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`No`})}),_jsxs(_components.td,{children:[`Rebuild them in the `,_jsx(_components.a,{href:`/automation/flow-builder`,children:`flow builder`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Broadcast history and campaign stats`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`No`})}),_jsx(_components.td,{children:`Export the numbers from your old tool before you leave`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Staff, working hours and booking rules`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`No`})}),_jsxs(_components.td,{children:[`Set up by hand, see `,_jsx(_components.a,{href:`/appointments/staff-and-availability`,children:`Staff and availability`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The honest summary: `,_jsx(_components.strong,{children:`people and things you sell move; conversations and behaviour do not.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`move-your-whatsapp-number`,children:`Move your WhatsApp number`}),`\n`,_jsx(Heading,{level:`3`,id:`coming-from-another-provider`,children:`Coming from another provider`}),`\n`,_jsxs(_components.p,{children:[`Wati, AiSensy, Interakt, 360dialog, Twilio, Respond.io and the rest are all WhatsApp `,_jsx(_components.em,{children:`providers`}),`;\nMeta calls them Solution Providers or Tech Providers. Your number is registered for Cloud API\nthrough one of them today, and only one provider can hold it at a time. Moving it is a Meta\naction; DMLY picks it up at the end.`]}),`\n`,_jsx(_components.p,{children:`Two things decide how much work is left over:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Who owns the WhatsApp Business Account.`}),` If the account is yours, in your own Business\nManager, it comes across with everything on it, including your approved templates. If your old\nprovider owns it and the number ends up on a different account, the templates stay behind and\nyou re-submit them. Check this before you do anything else; it is the difference between a\nsame-day switch and a week of template reviews.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Two-step verification.`}),` It has to be off on the number before you start. DMLY says so on the\nconnect screen.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Turn off two-step verification for the number before you start.`}),` DMLY’s connect page puts it\nthis way: `,_jsx(_components.em,{children:`“Please disable your 2FA from your WhatsApp Business Manager if you choose to proceed\nwith migrating from another Solutions Provider or Tech Provider.”`}),` A migration attempted with\n2FA still on fails.`]})}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Get your house in order at Meta`,children:[_jsx(_components.p,{children:`In your own WhatsApp Business Manager, confirm you have admin access to the business that\nholds the number, and turn off two-step verification for it.`}),_jsx(_components.p,{children:`If your old provider owns the WhatsApp Business Account rather than you, this is the point to\nask them to release the number; that request goes to them, not to DMLY.`})]}),_jsx(Step,{title:`Note what you are about to lose sight of`,children:_jsx(_components.p,{children:`Once the number moves, your old tool stops receiving on it. Export anything you still want\n(chat transcripts, your opt-out list, campaign reports) while you can still log in there.\nNone of it can be imported into DMLY later.`})}),_jsxs(Step,{title:`Connect the number in DMLY`,children:[_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Integrations → Channels`}),`, select `,_jsx(_components.strong,{children:`Add account`}),`, then the `,_jsx(_components.strong,{children:`WhatsApp`}),` tile, then\n`,_jsx(_components.strong,{children:`Connect a WhatsApp number`}),`. You are handed to Facebook to sign in, pick the WhatsApp\nBusiness Account, add the number and verify it with the code Meta sends.`]}),_jsx(_components.p,{children:`Complete every screen. Stopping halfway returns you to DMLY with nothing granted.`}),_jsx(OptimizedImage,{src:`https://mintcdn.com/dmly/2zBSWRjYOHvRhf40/images/channels/whatsapp-embedded-signup.webp?fit=max\u0026auto=format\u0026n=2zBSWRjYOHvRhf40\u0026q=85\u0026s=9b983f46ffb05d2840877c7c33ae5335`,alt:`The Connect WhatsApp Business Account panel with the Connect a WhatsApp number button highlighted, above the co-existence option`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`534`,height:`534`,\"data-path\":`images/channels/whatsapp-embedded-signup.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dmly/2zBSWRjYOHvRhf40/images/channels/whatsapp-embedded-signup.webp?w=280\u0026fit=max\u0026auto=format\u0026n=2zBSWRjYOHvRhf40\u0026q=85\u0026s=6379ca9b4730d4eb1782172913f21271 280w, https://mintcdn.com/dmly/2zBSWRjYOHvRhf40/images/channels/whatsapp-embedded-signup.webp?w=560\u0026fit=max\u0026auto=format\u0026n=2zBSWRjYOHvRhf40\u0026q=85\u0026s=e04c95b447bd02edcc9b5912f10b978a 560w, https://mintcdn.com/dmly/2zBSWRjYOHvRhf40/images/channels/whatsapp-embedded-signup.webp?w=840\u0026fit=max\u0026auto=format\u0026n=2zBSWRjYOHvRhf40\u0026q=85\u0026s=08d2cc0966449b8d6ac61ed115be863a 840w, https://mintcdn.com/dmly/2zBSWRjYOHvRhf40/images/channels/whatsapp-embedded-signup.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=2zBSWRjYOHvRhf40\u0026q=85\u0026s=15b526294de2786dc868206cef96a21f 1100w, https://mintcdn.com/dmly/2zBSWRjYOHvRhf40/images/channels/whatsapp-embedded-signup.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=2zBSWRjYOHvRhf40\u0026q=85\u0026s=142a20c555c5d8e54ead1f3f1ce32a07 1650w, https://mintcdn.com/dmly/2zBSWRjYOHvRhf40/images/channels/whatsapp-embedded-signup.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=2zBSWRjYOHvRhf40\u0026q=85\u0026s=2453dcc1702f3ee12212a5e944ab7b2f 2500w`})]}),_jsx(Step,{title:`Register the number`,children:_jsxs(_components.p,{children:[`Connected is not the same as registered. Open `,_jsx(_components.strong,{children:`Bot Setup → WhatsApp → Configuration`}),`, and if\nthe number shows `,_jsx(_components.strong,{children:`Not registered`}),`, enter its 6-digit two-step verification PIN to register\nit for Cloud API messaging.`]})}),_jsx(Step,{title:`Check what came with it`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Configuration`}),` tab reads your number’s quality rating and messaging limit tier straight\nfrom Meta every time you open it; they are Meta’s record of the number, not DMLY’s, so check\nthem here rather than assuming a fresh start. Then open `,_jsx(_components.strong,{children:`Templates`}),` and select `,_jsx(_components.strong,{children:`Refresh\ntemplates`}),` to see which of your templates exist on the account DMLY is now connected to.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Full detail on each of these steps, including what the error messages mean:\n`,_jsx(_components.a,{href:`/channels/whatsapp`,children:`Connect WhatsApp`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`coming-from-the-whatsapp-business-phone-app`,children:`Coming from the WhatsApp Business phone app`}),`\n`,_jsxs(_components.p,{children:[`This is the case where you may not have to give anything up. By default, connecting a number to\nthe Cloud API takes it over exclusively and the WhatsApp Business phone app stops working on it.\n`,_jsx(_components.strong,{children:`Co-existence mode`}),` is the alternative: the phone app and DMLY share the same number.`]}),`\n`,_jsxs(_components.p,{children:[`On the connect screen, below the main button, there is a separate section (`,_jsx(_components.strong,{children:`Already using the\nWhatsApp Business app?`}),`) with its own `,_jsx(_components.strong,{children:`Connect in co-existence mode`}),` button. Use that one\ninstead of the main button. The rest of Meta’s signup is the same.`]}),`\n`,_jsx(_components.p,{children:`What co-existence actually gives you:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`You keep chatting from the phone.`}),` The app stays working on the number.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Messages you send from the phone app appear in the DMLY inbox too`}),`, on the same contact, so\nthe thread stays in one place. They are recorded as sent by you, and they are never routed to\nyour bot; a human is clearly already handling that conversation.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A contact record is created for anyone you message from the phone`}),`, so your list fills in as\nyou work rather than all at once.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Automation still runs on the number.`}),` If you would rather the bot stayed quiet on any\nconversation you have personally answered from the phone, turn on `,_jsx(_components.strong,{children:`Pause the bot when I reply\nfrom the phone app`}),`; it pauses the bot for that one contact, and it is off by default.`]}),`\n`]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Co-existence brings your recent chats over.`}),` When the number connects, DMLY asks Meta for the\nBusiness app’s saved contacts and chat history straight away. Meta allows 24 hours for this,\nonce, and DMLY retries until that deadline passes.`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Up to 180 days of one-to-one chats arrive. Group chats never do.`}),`\n`,_jsx(_components.li,{children:`Media from the last 14 days arrives as files. Older media shows as a placeholder.`}),`\n`,_jsx(_components.li,{children:`The app’s saved contacts go into an address book and are used to name your contacts. They\nnever create a contact on their own.`}),`\n`,_jsx(_components.li,{children:`Imported history does not start flows or automations, raise unread badges or open the\n24-hour window. Contacts it creates start closed.`}),`\n`]}),_jsx(_components.p,{children:`None of this happens if you choose not to share your history in Meta’s signup flow.`})]}),`\n`,_jsxs(_components.p,{children:[`Co-existence is a choice made once, at signup. Switching a number between modes means\ndisconnecting and reconnecting it. See\n`,_jsx(_components.a,{href:`/channels/delete-whatsapp-number`,children:`Delete a WhatsApp number`}),`.`]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Both the `,_jsx(_components.strong,{children:`Co-existence`}),` badge and the pause toggle live on the connect page. Go back to it the\nway you came: `,_jsx(_components.strong,{children:`Integrations → Channels`}),`, `,_jsx(_components.strong,{children:`Add account`}),`, then the `,_jsx(_components.strong,{children:`WhatsApp`}),` tile; with a\nnumber already attached it shows your connected number, the badge and the toggle instead of a\nfresh connect form.`]}),_jsxs(_components.p,{children:[`They are `,_jsx(_components.strong,{children:`not`}),` on the `,_jsx(_components.strong,{children:`Bot Setup → WhatsApp → Configuration`}),` tab used for registering the\nnumber a few steps above. That tab only shows a co-existence number’s status, as `,_jsx(_components.strong,{children:`Business\napp + Cloud API`}),`. Both screens are headed `,_jsx(_components.strong,{children:`WhatsApp Cloud API Configuration`}),`, which is\nthe easiest wrong turn on this page; that one covers registration, profile, commerce and\ncalling.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`coming-from-no-whatsapp-at-all`,children:`Coming from no WhatsApp at all`}),`\n`,_jsxs(_components.p,{children:[`Moving off a CRM, a booking system or a spreadsheet with no WhatsApp Business number in the\npicture? Then there is nothing to migrate on the channel side.\n`,_jsx(_components.a,{href:`/channels/whatsapp`,children:`Connect a fresh number`}),` and read\n`,_jsx(_components.a,{href:`/channels/whatsapp#the-24-hour-window-governs-everything`,children:`the 24-hour window`}),` before you import\nanyone, because it changes what you can say to an imported list on day one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`bring-your-contacts`,children:`Bring your contacts`}),`\n`,_jsxs(_components.p,{children:[`The contacts CSV importer is the main road out of another CRM or a spreadsheet. Read\n`,_jsx(_components.a,{href:`/contacts/import-csv`,children:`Import contacts from CSV`}),` for the full behaviour; this is what matters when\nyou are migrating.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Connect your WhatsApp number first.`}),` The importer attaches every contact to the channel that is\nselected when you run it, and it refuses to run at all with no channel active\n(`,_jsx(_components.em,{children:`“Select a channel before importing.”`}),`). Importing before your number is live means importing\nonto the wrong channel.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/dmly/6B4zF7-Jj4UWoOxv/images/contacts/import-button.webp?fit=max\u0026auto=format\u0026n=6B4zF7-Jj4UWoOxv\u0026q=85\u0026s=53eccabd2ff85afa38db735252199c01`,alt:`The Contacts header with the Import button highlighted`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`414`,height:`414`,\"data-path\":`images/contacts/import-button.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dmly/6B4zF7-Jj4UWoOxv/images/contacts/import-button.webp?w=280\u0026fit=max\u0026auto=format\u0026n=6B4zF7-Jj4UWoOxv\u0026q=85\u0026s=76b2c7405486a64c6e6eaafe60cd7364 280w, https://mintcdn.com/dmly/6B4zF7-Jj4UWoOxv/images/contacts/import-button.webp?w=560\u0026fit=max\u0026auto=format\u0026n=6B4zF7-Jj4UWoOxv\u0026q=85\u0026s=750fd0d2195d80baf1b815874f63175d 560w, https://mintcdn.com/dmly/6B4zF7-Jj4UWoOxv/images/contacts/import-button.webp?w=840\u0026fit=max\u0026auto=format\u0026n=6B4zF7-Jj4UWoOxv\u0026q=85\u0026s=e0685235cb600d9584221bff58c322b1 840w, https://mintcdn.com/dmly/6B4zF7-Jj4UWoOxv/images/contacts/import-button.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=6B4zF7-Jj4UWoOxv\u0026q=85\u0026s=d5769792e8992968b651bb37682a2d1b 1100w, https://mintcdn.com/dmly/6B4zF7-Jj4UWoOxv/images/contacts/import-button.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=6B4zF7-Jj4UWoOxv\u0026q=85\u0026s=4a9823bc370fc5405cb1e4e6ff1166f4 1650w, https://mintcdn.com/dmly/6B4zF7-Jj4UWoOxv/images/contacts/import-button.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=6B4zF7-Jj4UWoOxv\u0026q=85\u0026s=3755fa6a624a318da4d441fc9d23cf22 2500w`}),`\n`,_jsx(Heading,{level:`3`,id:`the-columns`,children:`The columns`}),`\n`,_jsxs(_components.p,{children:[`Take `,_jsx(_components.strong,{children:`Download sample`}),` on the import page and match it. The header row is what the importer\nreads: order follows your header, capitalisation and stray spaces are ignored, and any column\nnot in this list is thrown away.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Column`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Required.`}),` A blank name skips the row, and the importer counts it for you.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`country_code`})}),_jsxs(_components.td,{children:[`Glued onto the front of `,_jsx(_components.code,{children:`phone`}),`, with nothing in between, to make the full number.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`phone`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Required.`}),` A blank phone skips the row, counted the same way.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`email`})}),_jsx(_components.td,{children:`Saved on the contact and used for matching. Not in the sample file, but it is read.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tags`})}),_jsxs(_components.td,{children:[`Tag names separated by `,_jsx(_components.code,{children:`|`}),` or `,_jsx(_components.code,{children:`,`}),`. Tags that don’t exist yet are created.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stage`})}),_jsxs(_components.td,{children:[`A `,_jsx(_components.a,{href:`/contacts/pipeline-stages`,children:`pipeline stage`}),`, matched on its exact name.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`notes`})}),_jsx(_components.td,{children:`Added as a note on the contact.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`custom_fields`})}),_jsxs(_components.td,{children:[`A JSON object of `,_jsx(_components.a,{href:`/contacts/custom-fields`,children:`custom fields`}),`, for example `,_jsx(_components.code,{children:`{\"company\":\"Acme\"}`}),`.`]})]})]})]}),`\n`,_jsx(_components.p,{children:`Three things bite migrators specifically:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A CSV of email-only contacts imports nobody.`}),` Every row needs a phone number. If your old\ntool was email-first, expect to lose the rows that have no mobile number.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Put the country code somewhere, once.`}),` If your export already has full international numbers\nin `,_jsx(_components.code,{children:`phone`}),`, leave `,_jsx(_components.code,{children:`country_code`}),` empty; otherwise you get the country code twice and the\nnumbers are unreachable.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Quote anything containing a comma.`}),` An unquoted comma inside a note shifts every later value\none column right and pushes the last column off the end of the row.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`it-won’t-duplicate-people-but-it-isn’t-read-only`,children:`It won’t duplicate people, but it isn’t read-only`}),`\n`,_jsxs(_components.p,{children:[`Before creating anything, the importer looks for an existing contact anywhere in the workspace\nwith the `,_jsx(_components.strong,{children:`same phone`}),` or the `,_jsx(_components.strong,{children:`same email`}),`. On a match it adds the identity and fills blanks\nrather than making a second person. That makes a second pass safe, but not harmless:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`phone`}),` and `,_jsx(_components.code,{children:`stage`}),` are only filled in `,_jsx(_components.strong,{children:`where they are empty`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tags are replaced`}),`, not added to. A file with an empty `,_jsx(_components.code,{children:`tags`}),` column strips every tag from\neveryone it matches.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Custom fields are overwritten`}),` on the keys your file sets.`]}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.code,{children:`notes`}),` value is added again, on every run.`]}),`\n`]}),`\n`,_jsxs(Tip,{children:[_jsxs(_components.p,{children:[`Migrating in stages? Export from DMLY between passes. `,_jsx(_components.strong,{children:`Export`}),` on the Contacts page writes the\nsame seven columns the importer reads, so you can carry your current tags forward in the next\nfile instead of wiping them.`]}),_jsxs(_components.p,{children:[`Blank the `,_jsx(_components.code,{children:`notes`}),` column before you re-import that file, though. The export joins all of a\ncontact’s notes into one cell, and the importer adds the cell back as a fresh note, so every\nround trip leaves another copy of the whole history stacked on the contact.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`importing-does-not-start-your-automations`,children:`Importing does not start your automations`}),`\n`,_jsxs(_components.p,{children:[`A contacts CSV import deliberately starts no contact automations. `,_jsx(_components.strong,{children:`New contact`}),`, `,_jsx(_components.strong,{children:`Tag\napplied`}),`, `,_jsx(_components.strong,{children:`Tag removed`}),` and `,_jsx(_components.strong,{children:`Field changed`}),` do not fire for imported rows, so you don’t need\nto pause anything first. The result message ends by saying so: `,_jsx(_components.em,{children:`“Automations that watch for new\ncontacts were not run.”`})]}),`\n`,_jsxs(_components.p,{children:[`The flip side: a welcome flow will not run for anyone you import. If you want imported people to\nget a message, send them a `,_jsx(_components.a,{href:`/broadcasts/overview`,children:`broadcast`}),` instead.`]}),`\n`,_jsxs(_components.p,{children:[`Webhooks still fire. A connected tool listening for `,_jsx(_components.code,{children:`contact.created`}),` or `,_jsx(_components.code,{children:`contact.tagged`}),` hears\nabout every imported row. See `,_jsx(_components.a,{href:`/automation/triggers`,children:`Triggers`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`one-more-thing-that-stops-a-migration-dead`,children:`One more thing that stops a migration dead`}),`\n`,_jsxs(_components.p,{children:[`Your plan caps how many contacts a workspace can hold, and the whole file is checked `,_jsx(_components.strong,{children:`before a\nsingle row is written`}),`, so an import that would take you over the cap imports nothing at all.\nThe check is deliberately cautious: rows that would only have matched someone you already have\nstill count toward the estimate. See `,_jsx(_components.a,{href:`/billing/plans`,children:`Plans`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`carry-your-opt-outs-across`,children:`Carry your opt-outs across`}),`\n`,_jsx(_components.p,{children:`If someone told your old tool to stop messaging them, that instruction does not travel with a CSV.\nThis is the one part of a migration with legal weight, so here is the plain truth.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`DMLY has no way to import opt-out or suppression state.`}),` Not through the CSV importer, and\nnot through the `,_jsx(_components.a,{href:`/api-reference/introduction`,children:`API`}),`. A contact’s opted-out state is set when they\nsend a stop keyword on a channel, or when a flow’s `,_jsx(_components.strong,{children:`Unsubscribe Contact`}),` step runs on them.\nThere is no field, column or endpoint that sets it in bulk. Everyone you import arrives\nmessageable, unless they had already opted out of this DMLY workspace before.`]})}),`\n`,_jsx(_components.p,{children:`So decide deliberately, before you build the file:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Export your suppression list from the old tool first`,children:_jsx(_components.p,{children:`Do this while you still have access. Once the number moves, that tool has nothing to show you.`})}),_jsx(Step,{title:`Leave opted-out people out of the CSV`,children:_jsx(_components.p,{children:`This is the safest option by a distance, and usually the right one. A person who is not in the\nworkspace cannot be broadcast to by accident, cannot be swept into a segment, and cannot be\nmessaged by a teammate who did not know. If you have no business reason to hold their record,\ndo not import it.`})}),_jsxs(Step,{title:`If you must keep them, tag them and exclude the tag everywhere`,children:[_jsxs(_components.p,{children:[`Give them a tag of your own in the `,_jsx(_components.code,{children:`tags`}),` column (`,_jsx(_components.code,{children:`Do not contact`}),` does the job) and add it\nto `,_jsx(_components.strong,{children:`Exclude contacts with tags`}),` on every `,_jsx(_components.a,{href:`/contacts/tags-and-segments`,children:`segment`}),` and\n`,_jsx(_components.a,{href:`/broadcasts/audiences`,children:`broadcast audience`}),` you build.`]}),_jsxs(_components.p,{children:[`Use your own tag rather than the built-in `,_jsx(_components.strong,{children:`Unsubscribe`}),` one. DMLY manages that tag itself:\nit attaches it when someone opts out and `,_jsx(_components.strong,{children:`removes`}),` it when they opt back in, so a marker you\napplied by hand can vanish without you touching it.`]}),_jsxs(_components.p,{children:[`Understand what this is and isn’t: the tag is a filter you are applying by hand, not the\nopt-out flag. Importing the `,_jsx(_components.strong,{children:`Unsubscribe`}),` tag does `,_jsx(_components.strong,{children:`not`}),` opt anyone out. Sequences,\nautomations and any audience where you forgot the exclusion will still send to them.`]})]}),_jsx(Step,{title:`For the ones that really must never be messaged, block them`,children:_jsxs(_components.p,{children:[`Your own tag stops nothing by itself: a teammate can still reply by hand. Once a contact is\nreally opted out in DMLY (after they send a stop keyword, or a flow’s `,_jsx(_components.strong,{children:`Unsubscribe Contact`}),`\nstep runs on them), manual replies are refused too, until they are resubscribed. For an\nimported contact who never opted out inside DMLY, blocking is the switch that disables the\ninbox composer. It is set per conversation, so it is one at a time, which is exactly why option\ntwo above is better for a long list.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Read `,_jsx(_components.a,{href:`/contacts/data-and-privacy`,children:`Data, privacy and consent`}),` before you send anything to an\nimported list. And remember the other half: `,_jsx(_components.strong,{children:`importing a list is not consent.`}),` WhatsApp holds\nyou to what the contact agreed to, not to what your spreadsheet says.`]}),`\n`,_jsx(Heading,{level:`2`,id:`bring-your-catalogue`,children:`Bring your catalogue`}),`\n`,_jsxs(_components.p,{children:[`If you sell services or products, both have their own CSV importer and both only ever `,_jsx(_components.strong,{children:`add`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Services`}),`: columns `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`category`}),`, `,_jsx(_components.code,{children:`duration_min`}),`, `,_jsx(_components.code,{children:`price`}),`, `,_jsx(_components.code,{children:`currency`}),`,\n`,_jsx(_components.code,{children:`capacity`}),`, `,_jsx(_components.code,{children:`description`}),`, `,_jsx(_components.code,{children:`active`}),`. `,_jsx(_components.code,{children:`name`}),` is the only required one; `,_jsx(_components.code,{children:`type`}),` is `,_jsx(_components.code,{children:`appointment`}),`,\n`,_jsx(_components.code,{children:`class`}),` or `,_jsx(_components.code,{children:`add_on`}),` and anything else imports as `,_jsx(_components.code,{children:`appointment`}),`. A row whose name matches an\nexisting service is skipped rather than overwritten, so a re-run never damages what you have.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`An imported service is not bookable yet.`}),` The CSV has no columns for staff or working hours,\nso every imported service arrives with an empty schedule and nobody assigned, while still\nshowing on your public booking page, offering zero times. Assign staff who have their own\n`,_jsx(_components.strong,{children:`Working hours`}),`, or set the service’s own weekly availability, before you point anyone at your\nbooking page. Full detail: `,_jsx(_components.a,{href:`/appointments/services`,children:`Services`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Products`}),`: columns `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`sku`}),`, `,_jsx(_components.code,{children:`price`}),`, `,_jsx(_components.code,{children:`cost_price`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`tax_rate`}),`,\n`,_jsx(_components.code,{children:`tax_inclusive`}),`, `,_jsx(_components.code,{children:`track_stock`}),`, `,_jsx(_components.code,{children:`stock_quantity`}),`, `,_jsx(_components.code,{children:`low_stock_threshold`}),`, `,_jsx(_components.code,{children:`category`}),`, `,_jsx(_components.code,{children:`active`}),`,\n`,_jsx(_components.code,{children:`description`}),`. Every row with a name becomes a `,_jsx(_components.strong,{children:`new`}),` product; nothing is matched against what\nyou already have, so uploading the same file twice gives you two of every product. Import once,\ncheck, and make later changes in the app. Full detail: `,_jsx(_components.a,{href:`/offerings/products`,children:`Products`}),`.`]}),`\n`,_jsxs(Tip,{children:[_jsxs(_components.p,{children:[`Tags and custom field definitions have CSV importers of their own: tags on\n`,_jsx(_components.strong,{children:`Contacts → Manage tags`}),`, where `,_jsx(_components.strong,{children:`Import CSV`}),` and `,_jsx(_components.strong,{children:`Download sample`}),` sit above the tag\nlist, and custom fields on `,_jsx(_components.strong,{children:`Settings → Custom fields`}),`.`]}),_jsxs(_components.p,{children:[`Neither is a prerequisite for importing contacts: the contacts importer creates any tag it\ndoesn’t already have, and it writes whatever your `,_jsx(_components.code,{children:`custom_fields`}),` column contains without\nchecking it against your definitions. Import them anyway if you want your tag colours and a\ntidy field list from the start. And note that a `,_jsx(_components.code,{children:`custom_fields`}),` column never registers its\nkeys on `,_jsx(_components.a,{href:`/contacts/custom-fields`,children:`Custom fields`}),`, so importing three thousand contacts\ncarrying `,_jsx(_components.code,{children:`membership_no`}),` puts the value on every one of them while leaving your definitions\nlist empty.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`rebuild-what-can’t-move`,children:`Rebuild what can’t move`}),`\n`,_jsx(Heading,{level:`3`,id:`message-templates`,children:`Message templates`}),`\n`,_jsx(_components.p,{children:`Templates belong to your WhatsApp Business Account at Meta, not to DMLY and not to your old\nprovider’s software. That single fact decides your timeline:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The account comes with you`}),` → your approved templates come with it. Open `,_jsx(_components.strong,{children:`Templates`}),`,\nselect `,_jsx(_components.strong,{children:`Refresh templates`}),`, and they appear in DMLY with their current status pulled from\nMeta. Nothing to re-submit.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The number lands on a different account`}),` → the templates do not follow. Every one you rely on\nhas to be recreated and submitted to Meta for review again.`]}),`\n`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/dmly/w7uAcWYMZYfYTnEH/images/setup-checklist/templates-refresh.webp?fit=max\u0026auto=format\u0026n=w7uAcWYMZYfYTnEH\u0026q=85\u0026s=96178cdf87699fbc5fe34ca21454617c`,alt:`The Templates page on the System tab, showing DMLY's templates with their Meta review status and the Refresh templates button highlighted`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`856`,height:`856`,\"data-path\":`images/setup-checklist/templates-refresh.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/dmly/w7uAcWYMZYfYTnEH/images/setup-checklist/templates-refresh.webp?w=280\u0026fit=max\u0026auto=format\u0026n=w7uAcWYMZYfYTnEH\u0026q=85\u0026s=6b30f0951a35991e3097926085bb3d2d 280w, https://mintcdn.com/dmly/w7uAcWYMZYfYTnEH/images/setup-checklist/templates-refresh.webp?w=560\u0026fit=max\u0026auto=format\u0026n=w7uAcWYMZYfYTnEH\u0026q=85\u0026s=ebd766b64ced5ad574e8b3a45ac8a1cc 560w, https://mintcdn.com/dmly/w7uAcWYMZYfYTnEH/images/setup-checklist/templates-refresh.webp?w=840\u0026fit=max\u0026auto=format\u0026n=w7uAcWYMZYfYTnEH\u0026q=85\u0026s=fd19c979c3e6a4c7ebc3c24cbd8b8110 840w, https://mintcdn.com/dmly/w7uAcWYMZYfYTnEH/images/setup-checklist/templates-refresh.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=w7uAcWYMZYfYTnEH\u0026q=85\u0026s=ed534f35b678be8451f9154fbf651eb3 1100w, https://mintcdn.com/dmly/w7uAcWYMZYfYTnEH/images/setup-checklist/templates-refresh.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=w7uAcWYMZYfYTnEH\u0026q=85\u0026s=b5aca90557089cc7beff05b0c404d032 1650w, https://mintcdn.com/dmly/w7uAcWYMZYfYTnEH/images/setup-checklist/templates-refresh.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=w7uAcWYMZYfYTnEH\u0026q=85\u0026s=408e7b2214b2e01b4b111098c829a75a 2500w`}),`\n`,_jsxs(_components.p,{children:[`On top of your own templates, DMLY submits its own built-in `,_jsx(_components.code,{children:`dmly_`}),` templates for review the\nmoment a live number connects. Those cover appointment confirmations and reminders, invoices,\nreceipts, review requests and more. Until Meta approves them, the notifications that depend\non them are not sent at all to anyone whose 24-hour window is shut.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Meta reviews templates on Meta’s schedule. Plan around it: nothing you send to a cold contact\n(no broadcast, no reminder, no receipt) works until the template it uses is `,_jsx(_components.strong,{children:`Approved`}),`. This\nis the longest lead time in the whole move, which is why the cutover plan below starts with it.`]})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/broadcasts/message-templates`,children:`Message templates`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`automations-and-chatbots`,children:`Automations and chatbots`}),`\n`,_jsxs(_components.p,{children:[`There is no importer for flows, and no format DMLY reads from another tool. Rebuild them in the\n`,_jsx(_components.a,{href:`/automation/flow-builder`,children:`flow builder`}),`, and treat it as a chance to drop the branches nobody\nused. Start from a ready-made template rather than a blank canvas where one fits.`]}),`\n`,_jsx(Heading,{level:`3`,id:`conversation-history`,children:`Conversation history`}),`\n`,_jsx(_components.p,{children:`Nothing imports past messages, from any source, with one exception: a number connected in\nco-existence brings up to 180 days of Business app chats with it (see above). Otherwise the inbox\nstarts on the day you connect.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Do not try to backfill history through the API.`}),` `,_jsx(_components.code,{children:`POST /messages`}),` is a send; it routes\nthrough the same path as the inbox composer and really delivers the message to the customer.\nReplaying last year’s conversations through it would message your entire list.`]})}),`\n`,_jsx(_components.p,{children:`Export transcripts from your old tool and keep the file somewhere you can search it. That is the\nwhole answer today.`}),`\n`,_jsx(Heading,{level:`3`,id:`invoices-orders-and-past-money`,children:`Invoices, orders and past money`}),`\n`,_jsxs(_components.p,{children:[`There is no CSV import for finance records. What exists is the\n`,_jsx(_components.a,{href:`/api-reference/introduction`,children:`REST API`}),`, which can create invoices, orders and contacts\nprogrammatically, so a large or complicated move can be scripted rather than typed.`]}),`\n`,_jsx(_components.p,{children:`Two things to know if you go that way:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /invoices`}),` creates a `,_jsx(_components.strong,{children:`draft`}),`. Nothing reaches the customer until you make the separate\n`,_jsx(_components.code,{children:`POST /invoices/{invoice}/send`}),` call, so a backfill never emails or messages anyone an invoice\nfrom years ago.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /appointments`}),` is different: booking through it sends the customer a confirmation and\nseeds their reminders, exactly as a real booking does. Do not use it to replay a back catalogue\nof past appointments.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A finance backfill starts automations, unlike a contacts import.`}),` Creating an\ninvoice fires `,_jsx(_components.strong,{children:`Invoice created`}),`; creating an order fires `,_jsx(_components.strong,{children:`Order created`}),`; and either one,\nagainst a contact who isn’t a client yet, also fires `,_jsx(_components.strong,{children:`Contact converted to client`}),` and\n`,_jsx(_components.strong,{children:`Lifecycle stage changed`}),`. A script that loads a year of invoices starts one run per record.\nSet those four to `,_jsx(_components.strong,{children:`Paused`}),` before you run it, and switch them back on afterwards.`]})}),`\n`,_jsx(_components.p,{children:`For most businesses the pragmatic answer is: keep the old system read-only for a few months for\nlookups, and start DMLY clean from the switchover date.`}),`\n`,_jsx(Heading,{level:`2`,id:`a-cutover-plan-that-keeps-you-trading`,children:`A cutover plan that keeps you trading`}),`\n`,_jsx(_components.p,{children:`The order matters because template review is the only step that waits on someone else.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Two weeks out: set up DMLY alongside your old tool`,children:_jsxs(_components.p,{children:[`Create the workspace, fill in your `,_jsx(_components.a,{href:`/account/business-details`,children:`business details`}),`, invite your\nteam. Import your tags and custom fields. Nothing here touches your live number, so there is\nno risk in doing it early.`]})}),_jsx(Step,{title:`Then: export everything from the old tool`,children:_jsx(_components.p,{children:`Contacts, suppression list, chat transcripts, campaign reports, invoice records. You will not\nget another chance once the number moves. Keep the files.`})}),_jsx(Step,{title:`Then: import your catalogue and set availability`,children:_jsx(_components.p,{children:`Services and products, then staff, working hours and booking rules. Check your booking page\noffers real times before anyone sees it.`})}),_jsx(Step,{title:`Turn off two-step verification on the number`,children:_jsx(_components.p,{children:`At Meta, in your WhatsApp Business Manager. Do this before you attempt the connect, not\nduring it.`})}),_jsx(Step,{title:`Move the number and connect it`,children:_jsx(_components.p,{children:`Off-peak, on a quiet day. There is a gap between your old tool losing the number and DMLY\nregistering it, and messages sent to you during it can be missed, so pick the quietest hour\nyou have, not the busiest.`})}),_jsx(Step,{title:`Immediately: get templates moving`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Refresh templates`}),`. Whatever isn’t there, create and submit now, while you still have\nother things to do. Everything downstream waits on this.`]})}),_jsx(Step,{title:`Send yourself a test message`,children:_jsxs(_components.p,{children:[`From your own phone, to the number. If it appears in the `,_jsx(_components.a,{href:`/inbox/overview`,children:`Inbox`}),`, the channel\nis genuinely live. If it doesn’t, stop and fix that before anything else:\n`,_jsx(_components.a,{href:`/channels/no-inbound-messages`,children:`No inbound messages`}),`.`]})}),_jsx(Step,{title:`Import contacts`,children:_jsx(_components.p,{children:`Import the file with your WhatsApp channel selected. The import does not start automations,\nso there is nothing to pause. Check the count that comes back against your row count.`})}),_jsx(Step,{title:`Rebuild your automations, then broadcast`,children:_jsxs(_components.p,{children:[`Build the flows you actually use, test each one on yourself, and only then send your first\nbroadcast, once its template is `,_jsx(_components.strong,{children:`Approved`}),` and your audience excludes everyone who opted\nout at the old tool.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`when-something-goes-wrong`,children:`When something goes wrong`}),`\n`,_jsx(Accordion,{title:`The migration failed and the error mentions verification or 2FA`,id:`the-migration-failed-and-the-error-mentions-verification-or-2fa`,children:_jsx(_components.p,{children:`Two-step verification is still on for the number at Meta. Turn it off in your WhatsApp Business\nManager and run the connect again. DMLY warns about this on the connect screen before you\nstart, which is why it is the first thing to check.`})}),`\n`,_jsx(Accordion,{title:`Signup finished but DMLY says no WhatsApp Business Account was granted`,id:`signup-finished-but-dmly-says-no-whatsapp-business-account-was-granted`,children:_jsxs(_components.p,{children:[`The Facebook flow was not completed all the way through: closing the window early, or skipping\na permission screen, returns you with nothing granted. Retry the signup and complete every\nscreen. If it says the account has `,_jsx(_components.strong,{children:`no phone number yet`}),`, finish verifying the number at Meta\nfirst, then retry.`]})}),`\n`,_jsx(Accordion,{title:`The number connected but nothing arrives in the Inbox`,id:`the-number-connected-but-nothing-arrives-in-the-inbox`,children:_jsxs(_components.p,{children:[`Check two things on `,_jsx(_components.strong,{children:`Bot Setup → WhatsApp → Configuration`}),`: the number must show\n`,_jsx(_components.strong,{children:`Registered`}),`, and the WhatsApp Business Account must be subscribed. A number that is verified\nbut not registered cannot send or receive anything, even though DMLY shows it as connected.\nA co-existence number is the exception: it shows `,_jsx(_components.strong,{children:`Business app + Cloud API`}),` instead, and it\nmust never be registered, because registering it would cut it off from the phone app.\nFull walkthrough: `,_jsx(_components.a,{href:`/channels/no-inbound-messages`,children:`No inbound messages`}),`.`]})}),`\n`,_jsx(Accordion,{title:`Your templates aren't in DMLY after the move`,id:`your-templates-arent-in-dmly-after-the-move`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Refresh templates`}),` first, to sync now rather than waiting for the next automatic pass.\nIf they are still missing, the number is on a different WhatsApp Business Account from the one\nthat held them. Templates belong to the account, so they cannot be pulled across from elsewhere;\nrecreate and re-submit them. See `,_jsx(_components.a,{href:`/broadcasts/message-templates`,children:`Message templates`}),`.`]})}),`\n`,_jsx(Accordion,{title:`Broadcasts have nothing to send`,id:`broadcasts-have-nothing-to-send`,children:_jsxs(_components.p,{children:[`The broadcast picker lists `,_jsx(_components.strong,{children:`Approved`}),` templates only. Draft, Pending and Rejected templates do\nnot appear at all. If everything is Pending, you are waiting on Meta; there is no way to\naccelerate it from DMLY.`]})}),`\n`,_jsxs(Accordion,{title:`Fewer contacts imported than rows in your file`,id:`fewer-contacts-imported-than-rows-in-your-file`,children:[_jsxs(_components.p,{children:[`Almost always a blank `,_jsx(_components.strong,{children:`name`}),` or a blank phone number. You don’t have to guess how many: the\nmessage you land back on says `,_jsx(_components.em,{children:`“N contacts imported. M row(s) skipped — missing a name or a\nphone number. Automations that watch for new contacts were not run.”`}),` Read that count first. If it matches your own tally of empty cells, nothing\nelse is wrong and you can fix those rows and re-run.`]}),_jsxs(_components.p,{children:[`If `,_jsx(_components.em,{children:`nothing`}),` imported, DMLY says so on the upload screen rather than reporting a green zero,\nand that almost always means the header row doesn’t contain `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`country_code`}),` and `,_jsx(_components.code,{children:`phone`}),`\nspelled the way the importer expects. Take the sample file and copy its header exactly.`]})]}),`\n`,_jsx(Accordion,{title:`The whole import was blocked`,id:`the-whole-import-was-blocked`,children:_jsxs(_components.p,{children:[`Your plan’s contact cap. The file is checked in full before anything is written, so an import\nthat would take you over the cap writes nothing; there is no half-finished state to clean up.\nSee `,_jsx(_components.a,{href:`/billing/plans`,children:`Plans`}),` and `,_jsx(_components.a,{href:`/billing/choosing-a-plan`,children:`Choosing a plan`}),`.`]})}),`\n`,_jsx(Accordion,{title:`Contacts arrived but you can't message them`,id:`contacts-arrived-but-you-cant-message-them`,children:_jsxs(_components.p,{children:[`Expected, and not an import problem. An imported contact has never messaged you, so they have no\nopen 24-hour window; they can only be reached with an approved template until they reply. See\n`,_jsx(_components.a,{href:`/broadcasts/whatsapp-rules-and-limits`,children:`WhatsApp rules and limits`}),`.`]})}),`\n`,_jsx(Accordion,{title:`Your old tool still shows the number as connected`,id:`your-old-tool-still-shows-the-number-as-connected`,children:_jsxs(_components.p,{children:[`That is between you and them. DMLY cannot release, delete or change a number on another\nprovider’s account, and disconnecting in DMLY does not touch anything at Meta. See\n`,_jsx(_components.a,{href:`/channels/delete-whatsapp-number`,children:`Delete a WhatsApp number`}),`. Close the account down in the old\ntool once you are satisfied DMLY is receiving.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`next`,children:`Next`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Set up your workspace`,icon:`list-check`,href:`/getting-started/setup-checklist`,children:_jsx(_components.p,{children:`The full setup order, from business details to your first automation.`})}),_jsx(Card,{title:`Connect WhatsApp`,icon:`whatsapp`,href:`/channels/whatsapp`,children:_jsx(_components.p,{children:`Connecting, registering and the rules that shape everything afterwards.`})}),_jsx(Card,{title:`Import contacts from CSV`,icon:`file-csv`,href:`/contacts/import-csv`,children:_jsx(_components.p,{children:`The full importer behaviour, column by column.`})}),_jsx(Card,{title:`Data, privacy and consent`,icon:`user-shield`,href:`/contacts/data-and-privacy`,children:_jsx(_components.p,{children:`Opt-out, blocking and what each one actually stops.`})}),_jsx(Card,{title:`Message templates`,icon:`file-lines`,href:`/broadcasts/message-templates`,children:_jsx(_components.p,{children:`Build a template Meta will approve, and track its status.`})}),_jsx(Card,{title:`API reference`,icon:`code`,href:`/api-reference/introduction`,children:_jsx(_components.p,{children:`Script a bulk or complicated move against the REST API.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Migrate to DMLY","description":"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.","icon":"arrow-right-arrow-left","href":"/getting-started/migrating-to-dmly"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What moves, and what you rebuild","slug":"what-moves-and-what-you-rebuild","depth":2,"children":[]},{"title":"Move your WhatsApp number","slug":"move-your-whatsapp-number","depth":2,"children":[{"title":"Coming from another provider","slug":"coming-from-another-provider","depth":3,"children":[]},{"title":"Coming from the WhatsApp Business phone app","slug":"coming-from-the-whatsapp-business-phone-app","depth":3,"children":[]},{"title":"Coming from no WhatsApp at all","slug":"coming-from-no-whatsapp-at-all","depth":3,"children":[]}]},{"title":"Bring your contacts","slug":"bring-your-contacts","depth":2,"children":[{"title":"The columns","slug":"the-columns","depth":3,"children":[]},{"title":"It won’t duplicate people, but it isn’t read-only","slug":"it-won’t-duplicate-people-but-it-isn’t-read-only","depth":3,"children":[]},{"title":"Importing does not start your automations","slug":"importing-does-not-start-your-automations","depth":3,"children":[]},{"title":"One more thing that stops a migration dead","slug":"one-more-thing-that-stops-a-migration-dead","depth":3,"children":[]}]},{"title":"Carry your opt-outs across","slug":"carry-your-opt-outs-across","depth":2,"children":[]},{"title":"Bring your catalogue","slug":"bring-your-catalogue","depth":2,"children":[]},{"title":"Rebuild what can’t move","slug":"rebuild-what-can’t-move","depth":2,"children":[{"title":"Message templates","slug":"message-templates","depth":3,"children":[]},{"title":"Automations and chatbots","slug":"automations-and-chatbots","depth":3,"children":[]},{"title":"Conversation history","slug":"conversation-history","depth":3,"children":[]},{"title":"Invoices, orders and past money","slug":"invoices-orders-and-past-money","depth":3,"children":[]}]},{"title":"A cutover plan that keeps you trading","slug":"a-cutover-plan-that-keeps-you-trading","depth":2,"children":[]},{"title":"When something goes wrong","slug":"when-something-goes-wrong","depth":2,"children":[]},{"title":"Next","slug":"next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/dmly/4c7301d044212c16/livechat.js"],"dynamicCss":".mint-aspect-video {\n aspect-ratio: 16 / 9\n}\n.mint-w-full {\n width: 100%\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}","subdomain":"dmly","siteName":"DMLY","title":"Migrate to DMLY - DMLY","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T16:05:17.564Z","originalFileLocation":"getting-started/migrating-to-dmly.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DMLY\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Migrate to DMLY - DMLY\">\u003cmeta data-mint-head property=\"og:description\" content=\"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DMLY Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dmly.io/getting-started/migrating-to-dmly\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dmly.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Migrate+to+DMLY\u0026amp;description=Move+your+WhatsApp+number%2C+contacts+and+catalogue+over+from+another+WhatsApp+tool%2C+a+CRM+or+a+spreadsheet%2C+and+know+exactly+what+has+to+be+rebuilt.\u0026amp;theme=694b18f605ee29c306b9a4dd\u0026amp;signature=df4f4556bf169140262701c5a8158665ea951400b348915d5add47e12da5ee44\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Migrate to DMLY - DMLY\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dmly.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Migrate+to+DMLY\u0026amp;description=Move+your+WhatsApp+number%2C+contacts+and+catalogue+over+from+another+WhatsApp+tool%2C+a+CRM+or+a+spreadsheet%2C+and+know+exactly+what+has+to+be+rebuilt.\u0026amp;theme=694b18f605ee29c306b9a4dd\u0026amp;signature=df4f4556bf169140262701c5a8158665ea951400b348915d5add47e12da5ee44\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dmly/lfRW6ISFl91aW1aq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DMLY\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#12715B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dmly.io/getting-started/migrating-to-dmly\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started/migrating-to-dmly.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dmly.io/#organization\",\"name\":\"DMLY\",\"url\":\"https://docs.dmly.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dmly/DoG8FVD9UVpfrD19/logo/light.png?fit=max\u0026auto=format\u0026n=DoG8FVD9UVpfrD19\u0026q=85\u0026s=7eda62740d42f25df6e609cfb033fd65\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dmly.io#website\",\"name\":\"DMLY\",\"url\":\"https://docs.dmly.io\",\"publisher\":{\"@id\":\"https://docs.dmly.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dmly.io/getting-started/migrating-to-dmly#webpage\",\"url\":\"https://docs.dmly.io/getting-started/migrating-to-dmly\",\"name\":\"Migrate to DMLY\",\"description\":\"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.\",\"dateModified\":\"2026-11-17T16:05:17.564Z\",\"isPartOf\":{\"@id\":\"https://docs.dmly.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dmly.io/getting-started/migrating-to-dmly#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dmly.io/getting-started/migrating-to-dmly#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.dmly.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Migrate to DMLY\",\"item\":\"https://docs.dmly.io/getting-started/migrating-to-dmly\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.dmly.io/getting-started/migrating-to-dmly#article\",\"headline\":\"Migrate to DMLY\",\"name\":\"Migrate to DMLY\",\"description\":\"Move your WhatsApp number, contacts and catalogue over from another WhatsApp tool, a CRM or a spreadsheet, and know exactly what has to be rebuilt.\",\"url\":\"https://docs.dmly.io/getting-started/migrating-to-dmly\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dmly.io/getting-started/migrating-to-dmly#webpage\"},\"dateModified\":\"2026-11-17T16:05:17.564Z\",\"publisher\":{\"@id\":\"https://docs.dmly.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dmly.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DMLY\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"DMLY\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/getting-started/migrating-to-dmly.md","siteName":"DMLY","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","groups":[{"group":"Getting started","icon":"rocket","pages":[{"title":"DMLY documentation","sidebarTitle":"Introduction","icon":"house","mode":"wide","href":""},{"title":"Create your account","icon":"user-plus","href":"/getting-started/create-account"},{"title":"Workspaces","icon":"briefcase","href":"/getting-started/workspaces"},{"title":"Set up your workspace","description":"The order to do things in to go from an empty DMLY workspace to a working WhatsApp inbox, team and first automation.","icon":"list-check","href":"/getting-started/setup-checklist"},{"title":"Migrate to DMLY","icon":"arrow-right-arrow-left","href":"/getting-started/migrating-to-dmly"},{"title":"Navigating DMLY","description":"A tour of the DMLY sidebar: what each area does, and where to find settings, your team and integrations.","icon":"compass","href":"/getting-started/navigating-dmly"},{"title":"The DMLY mobile app","icon":"mobile-screen-button","href":"/getting-started/mobile-app"},{"title":"Install DMLY as an app","icon":"download","href":"/getting-started/install-app"}]},{"group":"Messaging","pages":[{"group":"Inbox \u0026 conversations","icon":"inbox","expanded":false,"pages":[{"title":"The unified inbox","icon":"inbox","href":"/inbox/overview"},{"title":"Assign chats to teammates","icon":"user-check","href":"/inbox/assigning-chats"},{"title":"Open and done conversations","icon":"circle-check","href":"/inbox/conversation-status"},{"title":"Use saved replies","icon":"comment-dots","href":"/inbox/quick-replies"},{"title":"Work a conversation as a team","icon":"note-sticky","href":"/inbox/notes-and-collaboration"},{"title":"Notifications","icon":"bell","href":"/inbox/notifications"},{"title":"Make and take WhatsApp calls","icon":"phone","href":"/inbox/whatsapp-calling"}]},{"group":"Channels","icon":"plug","expanded":false,"pages":[{"title":"Channels overview","icon":"plug","href":"/channels/overview"},{"title":"Connect WhatsApp","icon":"whatsapp","href":"/channels/whatsapp"},{"title":"Connect a Facebook Page","icon":"facebook-messenger","href":"/channels/facebook-messenger"},{"title":"Capture Facebook lead forms","icon":"clipboard-list","href":"/channels/facebook-lead-forms"},{"title":"Connect Instagram","icon":"instagram","href":"/channels/instagram"},{"title":"Connect Telegram","icon":"telegram","href":"/channels/telegram"},{"title":"Add the Live Chat widget to your website","icon":"comments","href":"/channels/livechat-widget"},{"title":"Connect Google Business Profile","icon":"google","href":"/channels/google-business-profile"},{"title":"Connect SMS","icon":"comment-sms","href":"/channels/sms"},{"title":"Connect TikTok","icon":"tiktok","href":"/channels/tiktok"},{"group":"Channel troubleshooting","expanded":false,"pages":[{"title":"WhatsApp limits and quality rating","icon":"gauge","href":"/channels/whatsapp-limits"},{"title":"Fix no inbound messages","icon":"comment-slash","href":"/channels/no-inbound-messages"},{"title":"Fix a silent Facebook Page or Instagram account","icon":"plug-circle-xmark","href":"/channels/no-inbound-meta"},{"title":"Recover a disabled WhatsApp account","icon":"ban","href":"/channels/account-disabled"},{"title":"Delete a WhatsApp number","icon":"trash","href":"/channels/delete-whatsapp-number"}]}]},{"group":"Contacts \u0026 CRM","icon":"address-book","expanded":false,"pages":[{"title":"Contacts overview","icon":"address-book","href":"/contacts/overview"},{"title":"Import contacts from CSV","icon":"file-csv","href":"/contacts/import-csv"},{"title":"Tags and segments","icon":"tags","href":"/contacts/tags-and-segments"},{"title":"Custom fields","icon":"list-check","href":"/contacts/custom-fields"},{"title":"Pipeline stages","icon":"diagram-project","href":"/contacts/pipeline-stages"},{"title":"Client profile","icon":"address-book","href":"/contacts/client-profile"},{"title":"Attach documents to a contact","icon":"paperclip","href":"/contacts/documents"},{"title":"Generate client letters","icon":"file-lines","href":"/contacts/letters"},{"title":"Linked contacts","icon":"people-arrows","href":"/contacts/linked-contacts"},{"title":"Data, privacy and consent","icon":"user-shield","href":"/contacts/data-and-privacy"}]},{"group":"Automation \u0026 chatbots","icon":"robot","expanded":false,"pages":[{"title":"How automation works","icon":"robot","href":"/automation/overview"},{"title":"Build a flow","icon":"diagram-project","href":"/automation/flow-builder"},{"title":"Triggers","icon":"bolt","href":"/automation/triggers"},{"title":"Variables reference","icon":"brackets-curly","href":"/automation/variables"},{"title":"Call a webhook from a flow","icon":"arrow-right-arrow-left","href":"/automation/webhook-step"},{"title":"Start from a template","icon":"clone","href":"/automation/templates"},{"title":"Add an automation pack","icon":"boxes-stacked","href":"/automation/automation-packs"},{"title":"Sell on WhatsApp","icon":"bag-shopping","href":"/automation/sell-on-whatsapp"},{"title":"Store automations","icon":"cart-shopping","href":"/automation/store-automations"},{"title":"Reply with AI","icon":"robot","href":"/automation/ai-replies"},{"title":"AI agent tools","icon":"wrench","href":"/automation/ai-agent-tools"},{"title":"Take orders with AI","icon":"cart-shopping","href":"/automation/ai-ordering"},{"title":"Publish a flow","icon":"rocket","href":"/automation/publishing-bots"},{"title":"Sequences","icon":"list-ol","href":"/automation/sequences"},{"title":"Build a lead qualification bot","icon":"user-check","href":"/automation/lead-qualification"},{"title":"Automate comments and comment-to-DM","icon":"comments","href":"/automation/comment-automation"},{"title":"Set up ice breakers","icon":"comment-dots","href":"/automation/icebreakers"},{"title":"Set up a persistent menu","icon":"bars","href":"/automation/persistent-menu"},{"title":"Ask for a phone number","icon":"phone","href":"/automation/request-phone"},{"title":"Common mistakes","icon":"triangle-exclamation","href":"/automation/common-mistakes"},{"title":"Bot setup","icon":"sliders","href":"/automation/bot-setup"},{"title":"WhatsApp Flows","icon":"clipboard-list","href":"/automation/whatsapp-flows"}]},{"group":"Broadcasts","icon":"bullhorn","expanded":false,"pages":[{"title":"Broadcasts overview","icon":"bullhorn","href":"/broadcasts/overview"},{"title":"Create a broadcast","icon":"bullhorn","href":"/broadcasts/create-campaign"},{"title":"Send paid Marketing Messages","icon":"money-bill","href":"/broadcasts/marketing-messages"},{"title":"Message templates","icon":"file-lines","href":"/broadcasts/message-templates"},{"title":"Understanding the system templates","icon":"list-check","href":"/broadcasts/system-templates"},{"title":"WhatsApp rules and limits for broadcasts","icon":"whatsapp","href":"/broadcasts/whatsapp-rules-and-limits"},{"title":"Choose who receives a broadcast","icon":"users","href":"/broadcasts/audiences"},{"title":"Schedule a broadcast","icon":"clock","href":"/broadcasts/scheduling"},{"title":"Read broadcast results","icon":"chart-simple","href":"/broadcasts/analytics"}]},{"group":"Growth tools","icon":"share-nodes","expanded":false,"pages":[{"title":"Overview","icon":"share-nodes","href":"/growth/overview"},{"title":"QR codes and links","icon":"qrcode","href":"/growth/qr-codes-and-links"}]}]},{"group":"Business","pages":[{"group":"Appointments","icon":"calendar-days","tag":"NEW","expanded":false,"pages":[{"title":"Appointments overview","icon":"calendar-days","href":"/appointments/overview"},{"title":"Bookable services","icon":"clipboard-list","href":"/appointments/services"},{"title":"Staff and availability","icon":"user-clock","href":"/appointments/staff-and-availability"},{"title":"Booking page","icon":"calendar-days","href":"/appointments/booking-page"},{"title":"Client portal","icon":"user-lock","href":"/appointments/client-portal"},{"title":"Run group classes","icon":"people-group","href":"/appointments/classes"},{"title":"Take payment for a booking","icon":"credit-card","href":"/appointments/payments"},{"title":"Sync Google Calendar and Zoom","icon":"calendar-days","href":"/appointments/calendar-sync"},{"title":"Connect a custom booking domain","icon":"globe","href":"/appointments/custom-domain"},{"title":"Meetings","icon":"calendar-check","href":"/appointments/meetings"}]},{"group":"Offerings","icon":"tags","tag":"NEW","expanded":false,"pages":[{"title":"Offerings overview","icon":"boxes-stacked","href":"/offerings/overview"},{"title":"Sell products and track stock","icon":"box","href":"/offerings/products"},{"title":"Plans and credits","icon":"coins","href":"/offerings/plans-and-credits"},{"title":"Sell and redeem gift cards","icon":"gift","href":"/offerings/gift-cards"},{"title":"Organise the catalogue with categories","icon":"tags","href":"/offerings/categories"}]},{"group":"Finance","icon":"receipt","tag":"NEW","expanded":false,"pages":[{"title":"Overview","icon":"receipt","href":"/finance/overview"},{"title":"Create and send an invoice","icon":"file-invoice-dollar","href":"/finance/invoices"},{"title":"Orders","icon":"bag-shopping","href":"/finance/orders"},{"title":"Connect a payment gateway","icon":"credit-card","href":"/finance/payments-and-gateways"},{"title":"Collect bank transfers in chat","icon":"building-columns","href":"/finance/pay-with-transfer"},{"title":"Subscriptions","icon":"arrows-rotate","href":"/finance/subscriptions"},{"title":"Statements","icon":"scroll","href":"/finance/statements"},{"title":"Coupons and loyalty","icon":"tag","href":"/finance/coupons"},{"title":"Record expenses","icon":"receipt","href":"/finance/expenses"},{"title":"Set your Finance defaults","icon":"gear","href":"/finance/settings"}]},{"group":"Reputation","icon":"star","tag":"NEW","expanded":false,"pages":[{"title":"Reputation overview","icon":"star","href":"/reputation/overview"},{"title":"Connect Google Business Profile","icon":"google","href":"/reputation/connect-google-business-profile"},{"title":"Read and reply to Google reviews","icon":"star","href":"/reputation/reviews"},{"title":"Ask for Google reviews","icon":"paper-plane","href":"/reputation/review-requests"},{"title":"Publish posts and read performance","icon":"bullhorn","href":"/reputation/posts-and-performance"}]}]},{"group":"Workspace","pages":[{"group":"Analytics \u0026 reports","icon":"chart-line","expanded":false,"pages":[{"title":"Overview","icon":"chart-line","href":"/analytics/overview"},{"title":"Conversation reports","icon":"chart-line","href":"/analytics/conversation-reports"},{"title":"Collect customer satisfaction scores","icon":"face-smile","href":"/analytics/csat"},{"title":"Read the team performance report","icon":"user-clock","href":"/analytics/team-performance"},{"title":"Read the finance report","icon":"coins","href":"/analytics/finance-report"},{"title":"Read the pipeline report","icon":"filter","href":"/analytics/pipeline-report"},{"title":"Read the ads report","icon":"rectangle-ad","href":"/analytics/ads-report"},{"title":"Export your data","icon":"file-export","href":"/analytics/exporting-reports"}]},{"group":"Account \u0026 workspace","icon":"gear","expanded":false,"pages":[{"title":"Manage your profile","icon":"user","href":"/account/profile"},{"title":"Set your business details","icon":"building","href":"/account/business-details"},{"title":"Set how conversations behave","icon":"comments","href":"/account/conversation-settings"},{"title":"Invite and manage team members","icon":"users","href":"/account/team-members"},{"title":"Control what your team can do","icon":"user-shield","href":"/account/roles-and-permissions"},{"title":"Set up notifications","icon":"bell","href":"/account/notifications"},{"title":"Custom media storage","icon":"database","href":"/account/custom-storage"},{"title":"Secure your account","icon":"shield-halved","href":"/account/security"},{"title":"Read the workspace audit log","icon":"clock-rotate-left","href":"/account/audit-log"}]},{"group":"Billing","icon":"credit-card","expanded":false,"pages":[{"title":"Choosing a plan","icon":"scale-balanced","href":"/billing/choosing-a-plan"},{"title":"How plans work","icon":"credit-card","href":"/billing/plans"},{"title":"Change your plan","icon":"arrows-up-down","href":"/billing/upgrading-downgrading"},{"title":"Buy add-ons","icon":"cart-plus","href":"/billing/add-ons"},{"title":"Pay for DMLY","icon":"credit-card","href":"/billing/payment-methods"},{"title":"Cancel your subscription","icon":"circle-xmark","href":"/billing/cancelling"}]},{"group":"Integrations","icon":"puzzle-piece","expanded":false,"pages":[{"title":"Overview","icon":"puzzle-piece","href":"/integrations/overview"},{"title":"Connect Claude","icon":"wand-magic-sparkles","href":"/integrations/claude"},{"title":"Connect OpenAI","icon":"robot","href":"/integrations/openai"},{"title":"Build a knowledge base","icon":"book","href":"/integrations/knowledge-base"},{"title":"Connect Shopify","icon":"shopify","href":"/integrations/shopify"},{"title":"Connect WooCommerce","icon":"wordpress","href":"/integrations/woocommerce"},{"title":"Connect Zapier","icon":"bolt-lightning","href":"/integrations/zapier"},{"title":"Connect n8n","icon":"diagram-project","href":"/integrations/n8n"},{"title":"Connect Zoom","icon":"video","href":"/integrations/zoom"},{"title":"Connect Mercado Pago","icon":"credit-card","href":"/integrations/mercado-pago"},{"title":"Connect Monnify","icon":"credit-card","href":"/integrations/monnify"},{"title":"Connect Flutterwave","icon":"credit-card","href":"/integrations/flutterwave"},{"title":"Connect Meta Conversion Leads","icon":"chart-line","href":"/integrations/meta-conversion-leads"},{"title":"Import from Google Drive","icon":"google-drive","href":"/integrations/google-drive"}]},{"group":"Agency \u0026 whitelabel","icon":"building","tag":"NEW","expanded":false,"pages":[{"title":"Agency overview","icon":"building","href":"/agency/overview"},{"title":"Brand DMLY as your own","icon":"palette","href":"/agency/branding"},{"title":"Client workspaces","icon":"users","href":"/agency/client-workspaces"},{"title":"Price and bill your clients","icon":"credit-card","href":"/agency/plans-and-billing"},{"title":"Build automation packs for your customers","icon":"boxes-stacked","href":"/agency/automation-packs"},{"title":"Connect Stripe","icon":"stripe","href":"/agency/connect-stripe"},{"title":"Connect your agency domain","icon":"globe","href":"/agency/custom-domain"},{"title":"Your own branded mobile app","icon":"mobile-screen","href":"/agency/branded-mobile-app"}]}]},{"group":"Compliance","icon":"shield-halved","pages":[{"title":"Data storage and security","icon":"lock","href":"/compliance/data-security"},{"title":"Privacy and data protection","icon":"scale-balanced","href":"/compliance/privacy"}]},{"group":"Troubleshooting","pages":[{"title":"Automation not triggering","icon":"bolt","href":"/troubleshooting/automation-not-triggering"},{"title":"Fix a message that didn't send","icon":"triangle-exclamation","href":"/troubleshooting/messages-not-sending"},{"title":"Known issues","icon":"circle-exclamation","href":"/troubleshooting/known-issues"},{"title":"Reading the Logs page","icon":"clipboard-list","href":"/troubleshooting/logs"}]}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Agency API","icon":"building","pages":[{"title":"Agency API","href":"/api-reference/agency-introduction"}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},"basePath":"","title":"Migrate to DMLY - DMLY","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}