# Lists & import

> Import contacts from a file, a Google Sheets link or a paste, choose who writes and at what pace, then follow the list until everyone is reached.

Source: https://docs.whatsetter.com/dashboard/lists/

A list is a batch of contacts your agent writes to first. You import it,
choose the agent, the first message and the pace, then start sending. Replies
land in [Conversations](/dashboard/conversations/).

## What a list is for

Open **Lists** in the menu, under **Reach out**. A list is a file of contacts
that your agent writes to first: one first message per person, at the pace
you choose. It is one of three ways a contact reaches an agent:

- a list: you bring the contacts, the agent writes first;
- a [link](/dashboard/tracked-links/): the person clicks and writes first;
- a [form](/dashboard/forms/): the person leaves a number, the agent writes first.

Importing sends nothing. A list sends only after you click **Start sending**.
To push contacts from your own tools instead of a file, see
[API: lists and import](/developers/guides/lists-import/).

> **Warm leads only**
Import people who already know you: customers, people who filled a form,
people you already spoke with. Cold outreach puts your WhatsApp number at
risk. See [How we protect your number](/dashboard/anti-ban/).

## Import a list

1. Open **Lists** and click **Import a list**.
2. **Origin**: answer **Who are these contacts?** and click **Continue**. The next section details the answers.
3. **File**: drop an Excel or CSV file, or click **Choose a file**. Two other tabs take a **Google Sheets** link or a **Paste** of rows.
4. **Columns**: check what each column is. The column of phone numbers must read **WhatsApp number**. Click **Continue**.
5. **Contacts**: untick the countries you do not want, pick the country of the numbers written without a country code, and type the **List name**.
6. **Message**: keep the agent's own first message, or choose another one for this list. This step shows on a new list when per-list messages are available on your account.
7. Click the import button, for example **Import 120 contacts**, and keep the window open until the end.

The list opens on its **Summary** tab. If the import stops halfway, click
**Resume**: it picks up where it stopped.

## Say who a list's contacts are

The first step of importing a new list, **Origin**, asks **Who are these
contacts?** You answer it to move on to the file.

| Answer | What happens |
|---|---|
| **My customers or past customers** | The list is imported. The window shows a first message as your contact will read it. |
| **People who gave me their number** | A form, an ad, a trade show, a meeting, a business card. The list is imported the same way. |
| **Contacts who don’t know me** | A bought, shared or scraped file, marked **Risky**. The window warns that this is what gets numbers banned the most, and you must tick the "I take the risk" box to continue. |

For contacts who don't know you, the window gives three tips: a dedicated
number, never your personal one; a short first message, with your name, how
you got the contact, a real question and "reply stop"; and letting your
number climb slowly. It offers better: **A WhatsApp link** or **A form**, so
people write to you first.

A list imported before this question asks it once, in the **Launch sending**
window. When a list of contacts who don't know you goes out from your
personal number, that window says so again. Contacts added to an existing
list follow the list's answer. See
[How we protect your number](/dashboard/anti-ban/).

## Which files you can import

Open **Lists**, then **Import a list**. The first step accepts three sources:

| Source | What it takes |
|---|---|
| **File** | An Excel file (.xlsx, .xls) or a text file (.csv, .tsv, .txt). Commas, semicolons, tabs and pipes are recognised as separators. |
| **Google Sheets** | The link of the sheet, shared with "Anyone with the link". |
| **Paste** | Rows copied from a spreadsheet, a note or a chat, one contact per line. |

A file without a title row is accepted: its columns are called A, B, C, and
the switch **The first row holds the titles** corrects the guess. An Excel
file with several sheets opens on the one with the most rows: change it with
**Sheet**.

A file of more than 5,000 rows (6,000 on the Scale plan) is refused with
"This file is too big. Split it into several lists."

## How many contacts a list can hold

In **Lists**, the number of contacts one list can hold depends on your plan.
The limit applies at import and when you add contacts later:

| Plan | Contacts per list |
|---|---|
| Free plan | 100 |
| Starter | 500 |
| Business | 1,000 |
| Scale | 5,000 |

The first step of the import shows your limit. Over it, the **Contacts** step
says "Your plan allows 500 contacts per list. Remove some rows, or upgrade
your plan." (with your own limit) and the import button stays greyed out.
Remove rows, split the file into several lists, or change plan in
[Subscription](/dashboard/billing/).

