Skip to content

Contacts ​

At a glance ​

LocationSidebar → Contacts (Users icon)
PlanAll plans, including the free tier
Related features3
Contact Database (0:37)
Transcript

Every person you talk to lives in the contact database, with company, role, labels, notes and the full conversation history. Search by name, number or company and the list narrows as you type. The same profile sits next to the chat. Open the contact panel, edit the details right there, and save: company, role, department. Team notes, labels and the data tab live in the same panel, so nothing depends on remembering what was said last time.

View and manage all your WhatsApp contacts. Add custom fields, notes, and tags. Import/export contacts.

CSV import and export ​

The CSV import reads exports from Google Contacts, Outlook and iPhone as they come, with no column editing: it takes the name, every phone number and every email address the row carries, plus company, department, job title, birthday, address, website and notes, and keeps any column it does not recognise as an extra field on the contact (up to 30 of them per contact).

The first phone and the first email become the contact's own; the rest are kept alongside the contact so nothing in the file is thrown away.

Exporting produces the same picture in reverse: one CSV column per attribute (name, every phone and email you hold for the contact, WhatsApp name, WhatsApp status, language, status, company, job title, department, birthday, address, website, notes, labels, last message date and created date), plus one column per custom field name used anywhere in the organization, so a file you export and re-import elsewhere carries everything the contact record holds.

When you re-import a file exported from Spun, the columns that describe the contact's state rather than details someone typed in (WhatsApp Name, Is WhatsApp, Language, Status, Last Message and Created) are skipped, so they never turn into extra fields.

Before you import, the preview shows company, job title and birthday next to the phone and name, a +N more chip that opens whatever else the row carries, and a note on any row holding more than one phone or email. A row with neither a phone nor an email is shown greyed with the reason rather than disappearing.

Large files are uploaded in batches automatically. The import dialog carries step-by-step export instructions for each source.

Contact list and Not identified yet ​

A contact does not need a phone number: one saved with an email address only is kept, listed and filtered like any other. The contact list shows a second line under each name with the company and job title, or the email address when there is neither, and the search box matches company and job title as well as names and numbers.

The contact list also has a Not identified yet group for WhatsApp contacts Spun added by itself because WhatsApp has not shared their phone number; they are kept out of the main list, the group can be searched like the rest, and once someone names or identifies a contact it joins the main list.

A chat whose number WhatsApp has not shared is added to that group once a message is sent or received in it, or once you add a note, a task, a pipeline stage, a circle or details such as a company for the person; older chats from your WhatsApp history appear there only after one of these, and opening or reading a chat does not add it.

A help button beside the group heading, and on the "Who is this?" card, explains this. In the chat list a hidden-number chat with no saved name or number is titled by a 5-digit code and the word Hidden, for example 72933 - (Hidden); a WhatsApp profile name, when known, is shown beside it as ~name.

The code is the last 5 digits of the hidden ID WhatsApp uses for that person: it is a reference inside Spun for telling these chats apart and finding one again, it is not a phone number and it is not shown anywhere in WhatsApp.

Typing hidden in the chat search (the word as the inbox shows it, in the inbox language) lists all of those chats, and typing all or part of the 5 digits finds the chat.

When WhatsApp delivers one conversation twice, once in the chat list under the phone number and once in the message history under a hidden ID, Spun recognizes that it is one chat (the same WhatsApp message appears in both) and files the messages under the number chat, so the person appears once.

It never joins two chats because their text looks alike. Once such a chat is linked to a contact that holds a phone number, the chat is titled by the contact's name, or by that number when the contact has no name, and searching for the number finds it; replies still go to the same chat.

When another chat in the workspace carries exactly the same WhatsApp profile name, the "Who is this?" card lists it (up to three chats, newest first) with its picture, the name shown as ~name, the number and a Link button: for a number that already belongs to a contact the usual link question follows, and for a new number the name dialog opens with the name and number filled in; nothing is linked until you confirm.

Group members with hidden numbers ​

