Skip to main content

Audience

  • Operators managing contact lists day-to-day
  • Teams reviewing contacts before outbound campaigns
  • Anyone who needs to quickly find, filter, or clean up contacts

Prerequisites

  • Access to the Contacts page in your workspace
  • At least one contact in your workspace

Overview

The Contacts page displays your contacts in a table layout on desktop, giving you a scannable view of all contact metadata at a glance. You can:
  • Filter by source (Manual, CSV Upload, CRM Sync)
  • Sort by name or date added
  • Search across name, phone, and email
  • Select multiple contacts for bulk actions
  • Open contact details in a side panel without leaving the table
On mobile devices, the page displays the original list view for easier touch navigation.

Table columns

The contacts table shows the following columns:

What the Status column means

Messaged before appears once any SMS your workspace sent to one of the contact’s phone numbers was sent or delivered. Messages that failed or were blocked don’t count, and neither do texts the contact sent you. The column shows the same value when you open a list’s contacts.

What the Source badge means

The Source badge always shows where a contact is managed right now, not where it first came from. When you upload a CSV and later connect the matching CRM, your CRM takes over those contacts and the badge changes from CSV to the CRM’s name. That is expected — the contact is now kept up to date by your CRM, so that is what the badge reports. If you later disconnect the integration, the badge reverts to CSV, because the CRM is no longer maintaining it. Your upload history is never lost. A contact that arrived by CSV always stays in the CSV Upload filter, whichever CRM later manages it.

Opt-outs column

The Opt-outs column shows the channels a contact cannot be reached on.
  • Do Not Call appears when the contact has opted out of calls.
  • Do Not SMS appears when the contact has opted out of texts.
  • A contact with no badge is open on both channels. A contact can show both badges.
Hover over a badge to see why. Examples include Opted out by staff · 5 Oct, Replied with an opt-out keyword · 3 Oct, and Opted out in AgentBox. A dash means the contact has no opt-out. See Contact Opt-outs for every source and how opt-outs sync with your CRM.
  • Voqo does not stop calls on a Do Not Call badge yet. The badge shows that the opt-out is recorded.
  • A contact archived in AgentBox shows both badges, because AgentBox turns on every Do Not setting when a contact is archived. That contact can’t receive SMS from Voqo.
  • The table shows only Do Not Call and Do Not SMS. To see email and letters opt-outs, open the contact.

Filter by source

Use the source dropdown above the table to filter contacts:
  • All Contacts — Shows every contact in your workspace
  • Manual — Contacts added manually through the UI
  • CSV Upload — Every contact you imported by CSV, including contacts a CRM has since taken over
  • SMS Upload — Contacts imported from an SMS campaign’s uploaded file
  • CRM Sync — Contacts currently managed by a VaultRE, AgentBox, or Eagle MRI integration
  • Phone / Device — Contacts synced from your phone’s address book
  • VCF Upload — Contacts imported from a .vcf (vCard) file
  • My Contacts — Only the contacts assigned to you (see Assign Contacts to Teammates)
A contact can appear under both CSV Upload and CRM Sync — the first tells you how it reached Voqo, the second tells you what maintains it today. The filter is reflected in the URL, so you can bookmark or share a filtered view.

Advanced filters

Click the Filters button to access additional filtering options:
  • Contact Status — Choose Can’t receive SMS to show only contacts Voqo won’t text. This includes blocked contacts, and contacts opted out of SMS in Voqo or in your CRM.
  • Has Email — Show only contacts with or without an email address
  • Has Notes — Show only contacts with or without notes
A badge on the Filters button shows how many filters are active. Click Clear Filters to reset.

Sorting

Click a sortable column header to change the sort order:
  1. First click — Sort descending (Z–A for names, newest first for dates)
  2. Second click — Sort ascending (A–Z for names, oldest first for dates)
An arrow icon in the header shows the current sort direction. The sort state is saved in the URL. Type in the search box and press Enter to search across contact names, phone numbers, and email addresses. Click the X button to clear the search.

Pagination

The table shows 50 contacts per page. Use the pagination controls at the bottom to navigate:
  • Previous / Next buttons to move between pages
  • Page X of Y indicator shows your current position
  • Showing X–Y of Z contacts shows the total count

Contact details panel