A team can keep 200 lists. Beyond that, the import answers "You've reached the
maximum number of lists. Delete an old list to import a new one."

On the free plan you can import a list, but an agent writes to your contacts
only once you have picked a plan.

## Say what each column of your file is

In the import window of **Lists**, step **Columns**, each column of your file
is one line: its name, some of its values, and a menu under **It is**.
WhatSetter fills the menus for you. Change any wrong guess.

| Choice | What it does |
|---|---|
| **WhatsApp number** | The number the agent writes to. Required. |
| **First name** | How the agent greets the person. |
| **Last name** | Used with the title: when a contact has a title, the agent greets them with the title, the first name and the last name. Without a title, it uses the first name only. |
| **First and last name** | One column with both: the first name is taken out of it. |
| **Title (Mr, Ms)** | The form of address, for example Herr or Mrs. |
| **Email** | Kept on the contact. |
| **Information** | Anything the agent may use: city, company, product. Name it under **Name for the agent**. |
| **Do not import** | The column is left out. |

Identifiers, dates, links and empty columns start on **Do not import**, and at
most 12 columns start on **Information**, which replaces the former "Custom
Variable". The right side previews one real contact as the agent will know
it.

## Which phone numbers are accepted in a list

In the import window of **Lists**, the column set to **WhatsApp number** can
be written any way: spaces, dots, dashes and brackets are ignored.

- With a country code (`+44 7700 900123`, `00447700900123` or `447700900123`), the number is read as written.
- Without one (`07700 900123`), the number is read in the contact's own country when the file has a country column. Otherwise the **Contacts** step counts the numbers without a country code and lets you pick their country.
- When a cell holds two numbers, the first is kept. When the main column is empty on a row, another phone column of the file is used.
- A value with fewer than 6 digits is not a number.

Numbers are checked on WhatsApp later, when each message is about to leave,
not at import.

> **Numbers damaged by Excel**
A number shown as `3,36E+10` has lost its last digits. Set the column to Text
format in Excel, save, then import again.

## Why some rows are left out at import

In the import window of **Lists**, step **Contacts**, the **Summary** on the
right counts the contacts to import and, under **Left out**, the rows that
stay out:

| Line | Meaning |
|---|---|
| **Numbers damaged by Excel** | Excel turned the number into a form like `3,36E+10` and its digits are lost. |
| **Unreadable numbers** | The value is not a phone number. |
| **Lines without a number** | The phone cell is empty. |
| **Duplicates** | The same number appears twice in the file. The first row is kept. |
| **Removed countries** | The number belongs to a country you unticked. |

Click **Download these rows** to get them as a CSV file with a **Reason**
column. Fix them, then bring them in with **Add contacts** on the list:
numbers already in the list are skipped.

## Read the page of a list: its four tabs

Open **Lists** and click a list. The top shows its name, its status, one
sentence on where it stands and the one button that matters now:
**Start sending**, **Pause**, **Resume**, or **Add contacts** on a finished
list. **More actions** holds **Add contacts**, **Export as CSV**, **Rename**
and **Delete list**.

| Tab | What you do there |
|---|---|
| **Summary** | Before the start: four lines to check. After: today's sends, replies and meetings. |
| **Contacts** | See each person and where they stand, search, exclude someone. |
| **Message** | Choose what the contacts receive first. |
| **Sending** | Choose who writes, how many messages a day, on which days and hours, and whether the list stays open. |

Click the name of the list to rename it.

## What each list status means

On the **Lists** page and at the top of a list, one status says where the
list stands:

| Status | Meaning |
|---|---|
| **Importing** | The contacts are still coming in. |
| **Ready** | Imported, not started. Nobody received a message. |
| **Never started** | Imported more than 30 days ago and never started. |
| **Sending** | The agent is writing now, inside your time slots. |
| **Scheduled** | Started, but outside your time slots, or today's messages are all sent. It resumes at the next slot. |
| **Blocked** | No agent of the list can write right now. It resumes as soon as one of them can write again. |
| **Paused** | You paused it. |
| **Finished** | Every contact got a first message or was set aside. |

Lists that need you come first. Finished lists fold under **Finished**: click
**Show**.

## Choose the first message of a list

