Reach out
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.
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.
What a list is for
Section titled “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: the person clicks and writes first;
- a form: 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.
Import a list
Section titled “Import a list”- Open Lists and click Import a list.
- Origin: answer Who are these contacts? and click Continue. The next section details the answers.
- 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.
- Columns: check what each column is. The column of phone numbers must read WhatsApp number. Click Continue.
- Contacts: untick the countries you do not want, pick the country of the numbers written without a country code, and type the List name.
- 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.
- 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
Section titled “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.
Which files you can import
Section titled “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
Section titled “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.
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
Section titled “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. |
| 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
Section titled “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,00447700900123or447700900123), 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.
Why some rows are left out at import
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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.
Why a list sends less than its pace: your number’s ceiling
Section titled “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.
Warm up a number at the start of a list
Section titled “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
Section titled “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
Section titled “Start sending a list”- Open Lists and click your list. On Summary, check the four lines: Contacts, Who writes, Message, Sending. Each has a button to change it.
- Click Start sending, the green button at the top.
- 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.
- 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
Section titled “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, 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
Section titled “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
Section titled “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
Section titled “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)
Section titled “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.
See the contacts of a list and what their status means
Section titled “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
Section titled “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
Section titled “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
Section titled “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. |
| The agent is paused | Resume it in 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
Section titled “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.
Add contacts to an existing list
Section titled “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
Section titled “Keep a list open for contacts you add later”When one list grows over time, by hand or from your CRM through the API, 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
Section titled “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 has its own export for the people your agents talk to.
Delete a list
Section titled “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
Section titled “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.