Product guides

Number verification

Check which phone numbers in a list are registered on WhatsApp before you send a campaign to them. You upload a spreadsheet, Wbiztool checks each number from your connected WhatsApp number, and you download the results.

Verification doesn't send anything to the numbers and doesn't use your message credits.

Before you start#

A plan that includes number verification. Your plan also sets how many numbers one file can contain.
At least one WhatsApp number connected on WhatsApp settings. The checks run from it, so numbers stay Pending while no number is connected.
You must be an owner or editor of the workspace to upload files and download results.
A CSV or Excel file with the numbers, including their country codes.

Prepare your file#

File types: .csv, .xlsx or .xls.
Header row: the first row must contain column names. It's never checked as a number.
Phone column: the first column whose header contains phone, number, mobile, whatsapp or contact (in any letter case) is used. If no header matches, the first column is used.
Country code: include it, for example 919876543210. No country code is added for you.
Formatting: +, spaces, dashes and brackets are removed, and one leading 0 is dropped. Anything after a decimal point is dropped (919876.5 becomes 919876). Numbers in scientific notation, such as 9.19877E+11, and cells with other characters are skipped. Format the phone column as text.
Duplicates: repeated numbers are removed, so each number is checked once.

The Format Guidelines window lists (555) 123-4567 as a valid format, but that number has no country code and will be checked as the wrong number. Always include the country code.

An example CSV:

Name,Phone
Aman,919876543210
Priya,+91 98765 43211
Leo,14155550123

Verify a list#

Open Number Verification
In the sidebar, open Tools and click Number Verification, or go to /whatsapp-number-verify/.
Name the campaign
Enter a Campaign Name so you can find the results later, such as September leads.
Add your file
Drop the file on the upload area or click Choose File. Click Format Guidelines if you need a reminder of the rules.
Start the check
Click Start Verification. The confirmation says how many numbers were queued. The page notes that verification usually takes 1 to 2 minutes per 100 numbers.
Download the results
In Recent Verification Campaigns, click View Details on your campaign, then Download Results.

Plan limit#

The upload area shows Your current plan allows N verifications. A single file can't contain more unique numbers than that. If it does, nothing is queued and you see:

File contains 1500 numbers but your plan allows only 1000 verifications

The limit applies per file; it isn't a monthly total.

Split the list into smaller files, or upgrade on Billing & Plans.

Verification statuses#

Status	Meaning
Pending	Waiting to be checked.
Verified	The number is registered on WhatsApp.
Invalid	The number isn't on WhatsApp, or isn't a valid phone number.

Where to see results#

Recent Verification Campaigns shows your 5 most recent campaigns. View Details shows the total count and 10 of the numbers with their status (not necessarily the first rows of your file). The card's Created: date is in India Standard Time (IST). Download the file to see every number.
All Verifications lists every number from every campaign, newest first, 20 per page, with the columns Campaign, Phone Number, Status, Checked At and Created, in UTC. Checked At shows Not checked until the number has been checked.

Verifications created with the Create verification API appear on this page too.

Download format#

The file is a CSV named verification_results_<campaign name>_<date and time>.csv, with one row per number, sorted by phone number.

Column	Contents
Phone Number	The number as it was checked, digits only.
Status	`Pending`, `Verified` or `Invalid`.
Checked At	When it was checked, as `YYYY-MM-DD HH:MM:SS` in UTC, or `Not checked`.
Created At	When the number was queued, as `YYYY-MM-DD HH:MM:SS` in UTC.

You can download while some numbers are still pending. Download again later to get the final results.

Troubleshooting#

Message or problem	What to do
`Verification feature not available for your plan`	Your plan doesn't include number verification. Upgrade on Billing & Plans.
`Access denied. Only organization owners and editors can upload verification files.`	Ask the workspace owner to make you an editor.
Download opens a page of raw text containing `Access denied. Only organization owners and editors can download verification results.`	Your role is Analyst. Ask the workspace owner to make you an editor, or to download the file for you.
`Campaign name is required` or `Please enter a campaign name`	Fill in Campaign Name.
`Please select a file to upload`	Choose a file before clicking Start Verification.
`An error occurred while uploading the file`	Check your connection, reload the page and try again.
`Error processing file: …`	Something went wrong on the server. Try again, and contact support if it repeats.
`Please upload a CSV or Excel file`	Save the file as `.csv`, `.xlsx` or `.xls`.
`No valid phone numbers found in the file`	Check the header row, the phone column name and that the cells contain digits. If the file may be damaged, re-save it as `.xlsx` or UTF-8 `.csv`.
`File contains N numbers but your plan allows only M verifications`	Split the file. See Plan limit.
Numbers stay Pending	Connect a WhatsApp number on WhatsApp settings. Checks also wait while that number is busy sending messages.
The All Verifications table is empty	Your plan doesn't include number verification, so no results are listed.
Numbers you expected to be on WhatsApp show Invalid	Make sure they include the country code.