Open **Lists**, click your list, then the **Message** tab. Under
**First message**, pick one of three choices:

- The agent's own message, for example **Julia's message**: its usual first message, written for each contact from its prompt. This is the default.
- **Instructions for this list**: say what these contacts have in common and what to offer. The agent writes each message following them, in its own voice.
- **A message you write**: each contact receives your text with their own details. 2,000 characters at most.

The choice saves by itself (**Saved** appears) and applies to the next sends,
also on a list that is already sending. Click **See 3 examples** to read the
message for three real contacts: nothing is sent, and examples written by the
agent use your AI credits.

When the agent's first message has an A/B test, each example is written with
the next version your contacts receive (published and in the test, never a
draft) and says which one, for example **Version A**. Click again to go on with
the next versions. Under each example, a line says what the agent was given to
greet the person: **Uses the first name only**, or, when the contact has a
title, the title, first name and last name columns.

If the page says "Per-list messages are not available on your account yet.",
only the agent's own message can be used for now. If it says "Saved. This
choice will apply to sends as soon as per-list messages are switched on for
your account.", your choice is kept but not applied yet.

## Write your own message with each contact's details

Open **Lists**, click your list, then the **Message** tab, and choose
**A message you write**. Type the message, then click a name next to
**Insert** to place a column of the list in it: first name, city, company.
Each contact receives the text with their own values.

- **Vary the wording slightly** is on by default: the agent changes a few words so that no two contacts receive the same text, which is safer for your number. Off, the message leaves as written.
- When a contact has no value for a column you used, the agent adapts the sentence. A blank is never sent.
- A figure such as 81/93 on a column means 81 of the 93 contacts have a value.

The same **Insert** names work under **Instructions for this list**. These
details are used for the first message only: replies rely on the
conversation.

## Choose who writes: one agent or several

Open **Lists**, click your list, then the **Sending** tab. Under
**Who writes**, pick the agent that writes to these contacts. It writes from
its own WhatsApp number. Agents were called campaigns before.

- Only active agents can be picked. Paused agents and drafts are folded at the bottom of the list of agents.
- Each line says if the agent can write now: **Connected** and its number, or the reason it cannot. **Open the agent** takes you to it.
- To split the list, turn on **Share between several agents** and tick the agents: contacts are shared between them, each at its own pace. The switch shows when you have more than one active agent.
- Agents that follow groups are not offered.

Before the start, the choice saves as you go. On a list that is sending, a
change applies to the next sends, and conversations already started stay with
their agent.

## Set how many first messages leave each day

Open **Lists**, click your list, then the **Sending** tab. Under **Pace**, the
cursor sets the number of first messages per agent per day, from 1 to 40. It
starts on 20, the recommended value.

| Per agent, per day | What the page says |
|---|---|
| 1 to 10 | Best for a new or rarely used number. |
| 11 to 20 | The right balance for most numbers. |
| 21 to 40 | Above 20 a day, WhatsApp may limit a recent number. |

With several agents, the day's total is the pace times the number of agents:
20 a day with 3 agents makes 60 first messages a day. If the same agents
already write for other lists, the page warns you when the total passes 40
per agent.

The real count varies a little from day to day, and numbers without WhatsApp
are skipped. More in [How we protect your number](/dashboard/anti-ban/).

## Why a list sends less than its pace: your number's ceiling

Open **Lists**, click your list, then the **Sending** tab. Under **Pace**,
**Your number’s ceiling** shows one line per number of the list's agents: how
many first messages this number may send to new contacts today, all its lists
and cold follow-ups together.

- "Today 20 first messages at most, for all your lists. This one fits.": the list's pace fits under the ceiling.
- "This list asks for 20 a day: your number will send 5 today, its shared ceiling. It rises when people answer.": the list isn't at fault, the number sends its ceiling.
- The number is paused, or WhatsApp limits it: the line says so, and the list waits.
- "Tell us what this number is: its ceiling depends on it.": the number was connected before the question **Which number are you connecting?**

Each line also shows the number's state and its ladder. Click it to open its
panel in **WhatsApp numbers**. The same ceiling shows in the
**Launch sending** window. It starts at 5 first messages a day for a
dedicated number, 10 for your personal number, and rises on its own with the
number's age and its answers: no setting raises it by hand. See
[WhatsApp numbers](/dashboard/numbers/).