WhatsApp can hide the number of a group member in the same way. When Weave lists a group's members or reports on a group, such a member appears as a hidden-number member, usually under the profile name they set in WhatsApp, and is counted and labelled rather than silently dropped; no number is ever invented for them.

To name one, link their own chat once from its "Who is this?" card (Link to a contact or Name this contact), and from then on reports use the contact's name for every past and future message from them.

Identifying and linking a hidden chat ​

The card is shown at the end of the conversation itself, after the newest message, where it can be minimized to one line and goes away once the chat is identified, and also in the contact panel.

The card also helps work out who the person is, without ever asking WhatsApp:

  • "Have a phone number?" takes a number with its country code and looks it up in your workspace only (one contact becomes a Link to button, several are listed to choose from, a chat with that number but no contact offers Name this contact with this number, and a contact outside your sharing scope is reported without a name, with a note to ask a workspace manager)
  • Find by message takes a phrase from a message in another chat that may belong to the same person and searches your other one-to-one chats of the last 6 months for those exact words in that order, showing each matching chat with the message and the ones around it, an Open chat button to check, and Link to the contact behind it, five chats at most (add a word to narrow it)
  • Check on your phone explains how to copy a message from the chat (Copy a message lists the chat's recent texts), search it in WhatsApp on the connected phone to see a saved name or number there, and come back to link by number or by name, with a ready question to copy and send when you would rather ask the person

Name this contact can take a phone number too; a number another contact already holds is refused with a Link to that contact instead of a second record. The card opens with "WhatsApp has not shared their phone number with Spun." and those two buttons.

The "Have a phone number?" field and the other tools sit inside the "Need help identifying this chat?" row, which is collapsed for everyone until they open it, and Spun remembers that choice.

When the chat's WhatsApp profile name exactly matches one contact you can see, the card also asks, for example, "Is this Maria Lopez?" with a Link button; nothing is linked until you tap it, and two or more matches show nothing.

After a link the Chat linked toast offers Undo, and a Linked to strip with Unlink stays in that chat until you dismiss it. Undoing or unlinking also stops suggestions for that chat and contact for 30 days, so the same link is not offered again straight away; you can still link them by hand.

Every link, undo and name is listed in the Links tab of Contacts, where a link can also be confirmed or undone later.

When both records hold data, linking asks first: "Combine this chat's record with Maria Lopez?", then "Only continue if both belong to the same person. You cannot undo this yourself.", with the stage it will keep when there is one, "What happens to the records?" for the details, and Cancel or Link and combine.

A combine has no Undo and no strip. Nothing is linked until you confirm, and the search never contacts WhatsApp.

Missing messages and hidden members ​

On an ordinary chat whose number is known, the contact panel has a "Messages missing here?" line: enter a phrase from a message that seems to be missing and Spun searches the hidden-number chats for it, then Link to this contact attaches the hidden chat to the contact on screen; a hidden chat already linked to another contact can be moved here in one step when its own record is empty, and otherwise the card says to contact support rather than moving it.

Starting a private message to a hidden member from a group is not possible, because there is no number to start it with; a message in the group reaches them like everyone else.

A connected AI assistant with the Link Hidden-Number Chats to Contacts permission can suggest or make links and names too; a link or name a person set stays locked, and a contact the assistant named shows named by and the key's name until a person edits it.

An organization manager can also name a hidden member by telling Weave who they are and confirming the link, as described in Hidden-number members (docs.spun.com/guides/analyze-group-chats).

Pulling, adding and emailing contacts ​

If your phone has not sent its contacts to Spun yet after connecting, pulling contacts says so instead of reporting zero saved, and Spun keeps trying on its own.

In the first minutes after a new link, while WhatsApp is still delivering the address book, Spun reads the contact list again by itself until it stops growing, so contacts that arrive late are still added.

Right after a number is linked for the first time, the Contacts page says when the contact download starts (for example "Your contacts start downloading at 14:30 (in 2 h)"), and the pull button shows that time and waits until then.

Pressing the pull button while a contact pull is already running, including one Spun started by itself, does not start a second one: it says "A contact pull is already running. Showing its progress." and shows the progress of that pull.

Add Contact asks for a name plus a phone number or an email address (a name alone is refused, with the reason shown inline), and a More fields section takes company, job title, department and a note; if the address you enter already belongs to another contact you are told so, and the contact is still saved.

The contact card carries the email channel itself, so you can write to that person from the card with the same picker, the same checks and the same information dialog the conversation uses, and ask for suggested tasks from an email thread, without there being a WhatsApp conversation at all.

An address you enter on the card counts as the record of how you know them in the same way as one typed in the composer, so you are not asked to vouch for it a second time. Actions that need a WhatsApp number are simply not offered on a contact that has none.

Contact details in the side panel ​

The same contact details are also shown in the side panel of a conversation, so you do not have to leave the chat to read or change them. This section is shown to organization managers; people using the workspace in other roles do not see it.

If a teammate changes the contact while the section is open, it refreshes on its own unless you are in the middle of editing.

That section lists the phone number and email address you hold for the person, marks an address they have actually replied from as verified, states that a WhatsApp conversation is linked, and lists any other numbers and addresses on record with a note of where each one came from.

Below that are company, job title, department, birthday, website, address and a note about the person, plus any extra details you name yourself. A pencil turns the section into an editor and only the fields you actually changed are sent, so two people editing different fields do not overwrite each other.

The editor covers the email address itself, so you can add one, correct it, or empty the box to take it off the contact, alongside the other details. If another contact already uses the address you enter, you are told so with a link to that contact instead of the save being refused.

On a WhatsApp conversation that is not a saved contact yet, the section says No contact details yet with Add details; filling it in and saving is what creates the contact.

Someone with limited sharing sees only the contacts their shares reach, unless the share grants every contact of the inbox; when the shares reach no contact at all, the Contacts page explains which filters the access is limited to and whom to ask to widen it, instead of showing an empty list.

An organization manager can delete a contact from Spun, either with Delete at the bottom of the contact card or by ticking several contacts in the list and choosing Delete in the bar above it (up to 500 at a time). You are asked to confirm first, and it cannot be undone.

Deleting removes the contact record, its scheduled messages and its campaign history; the WhatsApp chats and messages stay, and the contacts on your phone are not touched. A contact you are not allowed to edit cannot be deleted either, and is reported as not deleted.

When the Contacts page shows only contacts saved in your phone and none came through, it says WhatsApp shared only numbers and profile names, and offers Show all contacts or How to bring in the names.

A connected AI assistant can read one contact's history as a single list with the contact timeline tool, which needs Read Contacts and Read Conversations: messages, stage moves, tasks, alarms, notes and identity events, newest first. On the Free plan the messages go back 7 days.

The guide Pipeline, Circles, reminders and the contact timeline for your AI assistant lists each tool, permission and refusal.

With Create & Update Contacts the assistant can also fill in company, birthday, address, website, tags and up to 30 of your own named details, and with Read Contacts it sees whether a contact opted out and can filter by it. No AI tool adds or removes the DONOTSEND label, and a send preview to an opted-out contact says it would be blocked.

The guide Scheduled messages, calendar, tasks, contact details and the auto-reply log for your AI assistant lists each tool, permission and refusal.

Contact Info in a chat also shows the contact's current local time under their number, worked out from the country of their phone number, so you can tell whether it is a reasonable hour to write to them. A country that spans several time zones is marked approximate, and no time is shown when the number gives no country.

At the top of Contact Info, clicking a saved name copies it (Name copied) and the pencil beside it edits it; on a chat with no saved name, clicking the title lets you type a name, on a hidden-number chat too. Clicking the number under the name copies it (Number copied).

On a hidden-number chat that line shows the chat's hidden ID instead: it copies as plain digits (ID copied) and is not a phone number.

How to use ​

  1. Open Contacts from the sidebar.
  2. Search or browse contacts; the list shows company and job title under each name, and the search box matches them too.
  3. Click a contact to view details, edit fields, or add notes, or use Add Contact to create one by hand with a name plus a phone number or an email address, and company, job title, department and a note under More fields.
  4. Use the import button to bulk-import from CSV; a large file is split into batches and uploaded automatically, so there is nothing to prepare.
  5. Inside the import dialog open "Where do I get a CSV file?" for the export steps for Gmail/Android, Outlook or iPhone.
  6. Check the preview before importing: it shows the phone, name, email, company, job title and birthday, a +N more chip for the rest of what the row carries, and greys out any row that has neither a phone nor an email.
  7. Contacts you already have are matched by phone number, or by email address when the row has no phone, and updated with the new details rather than duplicated, and an existing saved name is kept.
  8. When the import finishes, the summary reports how many contacts were created and updated, how many details were filled in, how many extra phones and emails were kept, and how many rows shared an email with an existing contact or matched more than one.
  9. To add someone you can only email, create the contact with an address and leave the phone empty, then use the Email row on the contact card to write to them.
  10. To read or change these details without leaving a conversation, open the side panel of the chat: the Contact details section is under the name and phone number.
  11. Press the pencil on that section to edit, fill in the email address, company, job title, department, birthday, website, address or a note, and press Save; emptying the email box takes the address off the contact.
  12. Add your own named details at the bottom under Other details, and remove one with the bin icon beside it.
  13. In a WhatsApp conversation that is not a saved contact yet, the section says No contact details yet; press Add details, fill it in, and the first Save creates the contact.
  14. To delete a contact, open its card and press Delete at the bottom, or tick several contacts in the list and press Delete in the bar above it, then confirm.

FAQ ​

  • Can my AI assistant see the full history of a contact?
  • How do I import contacts?
  • Where can I see contact details?
  • How to add notes to a contact?
  • How do I import my Outlook contacts?
  • How do I export contacts from Gmail or my iPhone?
  • Will importing a CSV create duplicates of contacts I already have?
  • Can I save a contact with only an email address?
  • How do I email a contact who is not on WhatsApp?
  • Where do I set a contact company, job title or birthday?
  • Can I edit contact details without leaving the chat?
  • How do I add or change a contact email address from the chat panel?
  • How do I remove an email address from a contact?
  • How do I add my own field to a contact?
  • Why does it say another contact uses this email?
  • What columns are in a contacts export?
  • Does exporting my contacts include extra phone numbers and emails?
  • Can I re-import a file I exported from Spun?
  • Why can I not save a contact with only a name?
  • Why do I not see Contact details in the chat panel?
  • What is the Not identified yet group in Contacts?
  • Why is a chat without a phone number not in the Not identified yet group?
  • Can I minimize the Who is this? card in a chat?
  • What does Is this and a name mean on a chat?
  • Can I undo linking a chat to a contact?
  • What does Link and combine do?
  • How do I find out who a hidden-number chat is?
  • Why is a chat titled with 5 digits and the word Hidden, and how do I find those chats?
  • What is the 5-digit code on a Hidden chat?
  • How do I see all chats with a hidden number?
  • Can I link a chat without a phone number by typing the number?
  • Some messages from a customer are in a chat with no number. How do I join them to the contact?
  • What does Find by message do?
  • Does Find by message or Have a phone number ask WhatsApp anything?
  • Why do some group members show as a hidden-number member?
  • Why did re-importing my Spun export not add Status as a field?
  • How do I delete a contact?
  • Does deleting a contact delete its chat?
  • Can my AI assistant fill in contact details?
  • Can my AI see who opted out?
  • Why does Contacts say my contacts start downloading later?
  • Why does Contacts say a contact pull is already running?
  • How do I copy a contact's name or number from the chat panel?
  • Why does the Contact details section of a new chat only say Add details?
Was this page helpful?

Spun Docs - the documentation for Spun, the WhatsApp team inbox by Spun Life LLC.