Click any row to open the contact details panel on the right side of the screen. The panel shows:
  • General tab — Contact information, phone numbers, email, and customer profiles
  • Activity tab — Call history and interactions with this contact
  • CRM Data tab — Integration data synced from your CRM
On a larger screen, at the bottom of the contact’s summary card, Last contacted shows the most recent time Voqo reached the contact or the contact reached you, and how: Campaign SMS, Direct SMS, SMS from contact or Call. It counts every SMS Voqo sent and every call attempt, including calls that rang out, so it can show a date even when a message wasn’t delivered. For a contact synced from AgentBox, it also reads AgentBox’s own Last Contacted date, so contact your team logged in AgentBox counts too. When the AgentBox date is later, the row shows it as in AgentBox. Voqo’s own record starts filling from the day this feature reached your workspace. The AgentBox date appears once the contact next changes in AgentBox, or when Voqo next updates the contact’s Last Contacted in AgentBox. You can edit contact details directly in the panel. If you have unsaved changes and try to close the panel, you’ll be asked to confirm. The panel shows a badge for each channel the contact has opted out of: Do Not Call, Do Not SMS, Do Not Email or Do Not Mail. The badges sit above Sync to CRM. Hover over a badge to see why that channel is blocked. To close the panel:
  • Click the X button
  • Press Escape
  • Click outside the panel

Bulk delete

To delete multiple contacts at once:
  1. Select contacts using the checkboxes in the first column
  2. The bulk actions bar appears showing “N selected”
  3. Click Delete
  4. Confirm the deletion in the dialog
Bulk delete cannot be undone. Make sure you’ve selected the correct contacts before confirming.
The select-all checkbox in the header selects all contacts on the current page.

Delete all matching a filter

When you’ve narrowed the table with a source filter, search, or advanced filters, you can delete every contact that matches — not just the ones on the current page — in one action.
  1. Apply any filter, search, or source tab (other than All Contacts)
  2. A Delete all matching (N) button appears, where N is the total number of contacts across every page that match your current view
  3. Click it and confirm the count in the dialog
  4. Every matching contact is deleted, and any notes attached to them are removed too
This deletes all matching contacts across every page, not only the ones you can see. Deletion cannot be undone. Check the count in the button and the confirmation dialog before confirming.
This is the fastest way to clean up a whole cohort — for example, every contact from a single CSV upload, or every contact synced from your phone.

The count changed when I confirmed

If a teammate adds or removes contacts while your confirmation dialog is open, Voqo notices that the matching count no longer matches what you saw. Rather than deleting the wrong number, it shows you the updated count and asks you to confirm again. Nothing is deleted until the count you confirm matches what’s actually there — so you always delete exactly what you intend.

URL state

All table state is saved in the URL:
  • Source filter (?tab=csv_upload)
  • Sort column and direction (?sort=name&order=asc)
  • Current page (?page=2)
  • Search query (?search=john)
  • Advanced filters (?contact_block=unblocked&has_email=yes)
  • Selected contact (?contact_id=abc123)
This means you can:
  • Refresh the page without losing your place
  • Share a URL with a colleague showing the same filtered view
  • Bookmark commonly used filter combinations

Troubleshooting

Table is not showing (I see a list instead)

The table view only appears on desktop screens (768px or wider). On mobile devices, the original list view is shown for easier touch navigation.

Contacts are missing from the table

  • Check your source filter — you may have filtered to a specific source
  • Check advanced filters — you may have filtered by email/notes/blocked status
  • Use the search box to find specific contacts
  • Check pagination — the contact may be on another page

Bulk delete didn’t remove all contacts

  • Some contacts may have already been deleted
  • Check the toast notification for the actual count of deleted contacts
  • Refresh the page to see the updated list

The “Delete all matching” button isn’t showing

The Delete all matching action only appears when a filter is active — a source tab other than All Contacts, a search term, or an advanced filter — and at least one contact matches. Switch off All Contacts or apply a filter to see it.

Contact panel shows stale data

  • Close and reopen the panel
  • Refresh the page
  • If the issue persists, contact support

A contact shows a Do Not badge I didn’t set

The badge comes from a STOP reply, a staff opt-out, or a Do Not setting in your CRM. Hover over the badge to see which. To change a CRM setting, change it in the CRM, or resubscribe the contact from the inbox with opt-out sync on. See Contact Opt-outs.