> ## Documentation Index > Fetch the complete documentation index at: https://docs.pilotstatus.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Linhas telefônicas no painel > As telas de Linhas telefônicas do painel: a lista de linhas, a página de cada linha com o código de ativação, a compra em três etapas, os webhooks das linhas e as partes de Planos que mostram o que as linhas cobram. As linhas telefônicas ficam em **Linhas telefônicas**, na barra lateral, logo abaixo de **Números** (atalho de teclado: `i`). O item aparece para **Proprietário e Administrador**; Atendente e Analista não veem as linhas, porque a página de uma linha mostra o código de ativação do WhatsApp, e esse código é uma credencial. Para os mesmos papéis, a página **Números** também tem um card **Linhas telefônicas**, com **Ir para Linhas**. Comprar, pagar em atraso, cancelar e devolver são ações só do **Proprietário**. O passo a passo completo, da verificação do titular até digitar o código no WhatsApp, está no guia [Linhas telefônicas: comprar e usar no WhatsApp](/pt-BR/guides/phone-lines). ## Lista de linhas A página **Linhas** (`/linhas`) lista as linhas que ainda são suas — ativas, com pagamento pendente ou suspensas. Uma linha devolvida ou cancelada sai da lista. No topo ficam **Webhooks das linhas** e **Comprar linha**, e um resumo como **3 linhas · 1 precisa de atenção**. A lista começa pelo que pede ação: primeiro as suspensas, depois as com pagamento pendente, depois as com cancelamento agendado, e o resto pela data de renovação. Cada linha mostra o nome (ou o número, se ela não tiver nome), o DDD e uma destas situações: | Situação | O que a linha mostra | | - | - | | **Ativa** | A data da próxima renovação e quantos códigos a linha já pediu. | | **Pagamento pendente** | A data em que a renovação falhou. A linha continua recebendo códigos. | | **Suspensa** | A data da suspensão. A linha não recebe códigos novos. | | **Cancelamento agendado** | Até quando a linha fica ativa. | Na página da linha aparecem também **Devolvida** e **Cancelada**, as duas situações finais. ### Avisos no topo da lista * **Linhas sem pagamento** — um aviso vermelho (**Uma linha precisa de pagamento**, ou **… linhas estão suspensas ou sem pagamento**) diz até quando regularizar. Para o Proprietário, traz **Adicionar saldo**, **Pagar tudo** e, quando há mais de uma linha em atraso, **Escolher quais manter**; um Administrador vê o aviso com **Só o dono do workspace pode pagar ou escolher quais linhas manter.** Veja [Preço e cobrança das linhas](/pt-BR/phone-lines-pricing#linhas-em-atraso). * **Sua verificação está em análise** — você já pode usar as linhas normalmente enquanto a Pilot Status confere o documento. Se a conferência não passar, as linhas compradas durante a análise voltam para a operadora e o valor pago por elas volta como saldo na carteira. * **Pedimos outro documento para concluir a verificação do titular.** — **Enviar documento** leva de volta à verificação. * **A verificação do titular foi recusada.** — as linhas compradas durante a análise voltam para a operadora 3 dias após a recusa, e o que você pagou por elas volta como saldo na carteira; até lá, seguem ativas e não renovam. Não é possível comprar novas linhas — **Comprar linha** avisa e indica o suporte. Veja o [guia](/pt-BR/guides/phone-lines#passo-a-passo). Os avisos de verificação aparecem só para o Proprietário. ## Comprar linhas **Comprar linha** abre `/linhas/comprar`, em três etapas: 1. **Verificação** — só aparece enquanto o titular não estiver verificado: CNPJ ou CPF, WhatsApp do titular (com seletor de país, o Brasil já selecionado), documento e os códigos de confirmação. A mesma verificação também pode ser feita [pela API](/pt-BR/api/phone-lines/verification). 2. **Números** — escolha o DDD, clique em **Buscar números** e marque até 10. 3. **Confirmar** — o preço por linha, o **Total agora** e o botão **Comprar**. Depois da compra, o resultado aparece por número, com **Ver linha** para cada linha comprada. Se algum número falhar por falta de saldo, **Adicionar saldo e tentar de novo** abre a recarga, por Pix ou cartão, e volta à confirmação com os mesmos números. Cada etapa está explicada no [guia](/pt-BR/guides/phone-lines#passo-a-passo). ## Página da linha Clique numa linha para abrir a página dela (`/linhas/{id}`). ### Cabeçalho * **O nome da linha**, com o **lápis** (**Editar nome**) ao lado. O nome é opcional, tem até 60 caracteres e, em branco, a linha aparece pelo número. Com nome, o número aparece logo abaixo. * **DDD · ativa desde … · renova …** — a data da compra e a da próxima renovação. * **A situação** e, para o Proprietário, **Cancelar linha** (linha em dia) ou **Devolver número** (linha em atraso). Veja [Cancelar ou devolver](#cancelar-ou-devolver). ### Pagamento pendente ou suspensa Uma linha com pagamento pendente mostra **Não conseguimos cobrar … em …**, com as datas exatas em que ela será suspensa e em que o número será devolvido, e os botões **Adicionar saldo** e **Pagar … agora**. Uma linha suspensa mostra **Linha suspensa por falta de pagamento**, com a data em que o número será devolvido, e os botões **Adicionar saldo** e **Pagar … e reativar**. **Pagar … agora** e **Pagar … e reativar** cobram **só esta linha**. Se houver outras linhas em atraso, a página avisa (**Outra linha também está sem pagamento** ou **Outras … linhas também estão sem pagamento**), com **Ver e pagar todas**, que leva à lista — lá, **Pagar tudo** cobra todas de uma vez. ### Código de ativação O quadro do código tem o botão **Esperar novo código**, que prepara a linha para receber a ligação do WhatsApp. Ele fica desativado enquanto um pedido está aguardando ou sendo lido, e numa linha suspensa. Depois de clicar, o quadro passa por estes estados: | O que o painel mostra | O que significa | | - | - | | **Aguardando** — **Esperando a ligação da Meta** | A linha espera a ligação por 5 minutos, com o **Tempo restante**. No WhatsApp, toque em **Me ligue**. **Cancelar espera** encerra o pedido. | | **Lendo** — **A ligação chegou — lendo o código…** | O áudio está sendo transcrito. Dá para ouvir a gravação enquanto isso. | | O código, com **Copiar** | **Último código** e a hora em que chegou. Digite-o no WhatsApp. | | **Recebemos a ligação, mas não conseguimos ler o código** | Ouça a gravação logo abaixo. | | **Nenhuma ligação chegou** | A janela fechou sem ligação. O quadro lista os motivos mais comuns e oferece **Esperar de novo**. | | **Espera cancelada** | O pedido foi cancelado. Clique em **Esperar novo código** antes de pedir o código de novo no WhatsApp. | | **Não conseguimos capturar a ligação** | A ligação chegou, mas o áudio não pôde ser guardado. Peça o código de novo. | ### Histórico de códigos Abaixo do quadro fica o **Histórico de códigos**: os 20 pedidos mais recentes, com **Quando**, **Código**, **Áudio** (**Ouvir**) e **Situação** — **Aguardando**, **Lendo o código**, **Recebido** (com o código, ou com "—" quando a ligação não trazia um código de 6 dígitos), **Áudio recebido** (a ligação chegou, mas a leitura falhou), **Não chegou**, **Cancelada** ou **Falhou**. Numa linha suspensa, o histórico fica **somente leitura**. Quando o número volta à operadora — devolvido ou cancelado —, os códigos e as gravações da linha são apagados, e a página dela não mostra mais o histórico. ### Cancelar ou devolver **Cancelar linha** e **Devolver número** abrem uma confirmação que explica o que acontece — o número volta ao estoque da operadora, sem garantia de que você consiga comprá-lo de volta, e com ele vão o histórico de códigos e as gravações — e pede para digitar o número da linha. * **Cancelar linha** (linha em dia) agenda o cancelamento para o fim do mês já pago, sem reembolso. A página passa a mostrar **Cancelamento agendado: a linha fica ativa até …**, com **Desistir do cancelamento**. * **Devolver número** (linha em atraso) devolve o número à operadora na hora. Você volta para a lista, com o aviso **… foi devolvido**: **O histórico de códigos e os áudios foram apagados. Não há cobrança pendente para esta linha.** Depois que o número volta à operadora, a página da linha só informa que ela não pertence mais a você. ## Escolher quais linhas manter Com mais de uma linha em atraso, **Escolher quais manter** abre uma lista com as linhas sem pagamento, o saldo da carteira e quantas delas o saldo cobre. Marque as que quer manter e clique em **Manter … e devolver …**: * as linhas marcadas são cobradas na hora; * as **não marcadas são devolvidas na hora**, sem volta. Se alguma linha marcada não puder ser cobrada, o painel avisa; adicione saldo e tente de novo. ## Webhooks das linhas **Webhooks das linhas** (`/linhas/webhooks`), no topo da lista, é o cadastro de webhooks do produto Linhas — separado dos webhooks de números: um webhook de números nunca recebe eventos de linha. Proprietário e Administrador gerenciam. * **Novo webhook** — um nome opcional (até 100 caracteres; em branco, vira o host da URL), a URL `https` e os eventos: **Todos os eventos das Linhas** ou os que você escolher (**Linha comprada**, **Áudio da ligação recebido**, **Código recebido**, **Código não obtido**, **Linha renovada**, **Cobrança falhou**, **Linha suspensa**, **Número devolvido**, **Linha cancelada**, **Verificação atualizada**). Uma URL que aponte para um endereço interno ou de rede privada é recusada ao salvar. * **Segredo de assinatura** — aparece **uma única vez**, logo depois de criar. Guarde-o: as entregas são assinadas com o cabeçalho `x-pilot-status-signature`. Editar o webhook não troca o segredo, e não há rotação; para trocar, crie um webhook novo e exclua o antigo. * **Editar webhook**, **Inativar** / **Ativar** e **Deletar** — um webhook inativo aparece como **Pausado** e não recebe entregas; deletar para as entregas para aquela URL na hora. * **Entregas** — escolha um webhook para ver as entregas mais recentes (até 50): **Quando**, **Evento**, **Situação** (**Pendente**, **Entregue**, **Falhou**), **Resposta** e **Tentativas**. Clicar numa entrega abre os detalhes, com o corpo enviado. Os contadores do topo mostram **Total de Webhooks**, **Ativos** e **Inativos** — ou, com um webhook escolhido, **Total de entregas**, **Entregues** e **Falhas** das entregas listadas. Os eventos de uma linha trazem o nome dela, e **Áudio da ligação recebido**, **Código recebido** e **Código não obtido** trazem também `audioUrl`, o endereço da gravação da ligação, que o seu sistema baixa com a chave da API. Payloads, verificação da assinatura e retentativas: [Webhooks das linhas](/pt-BR/api/phone-lines/webhooks). ## As linhas em Planos Em **Planos** (barra lateral), três abas mostram o dinheiro das linhas: * **Financeiro → Cobranças das Linhas** — o saldo da carteira, se ele cobre as renovações dos próximos 7 dias, a próxima renovação de cada linha com quem vai pagá-la (**Carteira paga**, **Cartão salvo paga**, **Carteira + cartão** ou **Saldo insuficiente**) e o **Histórico de cobranças**, com período, situação (**Paga**, **Falhou**, **Pendente**, **Estornada**), tentativas e a próxima tentativa. Uma cobrança **Estornada** diz o motivo — por exemplo, **Verificação do titular recusada; o valor voltou para a carteira.** Na mesma aba, **Gastos consolidados** separa o que foi gasto em **Linhas telefônicas**, e **Recibos e faturas** traz um **Comprovante** de cada cobrança paga. * **Carteira** — o **Extrato** da carteira tem os botões **Todos**, **WhatsApp** e **Linhas**, para filtrar por produto. As linhas aparecem como **Compra** (primeiro mês) e **Mensalidade** (renovações). * **Histórico** — a trilha de eventos de cobrança inclui os das linhas: **Linha comprada**, **Mensalidade da linha paga**, **Cobrança da linha falhou**, **Mensalidade da linha estornada**, **Linha suspensa por falta de pagamento**, **Linha reativada**, **Linha devolvida** e **Linha cancelada**, cada um com o nome e o número da linha. Detalhes em [Preço e cobrança das linhas](/pt-BR/phone-lines-pricing). ## Quem recebe os avisos Os avisos das linhas vão para os contatos do **titular** informados na verificação e para o **Proprietário** do workspace; os outros membros do workspace não recebem. Eles cobrem a compra, as renovações das próximas 48 horas, a renovação paga, a renovação que falhou, a véspera da suspensão, a suspensão, a reativação, a devolução, o cancelamento agendado que se concretizou, o saldo que não cobre as renovações dos próximos 7 dias e a verificação do titular (pedido de outro documento, aprovação, recusa). Todos vão por e-mail. Alguns vão também por WhatsApp, e só para um número confirmado: o WhatsApp do titular confirmado na verificação e o telefone do Proprietário quando ele está verificado no perfil. O mesmo endereço nunca recebe o mesmo aviso duas vezes. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.