Links tab (who a hidden-number chat is)
At a glance
| Location | Sidebar → Contacts → Links tab; inbox top bar → Decisions pill (when decisions wait) |
| Plan | All plans, including the free tier |
| Related features | 3 |
What the Links tab shows
The Links tab in Contacts lists every change to who a hidden-number chat belongs to (a chat whose phone number WhatsApp has not shared with Spun): linked to a contact, unlinked, named or kept apart, and who did it.
It sits between Contacts and Bulk Labeling and is shown to team members who can see chats, once the WhatsApp Channel extension is installed.
A person's own links come from the "Who is this?" card in the chat; the Links tab is where the whole team can check them later, together with the links Weave, a connected AI assistant or Spun itself made.
Needs a decision and Recent changes
The tab opens on two parts. Needs a decision shows up to three cards that wait for a person, with See all for the rest. Recent changes lists the newest 20 changes, newest first, and keeps loading older ones as you scroll (Show older changes when it does not).
More opens a search box, a Kind filter, a Who filter (Everyone, Teammates, All API keys, Automatic), the confidence chips certain, probable and candidate, and What happened for a fuller account of each change.
What a row means
Each row says what changed and who did it, for example a chat linked to Maria Lopez with Dana, 10:42, tapped in the card, API key Sales assistant for a connected AI assistant, Weave, confirmed by Dana when a manager confirmed a Weave card, or automatic, WhatsApp lookup when Spun linked it on its own.
An undone link reads "Link to Maria Lopez undone, suggestions for this pair paused for 30 days". A name reads Dana named this contact Maria Lopez, with Undo name; undoing a name shows Name removed, system label restored or Name restored to the earlier name.
A row created by a stage move or by naming says Contact created from a stage move or Contact created when Dana named it. A Records combined row (one record combined into another) explains what happened and offers Contact support, because combining cannot be undone from here.
Undo, the 30-day pause and Confirm link
Undo is on the row of a link that is still current: "Undo and stop suggestions for this pair for 30 days" unlinks the chat and pauses every suggestion for that chat and contact for 30 days ("Link undone. Suggestions for this pair stopped for 30 days."); you can still link them by hand at any time.
A link that was undone afterwards is tagged undone later, and a row edited since shows Edited since, Undo unavailable.
Confirm link marks a link made by an assistant or automatically as checked by a person (Link confirmed); a confirmed link is locked against assistants and automation, and changing a link someone confirmed asks first ("This link was confirmed by Dana on 11/08. Change it?").
Suggestions, conflicts and the Decisions pill
Needs a decision holds two kinds of card.
A suggestion ("Sales assistant suggests: this chat is Maria Lopez") comes from an AI assistant that found evidence but could not link on its own, usually because both records already hold data; choose Link, Not this one (hides this suggestion for 7 days) or Keep separate (stops suggestions for this pair for 30 days).
A conflict ("This chat is linked to Maria Lopez, later evidence says David Cohen") appears when new evidence disagrees with a current link; choose Keep current link, Change link to the other contact, or Neither (unlink and keep separate). Only a person settles a conflict.
When cards are waiting, an amber Decisions pill appears beside Unanswered, Unread, Waiting, Alarms, Overdue and Stale at the top of the inbox and opens the Links tab; it is hidden when nothing waits.
The named by marker
A contact named by a connected AI assistant shows named by and the key's name next to it in the chat list and the chat header until a person edits the name, so you can tell a name a person typed from one an assistant gave. A link or a name a person set is never changed by an assistant or by automation.
Connected AI assistants
Connected AI assistants reach this through ten MCP tools. Reading (get_chat_identity, list_identity_candidates, list_identity_changes, list_identity_decisions) needs Read Contacts; find_chat_by_message and list_unidentified_chats also need Read Conversations.
Changing (link_chat_to_contact, unlink_chat, name_hidden_contact, keep_contacts_separate) needs the permission "Link Hidden-Number Chats to Contacts (name, link, unlink, keep apart; links a person set stay locked)" in Settings → AI Assistant (MCP), which is never part of an all-permissions key and must be ticked on purpose.
All ten are on the Free plan; the four changes do not count toward the monthly Connected AI calls but are limited to 50 attempts per key and 200 per organization an hour, with 3 open suggestions per chat and 20 per key.
Each change carries a 10 to 200 character reason that shows in the Links tab, and repeating the same change within 24 hours changes nothing. Every tool and refusal is explained at docs.spun.com/guides/mcp-identity-tools.
How to use
- Open Contacts from the sidebar and choose the Links tab.
- Read Needs a decision first: for a suggestion choose Link, Not this one (hidden for 7 days) or Keep separate (paused for 30 days); for a conflict choose Keep current link, Change link or Neither.
- Scroll Recent changes to see who linked, unlinked or named which chat.
- Press Undo on a link that is wrong: it unlinks the chat and stops suggestions for that pair for 30 days.
- Press Confirm link on a link an assistant or Spun made once you have checked it; a confirmed link stays locked.
- Press Undo name on a name that is wrong to restore the previous name or the system label.
- Open More to search, filter by kind, by who made the change (teammates, API keys, automatic) or by confidence, and to read What happened.
- Tap the amber Decisions pill at the top of the inbox to jump straight to the cards waiting for you.
- To let a connected AI assistant make links, tick Link Hidden-Number Chats to Contacts on its key in Settings → AI Assistant (MCP).
Related features
FAQ
- What is the Links tab in Contacts?
- Who linked this chat to this contact?
- How do I undo a link an AI assistant made?
- What does suggestions for this pair paused for 30 days mean?
- What does Confirm link do?
- What is the Decisions pill?
- What is the difference between Not this one and Keep separate?
- What does it mean when later evidence says a chat is someone else?
- Why does a contact say named by and a key name?
- Can my AI assistant link hidden-number chats to contacts?
- Which permission lets an AI assistant link chats?
- Can an AI assistant change a link I made?
- Why can I not undo a Records combined row?
- Are the hidden-number tools on the Free plan?