Skip to content
Shortcut: /, ⌘K or Ctrl+K

Open a Number in Inspector

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

View as Markdown

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.

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. 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.

See also#