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
Log in to DeepAgent with your credentials.
In the left-hand side menu, click on Contacts.
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
Click the + Add Contact button in the upper-right corner.
A dialog box opens with the following fields:
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
Click Import in the top bar.
A sidebar (sheet) opens on the right.
Step 2 — Upload the file
Drag the CSV file into the drop zone, or click to select it.
Choose the separator: comma
,(default) or semicolon;.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)lastNamephone(required)emailcompanycustomField(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
Click Start Import.
A progress bar shows the progress in real time.
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
In the table, click the ✏️ (pencil) icon in the Actions column.
A dialog box with pre-filled fields will open.
Make your changes and click Save.
B) Full edit from the detail view
Click on the contact’s row to open its details page.
In the left panel, click Edit.
All fields become editable inline.
7. Delete contacts
⚠️ Warning: Deletion is permanent and cannot be undone.
In the table, click the three dots (
⋯) in the Actions column → Delete.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:
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:
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
Open the contact’s details.
In the Tags section, click +.
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:
Lists tab → + New List.
Enter a Name and Description.
Select the Static type.
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:
Lists tab → + New List.
Select the Smart type.
Define the filters in the condition builder.
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
In the table, check the boxes next to the contact rows.
The bulk toolbar appears at the bottom with the selected number.
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.
⏱️ Duration
MM: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.
Was this helpful?
More in Platform Guides DeepAgent
How to set up your AccountPlatform: Platform OverviewReports: How to Measure Agent Performance Using ReportsConversations: Calls and WhatsApp in a Single InboxStill need help? Share an idea