Create a new contact list

Prerequisites
  • Outbound > Contactlist > Add, Delete, Edit, View permissions
  • OutboundImport TemplateAddDeleteEdit, View permissions
  • OutboundFile Specification Template > View permission
  • Outbound > Attemptlimits > View to add an attempt limit to the contact list

A file to upload in delimiter separated or fixed-length format that is encoded in UTF-8 format encoding or a file in Microsoft Excel format

To create a contact list, upload records from the input file. You can also build contact lists using an Import template. 

There are three ways to create a contact list:

  • Upload records in comma-separated values .csv or Excel file
  • Use an Import template
  • Use a File Specification template and upload records in a comma-separated, delimiter-separated, or fixed-length input file

If the contact list entry exists, see append records to a contact list.

Contact and contact list limits
  • The character limit for data in contact list header columns is 128 characters. A message appears if this new contact list exceeds that limit, but an entry does not appear for it in the Event Viewer.
  • The character limit for data in contact list column entries is 512 characters. A message appears if any contact columns in this new list exceed that limit, and an entry appears for it in the Event Viewer.
  • The limit for the number of columns in a contact list is 50 columns. A message appears if this new contact list exceeds that limit, but an entry does not appear for it in the Event Viewer.
  • The contact lists per organization limit is 1000. A message appears if adding this new contact list exceeds that limit. Delete old or obsolete contact lists as needed and click Save again to complete the new contact list configuration.
  • The contacts per organization limit is 5 million. If the total number of contacts in the organization exceeds that limit, you cannot add, import, or append new contacts. Delete old or obsolete contacts as needed and then add, import, or append the new contacts.
  • The maximum number of contacts per contact list is one million.

