Skip to main content
Platform Guides DeepAgent

Contact Manager: How to Use It Properly

Step-by-Step User Guide to the Contacts Section in DeepAgent: How to create, import, organize, and analyze the contacts that your voice agents will call or receive calls from.

Written By Product

Last updated 3 months ago

1. Introduction

The Contacts section is DeepAgent’s integrated CRM: it contains all the phone numbers and people your voice agents interact with, whether for inbound or outbound calls.

From here, you can:

  • Maintain a single, organized database of all your contacts.

  • Bulk import your leads from a CSV file

  • Organize contacts using Stages, Tags, and Lists.

  • View the complete call history for each person.

  • Decide which agent can (or cannot) call a specific contact.


2. Accessing the Contacts Section

  1. Log in to DeepAgent with your credentials.

  2. In the left-hand side menu, click on Contacts.

  3. You’ll be redirected to /dashboard/contacts.

⚠️ This section is available on accounts with the CRM module enabled. If you don’t see the menu item, contact support.


3. Interface Overview

When you open the page, you’ll see:

  • A header with the title “Contacts” and a breadcrumb trail.

  • “Contacts” tab / “Lists” tab at the top.

  • A search bar to search by name, phone number, email, or company.

  • A “Filters” button that opens the side panel.

  • View toggle: Table ↔︎ Kanban.

  • Import (CSV) button.

  • + Add Contact button.


4. Create a contact

  1. Click the + Add Contact button in the upper-right corner.

  2. A dialog box opens with the following fields:

Required Field Notes

Name

No

Last Name

No

Phone

✅ Yes

Country selector (default: Italy 🇮🇹), E.164 format

Email

No

Validated

Company

No

Internship

No

Default: New

Tags

No

Multiple, can be created on the fly

Custom fields

No

Key-value editor

  1. Click Save: the contact appears immediately in the table.

💡 Tip: The phone number is automatically formatted in international format (e.g., +39...). If you enter a number without a country code, the selected country is used.


5. Import contacts from CSV

CSV import is the fastest way to upload large numbers of leads.

Step 1 — Open the wizard

  1. Click Import in the top bar.

  2. A sidebar (sheet) opens on the right.

Step 2 — Upload the file

  1. Drag the CSV file into the drop zone, or click to select it.

  2. Choose the separator: comma , (default) or semicolon ;.

  3. A preview of the first few rows will be displayed.

Step 3 — Column mapping

Map each column in the CSV to a field in DeepAgent:

  • firstName (required)

  • lastName

  • phone (required)

  • email

  • company

  • customField (for extra data that will become custom fields)

  • Skip (for columns you don’t want to import)

Step 4 — Global Settings

Set the following for all imported contacts:

  • Stage (default: New).

  • Common tags (e.g., import-gennaio-2026).

Step 5 — Import and Results

  1. Click Start Import.

  2. A progress bar shows the progress in real time.

  3. When finished, you’ll see:

    • ✅ Imported

    • ⚠️ Duplicates skipped (contacts with the same phone number/email already present)

    • ❌ Errors (with row number and reason)

💡 You can cancel a currently running import using the Cancel button.


6. Edit a contact

There are two ways to edit a contact:

A) Quick edit from the table

  1. In the table, click the ✏️ (pencil) icon in the Actions column.

  2. A dialog box with pre-filled fields will open.

  3. Make your changes and click Save.

B) Full edit from the detail view

  1. Click on the contact’s row to open its details page.

  2. In the left panel, click Edit.

  3. All fields become editable inline.


7. Delete contacts

⚠️ Warning: Deletion is permanent and cannot be undone.

  1. In the table, click the three dots (⋯) in the Actions column → Delete.

  2. Confirm in the dialog box displaying the contact’s name and phone number.

To delete multiple contacts at once, see Bulk Actions.


8. Search and filters

Text Search

The search bar at the top searches simultaneously for: First Name, Last Name, Phone, Email, and Company.

Filter Panel

Click on Filters to open the side panel and combine the following criteria:

Filter Type Notes

Internship

Multiple Checkboxes

New, No Response, Unreachable, Success, Failed

Tags

Multiple checkboxes with search

Lists

Multi-select

Up to 5 lists at a time

Last contact

Date range

Presets: Today, 7 days, 30 days, 90 days

Creation date

Date range

Preset: Today, 7 days, 30 days, 90 days

Source

Dropdown

CSV Import, Inbound, Outbound, Manual, Campaign, Backfill

Filters can be combined (AND operator). Click Clear to reset them.


9. Table View vs. Kanban View

In the top right corner, you’ll find a toggle with two icons:

Table View (default)

Displays the following columns: Name | Phone | Email | Company | Stage | Tag | Last Contact | Actions.

Kanban View (Board)

Displays 5 columns, one for each Stage. Each contact is a card.

  • Drag and drop a card between columns to instantly change its stage.

  • The card displays Name, Phone, and the main Tags.


10. Contact Stages

The Stage represents the contact’s status in the funnel:

Stage Color When to Use It

🟦 New

Blue

Default for new contacts who haven’t been called yet

🟨 No response

Yellow

Attempt made, contact did not answer

🟧 Unreachable

Orange

Invalid number / out of service

🟩 Success

Green

