Contacts
Adding and Managing Contacts
Contacts replace unfamiliar phone numbers with recognizable names and keep useful customer details available wherever your team communicates in Waveline. Add contacts individually, update their information, save favorites, post notes, resolve duplicate phone numbers, and remove contacts you no longer need.
External and internal contacts
External contacts are customers, vendors, and other people outside your organization. These are the contacts you can add and manage using the instructions on this page.
Internal contacts represent teammates and shared inboxes. Waveline creates them automatically from your organization's existing setup, so they are managed through the corresponding teammate or inbox rather than from Contacts.
Learn more in Contacts Overview and Contact Visibility and Sharing.
Before you begin
- Have the person's name and, when applicable, their phone number or email.
- For an existing contact, confirm that you have permission to edit it. Access only as a Viewer of a shared inbox does not allow editing or posting notes. See Contact access.
- Use Importing Contacts when adding a larger contact list.
- Consider who should have access to the contact. Learn more in Contact Visibility and Sharing.
Already have a contact list?
Use Importing Contacts to add contacts from a CSV or Excel file instead of entering each contact individually.
Where to find contacts
Web app: Select Contacts from the dashboard sidebar.
Mobile app: Select Contacts from the bottom tab bar near Dial.
On either app, you can also create a contact from an unknown number shown in call or conversation details. Waveline carries the number into the new contact form for you.
What you can save
- First and last name: Identify the person throughout Waveline.
- Phone: Used for caller identification, calling, and messaging.
- Email: Provides another searchable identifier and useful reference.
- Company and role: Give teammates additional business context.
- Access: Determines which teammates and inboxes can find and work with the contact. Learn more in Contact Visibility and Sharing.
- Notes: Preserve updates and context in chronological order. You can prepare notes while creating a contact; they are posted after the contact is saved. Learn how to add contact notes.
Add a contact from the web app
- Select Contacts from the dashboard sidebar.
- Select Add contact.
- Enter the contact's name and a valid phone number. Waveline creates and saves the contact automatically after both are provided.
- Add any available email, company, and role information. Each field saves when you finish editing it.
- Open Access and review who can see the contact. Access changes also save as you make them.
Once the contact is saved, you can favorite it and post notes. If you began writing a note before the contact was complete, Waveline posts it after the contact is saved.
If you close an incomplete new contact, Waveline may ask Discard this contact? Select Keep editing to finish it or Discard to leave without saving the draft.
Add a contact from the mobile app
- Select Contacts from the bottom tab bar near Dial.
- Select the plus button.
- Under Contact info, enter the contact's name. Add a phone number for calling, messaging, or caller identification, and any email, company, and role information. A phone number is optional when saving a contact on mobile, but any number or email you enter must be valid.
You can also select an unknown number in call details and choose Add Contact, or tap an unknown number at the top of a conversation. Waveline carries the number into the new contact form for you.
Contacts imported from a connected service
Imported provider-owned contact details are read-only in Waveline. Edit the name, numbers, and other source details in the connected service, then allow the changes to sync. Waveline notes are separate from those source details; you can post them when your contact access permits it. See Contact access.
Removing the integration removes its imported contacts from the Waveline directory. Their notes stay with historical records, and other Waveline contacts are preserved.
Edit an existing contact
Web app: Select the contact to open its details, then update the necessary fields. Waveline saves each field when you finish editing it.
Mobile app: Open an external contact, update its information, and select Save.
A view-only contact does not allow changes. Contacts managed by a connected service have read-only source details. Internal teammates and inboxes must be changed from their respective teammate or inbox settings. See Contact access if editing is unavailable.
Favorite a contact
Favoriting places frequently used contacts closer to the top of contact selectors when you start a call or message.
- Web app: Open the contact and select Favorite.
- Mobile app: Open the contact's options and choose Add to Favorites.
Favorites are personal to each teammate. Favoriting a contact does not change another teammate's favorites.
Add contact notes
Contact notes create a chronological record of useful context for everyone who can access the contact. Each note shows who posted it and when, making it easier for another teammate to understand previous conversations or follow-up needs.
- Open the contact.
- Find Notes on web, or select the Notes tab on mobile.
- Enter the update in Write a note on web, or Post a note on mobile.
- Select the send button.
You can prepare notes while creating a contact in either app. On web, complete the name and valid phone number so the contact can save. On mobile, complete the contact and select Save. Notes prepared before saving are posted after the contact is saved; check that they appear on the saved contact before leaving. View-only access does not allow posting notes.
When a phone number is already in use
If another contact already uses the same phone number, Waveline shows Phone in use and asks what to do with the contact you are saving. Your choice determines which contact name appears when that number calls or messages.
Review duplicate-number choices carefully
- Make this my private contact: When available, keep the existing contact unchanged for everyone else and use the new private contact as the name and information you see for that number.
- Merge into this contact: Combine the selected existing contacts into the contact you are saving when merging is available.
- Keep as a separate contact: Keep the contacts separate and use the contact you are saving as the preferred match for that number and access level.
Delete a contact
Web app: Open the contact, select Delete contact, and then select Delete to confirm.
Mobile app: Open the contact's options, choose Delete Contact, and confirm.
Internal teammates and inboxes cannot be deleted from Contacts.
What happens next
- The saved name can identify matching calls and messages.
- Updated contact information becomes available on web and mobile.
- Favorites appear more prominently in contact selectors.
- Notes remain with the contact for teammates who have access.
- The contact's access setting determines who can find and work with it.
Best practices
- Use the person's recognizable name rather than a temporary description.
- Include a company and role when several contacts have similar names.
- Keep phone numbers and email addresses current.
- Use notes for useful business context rather than information that belongs in a message.
- Review duplicate-number choices carefully before saving.
Troubleshooting
I cannot add or edit a contact
For an existing contact, check whether it is view-only or managed by a connected service. If your only access is as a Viewer of a shared inbox, you can read the contact but cannot edit it. See Contact access. When creating a contact, complete the required name and any invalid fields; the web app also needs a valid phone number before it saves automatically.
Waveline says the workspace has reached its contact limit
Contact Waveline Support to review the workspace's contact capacity. Existing contacts can still be updated when you have permission. This is separate from the file-size and row limits for spreadsheet imports; splitting a file into smaller imports does not resolve a workspace contact-limit message.
A contact is read-only
If the contact is managed by a connected service, update its source details in that service. If Waveline shows view-only access, ask the teammate responsible for the contact to review how it is shared with you. See Contact access.
The wrong contact name appears for a phone number
Open the contact that should identify the number, remove its phone number, and then add the number again. When Waveline finds another contact using it, choose Keep as a separate contact to make this contact the preferred match, or merge the records when appropriate.
I cannot post a note
For a new contact, finish saving it: provide a name and valid phone number on web, or complete the contact and select Save on mobile. Notes prepared beforehand are posted after saving. For an existing contact, view-only access does not permit posting notes. If a post fails, check whether the note already appears before trying again.
I cannot edit an internal contact
Internal contacts represent teammates and shared inboxes, so they cannot be edited from Contacts. Update the corresponding teammate or inbox instead.
A contact does not appear for another teammate
Review the contact's access setting and confirm that the teammate or one of their inboxes has access. See Contact Visibility and Sharing for instructions.