For more information about limits when using outbound dialing to run campaigns, see Outbound campaign limits.

  1. Click Admin.

  2. Under Outbound, click List Management.

  3. Click the Contact Lists tab.

  4. Click Create New.

  5. Type a unique name in the Contact List Name box. Names can contain spaces, numbers, and special characters, but must be unique.

  6. Select a division from the Division box, or accept the default Home division.

    Note: If you do not assign a campaign to a custom division, it belongs to the Home division by default. See About Access Control and Divisions overview.

  7. To use a File Specification Template to upload contacts from a delimiter-separated file or a fixed-length format file, toggle Use File Specification Template to Yes. In the Select File Specification Template box, select a template to use for the contact list. 

  8. In Upload contacts from a CSV or Excel file, click Browse. Select a .csv file and click Open. A list of sample rows appears.

    Figure displays sample rows for a new Contact List.

  9. Follow this step if you are using an Import template to build your contact lists.
    To select your Import template:
    1. Toggle Use Import Template to Yes
      Note: The Contact List Name box changes to List Name Prefix.
    2. In the Select Import Template box, select the template to use for this contact list. 
    3. (Optional) Select a column from the Unique Identifier Column.

      What is a unique identifier?

      A unique identifier is useful if you will append this list with more data in the future. If you specify a unique identifier column, such as a customer ID or account number, the append process can match incoming data with existing contacts.

      Figure shows an account number column selected as the list's unique identifier.

      Without a unique identifier, the entire row is the primary key. If you append a modified record, a subsequent upload appends that record as a new row, even if an existing row has the same identifier. With a unique identifier, the system replaces the existing record instead.

      Custom contact list ID columns cannot exceed 100 characters and cannot contain special characters, such as a backslash. Compose a unique identifier from alphanumeric characters, excluding spaces, backslashes, and these special characters that don’t work with URLs:

      – . _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; =

      Tip: A .csv file must not include any blank rows at the end of the data, which can cause an import failure.
    4. To create your contact lists using the Import template, Click Save
      This is the last step for creating a contact list with an Import template. The system adds the new entry to the data grid of Contact Lists with progress and error indicators. While records are uploading, a progress indicator appears next to the contact list name.
      For more information on using an Import template to create your contact lists, see Contact List Builder.
  10. When you save a contact list, the leading and trailing white space is removed from the contact field of the contact list. If you do not want to remove the white space from your contact list, switch the Trim leading/trailing whitespace toggle to No.
  11. In Contact List Columns, select the appropriate columns. Contact lists can contain either or both phone numbers and email addresses. Once you set one or the other, the placeholders update and show as optional.  Figure shows selections for Phone Number and Email Address columns.

    To select phone numbers:

    1. From the Phone Number Column box, select a column containing phone numbers.

      Note: The maximum number of phone number columns allowed per list is 10.

    2. From the Phone Type box, select the type of number, for example home, work or cell.

    3. If your contact list contains a column that contains the time zone of a phone number, select that column from the Time Zone Column box. This step is a prerequisite for configuring contactable time sets. If you plan to use automatic time zone mapping, skip this step.
    4. To select another phone number column, repeat these steps.

    To select email addresses:

    1. From the Email Address Column, select a column containing email addresses.

      Note: The maximum number of email address columns allowed per list is 10.

    2. From the Email Type box, select the type of email address, for example personal or work.
    3. To select another email address column, repeat these steps.
  12. If you want the system to determine compliant dialing times for the phone numbers in the contact list, set Automatic Time Zone Mapping to Yes.
    Notes:
    • Automatic time zone mapping is supported only for phone numbers, not email addresses. Automatic time zone mapping is supported for United States, Canadian, and Caribbean area codes and United States zip codes only. For more information, see Automatic time zone mapping overview.
    • To use the Automatic Time Zone Mapping feature from outside North America to dial North American phone numbers, the organization (Org) attempting to make the phone call must be located in one of the North American AWS regions.
  13. If you set Automatic Time Zone Mapping to Yes and your contact list has a column that contains the zip code, select ZIP from the Zip Code Column box. Zip codes can be blank. For best results with automatic time zone mapping, use both phone numbers and zip codes.
  14. To expand advanced options, click the caret next to Advanced.

    Figure shows caret that when clicked, expands advanced options section

    1. (Optional) Select an entry from the Attempt Control list. Attempt controls restrict the number of calling attempts to a contact record or phone number on a specific day or in total.

      Note: Attempt control is supported only for phone numbers, not email addresses. For more information, see How to limit contact attempts.

    2. (Optional) Select a column from the Unique Identifier Column.

      What is a unique identifier?

      A unique identifier is useful if you will append this list with more data in the future. If you specify a unique identifier column, such as a customer ID or account number, the append process can match incoming data with existing contacts.

      Figure shows an account number column selected as the list's unique identifier.

      Without a unique identifier, the entire row is the primary key. If you append a modified record, a subsequent upload appends that record as a new row, even if an existing row has the same identifier. With a unique identifier, the system replaces the existing record instead.

      Custom contact list ID columns cannot exceed 100 characters and cannot contain special characters, such as a backslash. Compose a unique identifier from alphanumeric characters, excluding spaces, backslashes, and these special characters that don’t work with URLs:

      – . _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; =

      Tip: A .csv file must not include any blank rows at the end of the data, which can cause an import failure.
    3. To preview dial specific contacts, even if the campaign is not running in preview mode, select a Preview Mode Column and one or more corresponding values. In the example below, a contact with WorkNumber equal to 3174134246 is always preview dialed.

      Figure shows how to always preview dial the contact whose account code is 3799.

      For example, set a VIP flag for a high-value contact to ensure that the system always previews dials a record and therefore never abandons it.

      Tip: Configure preview mode when you initially create the contact list. You cannot set up this feature later while appending records.

    4. If this contact list is going to be used in a campaign with Dynamic Queueing sorting, you must specify the data type for the column to be sorted by when running your campaign. Consider setting up potential sort columns for your future campaigns.


      Under Column Data Type Specifications, configure the settings for the selected column.

      Data Type Properties
      Numeric Min Max
      Specify the minimum and maximum acceptable values for the selected column.
      Text Max Length
      Specify the maximum character length for the selected column.
      The maximum length of all text columns combined cannot be greater than 750 characters.
      Timestamp

      Requires the standard ISO format YYY-MM-dd'T'HH:mm'Z'
      Acceptable formats are:
      2017-07-15T15:45Z for minutes precision
      2017-07-15T15:00Z for hour precision
      2017-07-15T00:00Z for day precision


      Notes
      • If you save a contact list with column data type specifications, you cannot go back and edit the column data type specifications. If changes are required for the column data type specifications, you have to create a new contact list.
      • If you save a contact list without data type specifications, you can go back and create new column specifications.
  15. Click Save. The system adds the new entry to the data grid of Contact Lists with progress and error indicators. While records are uploading, a progress indicator appears next to the contact list name.

    contact_list_import_indicator

    When the upload completes, a message appears.

    Figure shows popover that appears when a list the upload ends.