Skip to main content

Importing contacts

Bring an existing list into WhautoVoice from a CSV file. The import runs in the background, so you can carry on working while it finishes.

Before you start​

  • A CSV file with a header row. Any spreadsheet can save one.
  • Phone numbers in international format, for example +1 202 555 0101. A row without a phone number is skipped.
  • Check your plan's contact allowance under Settings > Subscription & usage if the file is large.

Step 1: Choose your file​

  1. Open the import page
    • Go to Contacts and click Import.
  2. Download the sample if you are unsure of the format
    • Sample CSV gives you a file with the expected columns.
  3. Click Choose a CSV file
    • Pick the file. The rows are read in your browser and counted.

Choose File

Step 2: Match the columns​

Each column in your file is listed with a dropdown. Pick the WhautoVoice field it belongs to, or leave it as Not mapped.

Match Columns

FieldRequiredNotes
PhoneYesNormalised to international format. Rows without one are skipped.
NameNo
EmailNo
TagsNoOne cell, separated by ; or ,. Tags that do not exist yet are created.

Any column you do not match is saved on the contact as a custom attribute, using the column header as the attribute name. That is how "company", "insurer" or "preferred time" columns survive the import.

Step 3: Check and import​

The preview shows the total row count, how many rows will be skipped for having no phone number, and the first rows as they will be saved.

Check And Import

Click Import contacts. The rows are queued and a progress strip shows Queued, In progress and then Finished with the result, for example "Imported 212 contacts (3 skipped)". If some rows finish with problems you see Finished with skipped rows.

How duplicates are handled​

One contact per phone number per account. A row whose phone number already exists is skipped and counted in the result, and the existing contact is left untouched. Import a corrected file with only the new rows rather than the whole list again.

Common reasons a row is skipped​

  • The phone cell is empty.
  • The number cannot be read as a phone number (letters, or too few digits).
  • The number already belongs to a contact.
  • The account's contact allowance is full. Upgrade the plan or remove contacts you no longer need.
Tags and segments after an import

Give imported rows a tag such as imported-sept in the file. You can then build a segment on that tag and start a campaign against exactly those contacts. See Tags and segments.

Need help?

Email us at hello@whautovoice.com and we will get you sorted.