Positive outcome (qualified lead, sale, appointment)

🟥 Failed

Red

Negative outcome (explicit rejection)

The stage updates automatically based on call outcomes, or manually:

  • From the Kanban view using drag-and-drop.

  • From the contact details via the Stage dropdown.


11. Tags

Tags are custom labels used to segment contacts (e.g., vip, roma, non-richiamare).

Add a tag

  1. Open the contact’s details.

  2. In the Tags section, click +.

  3. Search for an existing tag or type a new name → the tag is created instantly.

Remove a tag

Click the X on the tag’s card.


12. Notes

In the left panel of the contact details, you’ll find a Notes text area:

  • Maximum length: 5,000 characters.

  • Autosave (2-second debounce).

  • Status indicator: “Saving…”, “Saved ✓”, “Error”.

  • The character counter appears when the count exceeds 4,500.


13. Custom Fields

DeepAgent Supports two types of custom fields:

Stable (editable) fields

Defined by you (e.g., partita_iva, codice_cliente). Editable from:

  • Contact creation form.

  • Contact edit form.

  • CSV mapping (column mapped as customField).

Fields collected by agents (read-only)

Information automatically collected by bots during calls (e.g., availability times, product preferences). These are grouped by agent and marked with the 🤖 icon.


14. Contact Lists (Static and Smart)

Lists are collections of contacts that you can use in outbound campaigns.

Access them from the Lists tab on the Contacts page, or from /dashboard/contacts → toggle “Lists.”

Static Lists

Manually added contacts; the list remains fixed.

To create a static list:

  1. Lists tab → + New List.

  2. Enter a Name and Description.

  3. Select the Static type.

  4. Add contacts using the selector.

Smart Lists

These are populated dynamically based on filters (stage, tag, source, etc.): any new contact that meets the criteria is automatically added.

To create a smart list:

  1. Lists tab → + New List.

  2. Select the Smart type.

  3. Define the filters in the condition builder.

  4. Save: the list updates in real time.

List Details

Click on a list to open its details:

  • Table/Kanban view of the contacts included.

  • Readiness tab: shows which campaign variables are assigned values for the contacts.

  • Add Contacts button (static lists only).


15. Bulk Actions

  1. In the table, check the boxes next to the contact rows.

  2. The bulk toolbar appears at the bottom with the selected number.

  3. Available actions:

    • 📁 Create a (static) list with the selected contacts.

    • 🏷️ Add a tag to all selected contacts.

    • 📤 Export to CSV or JSON.

    • 🗑️ Bulk delete (with confirmation).


16. Export contacts

Two ways to export:

A) Export all contacts

From the top menu → Export → choose CSV or JSON.

B) Export only selected contacts

Use the bulk toolbar (see Multiple Actions).

The downloaded file contains: first name, last name, phone number, email, company, internship, tags (concatenated), creation date, and custom fields.


17. Contact details and call history

Click on a row in the table to open the /dashboard/contacts/[id] page.

Left panel: information

  • Profile (First Name, Phone, Email, Company).

  • Current internship (editable).

  • Tags (add/remove).

  • Notes (auto-save).

  • Custom and predefined fields.

  • List of agents who have called (with the option to block).

Right panel: call timeline

For each call:

  • 📅 Date and time.

  • 📞 Direction (incoming / outgoing).

  • 🎯 Outcome: Success / Failure / No answer / Unreachable.

  • 🤖 Name of the agent who handled the call.

  • ⏱️ DurationMM:SSs.

  • 📝 Summary (transcript summary), if available.

Click on a card → a modal window opens with the full transcript.

The “Load More” button at the bottom loads older calls (pagination).


18. Block an agent from calling a contact

To prevent an agent from calling a contact, open the contact’s details and block the agent from the Agents section. See the full procedure in the Contacts FAQ: Exclude or block a contact from calls.

20. FAQs and Troubleshooting

❓ Can I restore a deleted contact? No. Deletion is permanent. To be safe, always export your contacts before performing bulk deletions.

❓ How many contacts can I import in a single CSV file? There is no hard limit, but for very large files (>10,000 rows), the import may take a few minutes. The progress bar shows you the status.

❓ Can I search/filter by multiple tags at the same time? Yes, from the Filters panel you can select multiple tags (using the OR operator within the same category, or the AND operator across different categories).

❓ What happens if I manually change a stage? The stage remains set to that value until an event (e.g., a new call) automatically updates it again.

❓ Do Smart Lists update in real time? Yes, whenever a new or modified contact meets the list’s criteria, it is automatically added (or removed).

21. Glossary

  • Contact: a person or phone number in the CRM.

  • Stage: the contact’s status in the funnel (New, No Response, Unreachable, Success, Failed).

  • Tag: A custom label used to segment contacts.

  • Static List: A fixed collection of contacts, selected manually.

  • Smart List: a dynamic collection of contacts defined by filters.

  • Source: where the contact comes from (CSV, manual, inbound, outbound, campaign, backfill).

  • Static Field: Custom personal information field that can be edited manually.

  • Collected Field: data automatically captured by agents during a call.

  • Agent Exclusion: A rule that prevents a specific agent from calling a specific contact.

  • Integration: Connection to an external source (e.g., Google Sheets) to synchronize contacts.