# Open a Number in Inspector

> Open a test number or a real Number in Inspector as a persistent linked device.

Inspector opens a Number as a linked device on your computer, so you can see
and use the conversations from the WhatsApp side. With test numbers, this is
how you see the other side of a test conversation.

The Polymorfa account that first pairs a Number in Inspector claims it. A claim
adds no team, project or Number permissions; those still
come from your live team membership and project role.

> **Note**
>
> **Before you begin.** [Install and authorize Inspector](https://docs.polymorfa.com/testing/inspector/install).
> Inspector requires access. To open a real Number, it needs a connected Linked
> Devices connection; a Meta Cloud API connection alone can't be opened.

## Open a Number

1. Choose **Open a number** in the title bar, or press ⌘T on macOS or Ctrl+T on
   Windows and Linux.
2. Select the team that owns the project.
3. Find the Number under its project, or type its name, phone, project or
   Customer in the search field.
4. Choose **Open**. If the Number is already open on this computer, choose
   **Switch to tab**.

Inspector opens the Number as a linked device in a new tab.

### Account type

Rows show **WhatsApp**, **WhatsApp Business**, **Official API**, or **WhatsApp
Business + API** separately from Test or Production. **Unknown** means Inspector
could not identify the account type; it does not confirm access or a connection.

**Open** is disabled for an Official API-only Number because that connection
cannot open WhatsApp Web. The row stays visible with **Cannot open WhatsApp
Web**. An existing tab keeps **Switch to tab** and its normal access checks.
App and coexistence Numbers still need an eligible Linked Devices connection
and your current permissions.

### Open a real Number

Before a real Number opens for the first time, Inspector asks **Open a
production number?** and names the Number, its phone, project and team.
Messages you send from it reach real WhatsApp contacts. **Cancel** is selected
first; Escape also cancels. Choose **Open production number** to continue.
Inspector remembers the choice for that Number only, and nothing opens until
you answer.

If its Linked Devices connection needs pairing again, complete that step before
you reopen Inspector.

### If a Number doesn't open

Inspector keeps the Number on screen with the reason, instead of returning to
the list. Choose **Retry** to try again, or **Back to numbers**. When access
changed or your sign-in expired, Inspector offers **Refresh access** or **Sign
in again** instead.

## Verify the connection

The Number's chats load and its tab's status dot turns green. The Console shows **Owned
by _name_** with your account photo when available, and other members see **In
use by _name_** in Inspector. Send a message from another test
number in the project; it appears in the open chat.

Closing the window, restarting the app, retrying a failed connection or signing
out of the Console keeps the linked device. Reopening the Number on the same
computer reconnects without pairing again.

Other authorized project members can see the owner but cannot silently replace
them. Raw device identifiers are not shown.

## Find a Customer's Numbers

Inspector shows each Number's assigned Customer on its row. Type the Customer's
name in the **Open a number** search field to list only the Numbers assigned to
that Customer. Customer and the inline **In use by** notice and owner avatar are separate: the Customer
is the person or business the Number belongs to, and the owner is the Inspector
user who controls the linked device.

Inspector accepts a Customer assignment only when it belongs to the selected
project and Number. If that changes while a Number opens, Inspector stops
instead of showing the wrong Customer. A valid assignment is kept when the app
reconnects.

## Unclaim a Number

Unclaim the Number before another team member pairs it in Inspector. You can
release your own claim. A team owner or admin can release another member's
claim. A claim cannot be transferred directly to another person.

In the Console, open **Numbers**. The **Claimed by** column shows each
Number's claimant. When you can release the claim, **Unclaim** appears under
the claimant's name and in the Number's actions menu, which is also available
on narrow screens. Select it and confirm. Unclaiming your own Number removes
your Inspector device for it. Unclaiming another member's Number removes their
Inspector device and signs them out of that Number.

To unclaim through the API, use [Unclaim a Number in Inspector](https://docs.polymorfa.com/api/numbers/release-inspector-claim).
A test Number requires `sandbox:write`; a real Number requires `sessions:manage`.
A project token is limited to its own project. A Number-restricted credential
cannot unclaim a Number.

Read the Number's `inspector.claim.claimedAt` and send it as `expectedClaimedAt`
with your request. If the claim changed, the request returns `409`. Read the
Number again and check the new claim before retrying. If device removal cannot
be confirmed, the request returns `503` with `Retry-After`. Wait for that
interval, then retry with the same expected claim time. An already unclaimed
Number returns `released: false`.

The claim is released after the claimant's Inspector devices are revoked.
The next claimant must pair again. Unclaiming a real Number removes only its
Inspector companion; the phone and Polymorfa's linked device stay connected.
Releasing another member's claim sends them a Console notification.

Removing a test number closes its Inspector connections, invalidates retained
devices and clears its simulated account. Closing Inspector, retrying and
signing out keep the linked device.

## Troubleshooting

- Choose **Check again** on an empty project, or refresh the sidebar, when a new
  test number doesn't appear.
- Confirm that the selected team still owns the project.
- Confirm the Number doesn't show **In use by** another member.
- If **Open** fails, retry once, then follow
  [Inspector troubleshooting](https://docs.polymorfa.com/testing/inspector/troubleshooting).

## See also

- [Test numbers](https://docs.polymorfa.com/testing/test-numbers)
- [Phone controls](https://docs.polymorfa.com/testing/phone-controls)
- [Install Inspector](https://docs.polymorfa.com/testing/inspector/install)