## Warm up a number at the start of a list

Open **Lists**, click your list, then the **Sending** tab. Under **Pace**,
**Warm-up** is on by default: the list starts low and climbs to the full pace
over 5, 7, 10 or 14 days (7 by default). The first day sends 15 % of the daily
number, then a little more each day.

Example: 20 first messages a day with a warm-up over 7 days. The page reads
"3 on day one, 20 from day 7."

Turn **Warm-up** off to send the full pace from day one. Keep it on for a
number that is new or that has not written much. The **Expected end** shown
lower on the page takes the warm-up into account.

## Set the sending days, hours and time zone

Open **Lists**, click your list, then the **Sending** tab, section **Hours**.

- **Days**: click the days when messages may leave. Monday to Friday by default. At least one day is needed.
- **Time slots**: pick **Morning and afternoon** (9:00 to 12:00 and 14:00 to 18:30, the default), **All day** (9:00 to 18:00) or **Late afternoon** (17:00 to 20:30), or drag the ends of a slot on the line of the day, by half-hours. **Add a time slot** adds one, up to 4.
- **Time zone**: the hours are read in this time zone. It starts on the agent's own.

**Expected end** shows the estimated last day and a calendar of the sending
days.

Before the start, every change saves by itself. On a list that is sending,
click **Save** at the bottom to apply your changes, or **Cancel**.

## Start sending a list

1. Open **Lists** and click your list. On **Summary**, check the four lines: **Contacts**, **Who writes**, **Message**, **Sending**. Each has a button to change it.
2. Click **Start sending**, the green button at the top.
3. Read the recap: how many people will be written to, who is set aside and why, the pace, the warm-up, the expected end, the message and the number's ceiling. A list imported before the question **Who are these contacts?** asks it here, once.
4. Click **Start sending** again to confirm.

The agent begins writing in the next time slot, and the status becomes
**Sending** or **Scheduled**. First messages leave little by little inside
your time slots, never all at once. Nobody receives anything before you
confirm, and you can pause at any time. This button replaces the former
"Configure & Launch" wizard.

## Why the Start sending button is greyed out

Open **Lists** and click your list. **Start sending** is greyed out in three
cases. Hover over it to read which one:

- "First pick the agent who will write to this list": no agent is chosen. Open the **Sending** tab.
- "There's nobody left to contact in this list": every contact was set aside or already written to. Open **Contacts**, view **Set aside**.
- "The agent's number must be connected to start": none of the chosen agents can write now. Reconnect the number in [WhatsApp numbers](/dashboard/numbers/), or pick another agent.

In the recap window, the confirm button also stays greyed out while the list
is being checked, and when the recap says "Per-list messages are not switched
on for your account yet." In that case, go back to the **Message** tab and
choose the agent's own message.

## Pause and resume a list

Open **Lists**, click your list, then click **Pause** at the top. No more
first messages leave. Conversations already started carry on: the agent keeps
answering the people it wrote to. The status becomes **Paused**, and the
contacts not yet written to wait.

Click **Resume** to start again where the list stopped. On the **Lists**
page, a paused list also has a **Resume** button on its line. **Resume** is
greyed out when nobody is left to contact.

You do not need to pause to change the pace, the hours or the agents: edit
them in the **Sending** tab while the list runs.

## Follow how a list is going

Open **Lists** and click a list that has started: it opens on **Summary**.

- **Today**: the first messages sent today out of today's number, and what happens now ("Writing now", or the time of the next send).
- **Where the list stands**: **Contacted** out of the total, **Replied** and the share of those contacted, **Qualified** by your agent, **Meetings booked**. Click **Contacted** or **Replied** to see those people.
- **List settings**: the four lines (contacts, who writes, message, sending), each with its button.

On the **Lists** page, each list that has started shows a progress bar. The
top of the page reads, for example, **today, all lists: 12 sent out of 40**:
the first messages sent today, against the quota of today of the lists that
are sending or scheduled. The quota of a list is its pace times the number of
its agents, at the step of the warm-up it has reached, and lower when one of
its agents cannot write. "Today" is the UTC day, the one the sending follows.

## People your team already wrote to are set aside

The rule is written on the **Lists** page: nobody gets two first messages. A
contact that any agent of your team already wrote to is set aside, whatever
the list.

