Skip to main content
Subscriber Manager is where every contact who has messaged your WhatsApp bot is stored, labeled, and managed. From here you can view subscriber details, organize them with labels, import existing contacts in bulk, and run bulk actions like assigning a label or sequence to many subscribers at once.

​
The subscriber list

Go to WhatsApp → Subscriber Manager to see every subscriber for the selected bot: their Phone Number, Subscriber ID, Name, Updated at, and Subscribed at. Filter the list by Label, Status, Sequence, or a free-text search.
WhatsApp Subscriber Manager list showing subscriber rows with filters for bot, label, status, and sequence

​
Labels and Custom Fields

The Manage dropdown opens Manage Labels and Manage Custom Fields — the two ways to structure subscriber data beyond the built-in fields.
Manage dropdown menu with Manage Labels and Manage Custom Fields options
Labels group subscribers into segments (e.g. Lead, VIP Customer, Demo Requested) that you can filter by, target in broadcasts, or trigger automations from.
WhatsApp Subscriber Labels list with a Create button
1

Click Create

From the Labels list, click Create.
2

Name the label

Enter a Label Name, e.g. batch1.
3

Select the bot

Choose which bot the label belongs to.
4

Save

Click Save — the label is now available to assign to subscribers.
Create label modal with Label Name and Select Bot fields

​
Subscriber actions (Options menu)

The Options dropdown on the subscriber list provides everything you can do to one or many subscribers at once: Download(all) as CSV, Import Subscribers, Create Subscriber, Assign Label, Remove Label, Assign Sequence, and Delete Subscriber.
Options dropdown showing Download(all) as CSV, Import Subscribers, Create Subscriber, Assign Label, Remove Label, Assign Sequence, and Delete Subscriber

​
Create a single subscriber

Options dropdown with Create Subscriber highlighted
Use Create Subscriber to add one subscriber manually, without them having to message the bot first.

​
Import Subscribers in bulk

Options dropdown with Import Subscribers highlighted
Click Import Subscribers to bring in existing contacts three ways:
  • Upload File (CSV) — upload a CSV file (a Sample CSV link shows the expected format).
  • Import from Google Sheet — connect a Google Sheet directly (+ Add Google Sheet).
  • Import from Google Contacts — import from a connected Google account.
Import Subscribers modal with Upload File, Import from Google Sheet, and Import from Google Contacts options
A CSV/sheet needs at minimum a phone number and name column, e.g.:
phone_numbername
8801710000000whatsappSub_1
8801720000000whatsappSub_2
Format the phone number column as plain numbers or text before exporting to CSV — Excel often displays long phone numbers in scientific notation (e.g. 8.8E+12 instead of 8801710000000), and a CSV exported in that state will import garbled or truncated numbers.
Excel spreadsheet with phone_number column showing scientific notation like 8.8E+12
Fix it in Excel with right-click → Format Cells on the column (set it to Number or Text) before saving as CSV:
Excel right-click context menu with Format Cells highlighted on the phone_number column
Excel spreadsheet with phone_number column showing correctly formatted full phone numbers
After uploading, map each column from your file to a ChatSyncs field:
Sample Data of Uploaded CSV/Google-Sheet modal mapping File Header columns to Data Fields, with a Map Data button
Any extra column beyond phone number and name is treated as a custom field — if the subscriber already exists, that custom field is updated or added; if not, a new subscriber is created with it.

​
Bulk actions on existing subscribers

Select subscribers with the checkboxes on the left of each row, then use the Options menu to act on all of them at once.

​
Assign or remove a label

Subscriber list with checkboxes selected and Assign Label, Remove Label highlighted in the Options dropdown

​
Assign a sequence

Subscriber list with sequence toggles on and Assign Sequence highlighted in the Options dropdown
Use Assign Sequence to enroll selected subscribers into a Sequence without needing them to trigger it from a Bot Reply.

​
Page size

For large subscriber lists, change how many rows are shown per page (10, 25, 50, 100, 200) from the dropdown at the bottom left.
Subscriber list pagination control with page size dropdown open, showing options 10, 25, 50, 100, 200

​
Frequently asked

Subscriber Manager lists every subscriber for the selected bot, with their phone number, subscriber ID, name, and when they last updated or first subscribed.
Use Options → Import Subscribers, then upload a CSV, connect a Google Sheet, or import from Google Contacts. Map each column to a ChatSyncs field (Phone Number, Subscriber Name, or a custom field) before confirming the import.
Excel often displays long phone numbers in scientific notation (8.8E+12). Format the phone number column as Number or Text (right-click → Format Cells) before saving the file as CSV, or the import will bring in the garbled value.
Create a Label under Manage → Manage Labels, then select subscribers in the list and use Options → Assign Label (or Remove Label to undo it). You can then filter the subscriber list by that label, or target it in a broadcast.
Yes — select one or more subscribers and use Options → Assign Sequence to enroll them directly, instead of relying on a Bot Reply action.
  • Scientific notation breaks phone number imports — always format the phone column as Number or Text in Excel/Sheets before exporting to CSV.
  • Extra CSV columns become custom fields automatically — double-check column headers match what you intend, since any unmapped column still gets imported as a custom field.
  • Deleting a subscriber is permanent — there’s no undo for Delete Subscriber.