i). The item shows for Owner and Admin; Agent and Analyst do not see lines, because a line’s page shows its WhatsApp activation code, and that code is a credential. For the same roles, the Numbers page also has a Phone lines card, with Go to phone lines.
Buying, paying overdue lines, cancelling and returning are Owner-only actions. The full walkthrough, from the holder verification to typing the code into WhatsApp, is in the guide Phone lines: buy one and use it on WhatsApp.
Lines list
The Phone lines page (/linhas) lists the lines that are still yours — active, payment due, or suspended. A returned or cancelled line leaves the list.
At the top are Line webhooks and Buy a line, and a summary such as 3 lines · 1 needs attention. The list starts with what needs action: suspended lines first, then payment due, then cancellation scheduled, and the rest by renewal date.
Each line shows its name (or its number, if it has no name), its area code, and one of these statuses:
A line’s page can also show Returned and Canceled, the two final statuses.
Notices at the top of the list
- Unpaid lines — a red notice (One line needs payment, or … lines are suspended or unpaid) says by when to settle. For the Owner, it has Add balance, Pay for all and, when more than one line is overdue, Choose which to keep; an Admin sees the notice with Only the workspace owner can pay or choose which lines to keep. See Phone line pricing and billing.
- Your verification is under review — you can already use your lines normally while Pilot Status checks the document. If the check does not pass, the lines bought during the review go back to the carrier and what you paid for them returns to your wallet as balance.
- We need another document to finish the account holder verification. — Send document takes you back to the verification.
- The account holder verification was rejected. — the lines bought during the review go back to the carrier 3 days after the rejection, and what you paid for them returns as wallet balance; until then they stay active and do not renew. New lines cannot be bought — Buy a line says so and points you to support. See the guide.
Buying lines
Buy a line opens/linhas/comprar, in three steps:
- Verification — only shows while the account holder is not verified: CNPJ or CPF, the holder’s WhatsApp number (with a country selector, Brazil preselected), the document and the confirmation codes. The same verification can also be done through the API.
- Numbers — pick the area code, click Search numbers and select up to 10.
- Confirm — the price per line, the Total now and the Buy button. After the purchase, the result is shown per number, with Open line for each line bought. If a number failed for lack of balance, Add balance and try again opens the top-up, by Pix or card, and goes back to the confirmation with the same numbers.
Line page
Click a line to open its page (/linhas/{id}).
Header
- The line’s name, with the pencil (Edit name) next to it. The name is optional, up to 60 characters and, left blank, the line shows its number. With a name, the number shows right below it.
- Area code · active since … · renews … — the purchase date and the next renewal date.
- The status and, for the Owner, Cancel line (line in good standing) or Return number (overdue line). See Cancel or return.
Payment due or suspended
A line with payment due shows We could not charge … on …, with the exact dates on which it will be suspended and the number returned, and the Add balance and Pay … now buttons. A suspended line shows Line suspended for non-payment, with the date the number will be returned, and the Add balance and Pay … and reactivate buttons.Pay … now and Pay … and reactivate charge this line only. When other lines are overdue too, the page says so (Another line is also unpaid or … other lines are also unpaid), with See and pay all, which takes you to the list — there, Pay for all charges them all at once.
Activation code
The code panel has the Wait for a new code button, which prepares the line to receive the WhatsApp call. It is disabled while a request is waiting or being read, and on a suspended line. After you click it, the panel goes through these states:Code history
Below the panel is the Code history: the 20 most recent requests, with When, Code, Recording (Listen) and Status — Waiting, Reading the code, Received (with the code, or with ”—” when the call carried no 6-digit code), Recording received (the call arrived, but reading it failed), Did not arrive, Canceled or Failed. On a suspended line, the history is read only. When the number goes back to the carrier — returned or cancelled — the line’s codes and recordings are deleted, and its page no longer shows the history.Cancel or return
Cancel line and Return number open a confirmation that explains what happens — the number goes back to the carrier’s stock, with no guarantee you can buy it back, taking the code history and the recordings with it — and asks you to type the line’s number.- Cancel line (line in good standing) schedules the cancellation for the end of the month already paid, with no refund. The page then shows Cancellation scheduled: the line stays active until …, with Undo cancellation.
- Return number (overdue line) returns the number to the carrier right away. You go back to the list, with the notice … was returned: The code history and the recordings were deleted. There is no pending charge for this line.
Choose which lines to keep
With more than one overdue line, Choose which to keep opens a list of the unpaid lines, the wallet balance and how many of them the balance covers. Check the ones you want to keep and click Keep … and return …:- the checked lines are charged right away;
- the unchecked ones are returned right away, for good.
Line webhooks
Line webhooks (/linhas/webhooks), at the top of the list, is the webhook registry of the Phone Lines product — separate from the number webhooks: a number webhook never receives line events. Owner and Admin manage it.
- New webhook — an optional name (up to 100 characters; left blank, it becomes the URL’s host), the
httpsURL and the events: Every phone line event or the ones you pick (Line purchased, Call audio received, Code received, Code not obtained, Line renewed, Charge failed, Line suspended, Number returned, Line canceled, Verification updated). A URL pointing to an internal or private-network address is refused on save. - Signing secret — shown only once, right after creation. Keep it: deliveries are signed with the
x-pilot-status-signatureheader. Editing the webhook does not change the secret, and there is no rotation; to change it, create a new webhook and delete the old one. - Edit webhook, Deactivate / Activate and Delete — an inactive webhook shows as Paused and gets no deliveries; deleting stops deliveries to that URL right away.
- Deliveries — pick a webhook to see its most recent deliveries (up to 50): When, Event, Status (Pending, Delivered, Failed), Response and Attempts. Clicking a delivery opens its details, with the body that was sent.
audioUrl, the address of the call recording, which your system downloads with the API key.
Payloads, signature verification and retries: Phone line webhooks.
Lines under Plans
Under Plans (sidebar), three tabs show the money side of the lines:- Finance → Phone line charges — the wallet balance, whether it covers the renewals of the next 7 days, each line’s next renewal with who will pay it (Wallet pays, Saved card pays, Wallet + card or Balance too low), and the Charge history, with period, status (Paid, Failed, Pending, Refunded), attempts and the next attempt. A Refunded charge says why — for example, Holder verification rejected; the amount went back to the wallet. On the same tab, Consolidated spend breaks out what was spent on Phone lines, and Receipts and invoices has a Payment proof for every paid charge.
- Wallet — the wallet Statement has All, WhatsApp and Phone lines buttons to filter by product. Lines show up as Purchase (first month) and Monthly fee (renewals).
- History — the trail of billing events includes the lines’: Line purchased, Line monthly fee paid, Line charge failed, Line monthly fee refunded, Line suspended for non-payment, Line reactivated, Line returned and Line canceled, each with the line’s name and number.