The same goes for someone who already talks with your team without having
received a first message: they wrote to an agent on their own, after an ad for
example, or someone of the team answered them by hand. They are set aside even
with re-engagement on: nobody already in a conversation gets a first message.

- At import, the **Contacts** step tells you how many people already received a message from your team, and how many already talk with it.
- Before the start, in the **Contacts** tab, they stay under **To contact** with the status **Already contacted** or **Already talking with**, and the name of the agent.
- At the start they leave the queue: the recap counts them and they move to the **Set aside** view. They use none of the day's messages.

They are not deleted, and you can still open them. To write again to people
already contacted, turn on **Re-engagement** in the **Message** tab of the
list.

The check is made on the phone number. In rare cases WhatsApp hides a
person's number from your agent: WhatSetter then can't recognize them in a
list.

## Write again to people already contacted (re-engagement)

Open **Lists**, click your list, then the **Message** tab. When the list holds
people your team already wrote to, a section **Already contacted** offers two
choices:

- **Don't write to them**: recommended, and the default. They stay visible under **Set aside**.
- **Re-engagement**: one message that refers back to the earlier one and gives this list's reason.

Re-engagement follows strict rules. It never goes to someone who replied. It
is sent by the agent that wrote first, and only if no other agent wrote to
that person. A person gets 2 unanswered attempts at most, first message
included. You choose the minimum delay since the last message: 14, 30, 60 or
90 days (30 by default). No follow-up is sent after it.

If the choice reads "Coming soon to your account", re-engagement is not
active for you yet. Re-engagement was called "Re-contact already-messaged
leads" before.

> **Re-engagement raises the risk for your number**
Only write again to people who know you and will not report you as spam.

## See the contacts of a list and what their status means

Open **Lists**, click your list, then the **Contacts** tab. The views at the
top filter people: **To contact**, **Set aside**, **All**, plus **Contacted**
and **Replied** once the list has started. The search finds a name, an email
or the digits of a number.

| Status | Meaning |
|---|---|
| **To contact** | Waiting for a first message. |
| **Contacted** | The first message was sent. |
| **Replied**, **Qualified**, **Meeting booked**, **Not interested**, **Stopped**, **Waiting** | Where the conversation stands. |
| **Already contacted** | Your team had written to them, or was already talking with them, before this list. |
| **Not on WhatsApp** | The number has no WhatsApp account. |
| **Invalid number** | The number is not valid. |
| **Excluded** | You took this person out. |
| **Send failed** | The first message could not be sent. |

Click a line to open the contact: where things stand, the messages
exchanged, what your file says, and **Open conversation**.

## Exclude a contact from a list, or put one back

Open **Lists**, click your list, then the **Contacts** tab.

- One person: click the line, then **Exclude from sending** at the bottom of the panel. The person will not get a message.
- Several people: tick the lines, then click **Exclude from sending** in the bar that appears.
- To undo: open the **Set aside** view, tick or open the person, and click **Put back in sending**.

Only people still waiting for their first message can be excluded. A contact
that was written to, a person already contacted or a number without WhatsApp
keeps its status. Excluding deletes nothing: the contact stays in the list
with the status **Excluded**.

## If one of the agents of a list cannot write

In **Lists**, a list shared between several agents keeps going when one of
them cannot write: its number is disconnected, the agent is paused, WhatsApp
limits the number, or its first messages are on hold.

- Its contacts go to the agents that can write.
- The day's total goes down in proportion: each agent keeps the number of first messages planned for it per day, never more. That is what protects the numbers.
- When the agent can write again, it takes its place back, at its own pace.
- If no agent can write, the list shows **Blocked** and resumes as soon as one of them can write again.

Example: 5 agents at 5 first messages a day each, 25 a day. One number drops:
the 4 others take its contacts and the list sends 20 a day. The **Sending**
tab and the top of the list say so.

With **Re-engagement** on, a contact waits for the agent that already wrote
to it instead of moving to another one.

## Why a list shows Blocked

On the **Lists** page, a list is **Blocked** when none of its agents can
write. Open it: the sentence under its name says why.

| The sentence says | What to do |
|---|---|
| The agent's number is disconnected, or a QR code must be scanned | Click the button at the top, for example **Reconnect Julia**, and reconnect the number. |
| The agent has no WhatsApp number | Connect one in [WhatsApp numbers](/dashboard/numbers/). |
| The agent is paused | Resume it in [Agents](/dashboard/agents/), or pick another agent in **Sending**. |
| WhatsApp is blocking new contacts for the agent for now | Wait: the list resumes when WhatsApp lifts the limit. |
| The agent reached its message cap, or its first messages are on hold | Wait: the list resumes by itself. |
| The agent of the list no longer exists | Pick another agent in the **Sending** tab. |

The contacts keep waiting and none is lost. You can also click **Pause**
meanwhile.

## Why a list sends nothing

Open **Lists** and read the status of the list:

- **Ready** or **Never started**: it was never started. Open it and click **Start sending**.
- **Scheduled**: it is outside its days or time slots, or today's number is reached. The sentence under its name says when it resumes.
- **Blocked**: no agent can write. Do what the sentence says, for example reconnect the number.
- **Paused**: click **Resume**.
- **Finished**: nobody is left. Open **Contacts**, view **Set aside**, to see who was not written to and why.

A list that reads **Sending** can still send little. With **Warm-up** on, the
first days send less: 3 on day one for 20 a day. The number has its own daily
ceiling, shared with your other lists and your forms: it starts at 5 or 10
first messages a day, rises with the number's age and its answers, and stops
for a few days if almost nobody answers. The **Sending** tab shows it under
**Your number’s ceiling**. And when your plan's
messages for the month are used up, or the account is suspended after a
failed payment, first messages wait: check
[Subscription](/dashboard/billing/).

## Add contacts to an existing list

Open **Lists**, click your list, click **More actions** (the button with three
dots), then **Add contacts**. The import window opens with three steps: file,
columns, contacts.

- Numbers already in the list are skipped, so you can import a corrected or longer version of the same file.
- The new contacts keep the column names of the list, so the details used in your message still work.
- Your plan's limit applies to the whole list: the contacts already there plus the new ones.
- On a list that is sending, the new contacts join the queue. On a **Finished** list, the status goes back to **Paused**: click **Resume** to write to them. If the list is kept open, it sends to them at once.

## Keep a list open for contacts you add later

When one list grows over time, by hand or from your CRM through the
[API](/developers/guides/lists-import/), keep it open: open the list, then
**Sending**, and switch on **Keep the list open** under **After the last
contact**. It is off by default and saves at once.

- Switched on: once everyone is contacted, the list reads **Finished**, followed by **Open: contacts you add will go out on their own**. Contacts you add later go out on their own, with the same agents, pace, hours and daily limit. No need to click **Resume**.
- Switched off: once everyone is contacted, the list is **Finished**. Contacts added afterwards wait for **Resume**.
- A list you paused yourself stays paused, open or not.

## Export the contacts of a list

Open **Lists**, click your list, click **More actions**, then
**Export as CSV**. The file downloads at once, named after the list. It holds
every contact of the list, whatever view you are on, with these columns: the
name, the phone number, the status (the same words as in the **Contacts** tab)
and every column of your file.

Use it to keep a copy before deleting a list, or to read in a spreadsheet who
replied and who was set aside. [Leads](/dashboard/leads/) has its own export
for the people your agents talk to.

## Delete a list

Open **Lists**, click your list, click **More actions**, then **Delete list**.
A window says what goes and what stays:

- The list, its contacts and its sending settings are deleted. If the list was sending, no more first messages leave.
- Conversations already started stay in **Conversations** and **Leads**.

Click **Delete** to confirm. From 50 contacts up, you first type the name of
the list. A deleted list cannot be restored: export it first if you need the
file.

People the list already wrote to stay known to your team. If they appear in a
later list, they are set aside like anyone already contacted.

## Who can see and manage lists

The **Lists** entry of the menu and its pages show only for people who have
the right **Import, edit and delete lists**. **Owner**, **Admin** and
**Editor** have it. **Responder** and **Viewer** do not.

The same right is needed to import a list, start it, pause it, change its
settings and delete it. A person without it does not see **Lists** at all.

Roles and rights are set in [Team](/dashboard/team/).

## Related

- [Tracked links](/dashboard/tracked-links/)
- [Forms](/dashboard/forms/)
- [How we protect your number](/dashboard/anti-ban/)
- [API: lists and import](/developers/guides/lists-import/)
