> ## 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: comprar e usar no WhatsApp > Alugue um número fixo brasileiro pelo painel, verifique o titular, escolha o DDD, pague pela carteira ou pelo cartão e veja na tela o código de 6 dígitos que o WhatsApp manda por ligação. Uma **linha telefônica** é um número fixo brasileiro de verdade que você aluga da Pilot Status para **ativar uma conta do WhatsApp** nele, sem chip. Quando o WhatsApp verifica o número, ele liga para a linha; a Pilot Status recebe a ligação, transcreve o áudio e mostra o código de 6 dígitos na tela da linha. A linha **só recebe ligações**. Ela não faz chamadas e, por ser fixa, **não recebe SMS**: no WhatsApp, o código precisa ser pedido **por ligação** (**Me ligue**). Esperar pelo SMS só gasta a janela de espera. A linha é um produto à parte dos números de WhatsApp: comprar uma não cria nem conecta um número no seu workspace. Ela está disponível em **todos os planos, inclusive o Free**, e o preço é o mesmo em qualquer plano e para qualquer quantidade — veja [Preço e cobrança das linhas](/pt-BR/phone-lines-pricing). Este guia descreve o fluxo do painel. Para fazer o mesmo por código, veja a [API de Linhas telefônicas](/pt-BR/api/phone-lines/overview). ## Quem pode fazer o quê As linhas ficam em **Linhas telefônicas**, na barra lateral, logo abaixo de **Números**. O item só aparece para Proprietário e Administrador: o código de ativação é uma credencial — quem o tiver pode registrar uma conta do WhatsApp na linha. | Ação | Proprietário | Administrador | Atendente e Analista | | - | :-: | :-: | :-: | | Ver as linhas, os códigos e as gravações | ✅ | ✅ | — | | Pedir um código, cancelar a espera, dar nome à linha | ✅ | ✅ | — | | Gerenciar os webhooks das linhas | ✅ | ✅ | — | | Verificar o titular e comprar linhas | ✅ | — | — | | Pagar linhas em atraso e escolher quais manter | ✅ | — | — | | Cancelar, desistir do cancelamento ou devolver uma linha | ✅ | — | — | ## Antes de começar * **Saldo na carteira ou um cartão salvo.** A compra sai primeiro da carteira pré-paga; o cartão salvo cobre o que faltar. * **Os dados do titular**, pedidos só na primeira compra: o CNPJ ou o CPF, um documento em PDF, JPG, PNG ou WEBP de até 10 MB, e um WhatsApp para receber o código de confirmação. ## Passo a passo Sem nenhuma linha, a página mostra o botão **Comprar linha** já com o preço mensal (por exemplo, **Comprar linha · R\$ 33,90/mês**). Com linhas, o botão **Comprar linha** fica no topo da página. A compra tem três etapas: **Verificação**, **Números** e **Confirmar**. Com o titular já verificado, a etapa **Verificação** vem marcada como concluída e a compra começa nos números. Linha telefônica é serviço regulado, e a verificação do titular é responsabilidade da Pilot Status perante a operadora. Ela é pedida uma única vez, para o workspace inteiro. Também dá para fazê-la por código, com a [API de verificação do titular](/pt-BR/api/phone-lines/verification) — é a mesma verificação. 1. Em **Você está comprando como**, escolha **Empresa · CNPJ** ou **Pessoa física · CPF**. 2. Digite o documento. O CNPJ pode ter letras e números, no formato alfanumérico da Receita — digite como aparece no cartão CNPJ. 3. Informe o **WhatsApp do titular**: escolha o país (DDI) no seletor do campo — o Brasil (+55) já vem selecionado — e digite o número; para um número do Brasil, com o DDD. Clique em **Continuar**. Para CNPJ, a Pilot Status consulta a Receita na hora. **Um CNPJ que não está ativo, ou que nenhuma base pública encontra, não pode comprar linhas.** Se a consulta estiver fora do ar, a verificação segue pelo documento e é conferida manualmente. Para CPF, a conferência é feita só pelo documento. Depois, na mesma tela, em qualquer ordem: * **Documento** — arraste o arquivo ou clique para escolher. Para CNPJ: cartão CNPJ, contrato social ou comprovante de inscrição. Para CPF: RG, CNH ou comprovante de inscrição no CPF, com o número legível. O documento é lido automaticamente. Enquanto os contatos ainda não foram confirmados, um arquivo em que não dá para ler o número com segurança (reflexo, foto tremida, corte, baixa resolução) faz o painel pedir um novo envio; um documento que a leitura automática não confirma vai para análise manual. * **Contatos** — digite o código de 6 dígitos que chega no WhatsApp informado, enviado pelo WhatsApp da Pilot Status. Se o e-mail da sua conta ainda não foi confirmado, um segundo código chega por e-mail. Se, no momento em que você começa a verificação, a Pilot Status não tiver um remetente de WhatsApp disponível, o código vai só por e-mail e o WhatsApp informado fica registrado sem confirmação — o painel avisa. O código vale **10 minutos**, aceita até **5 tentativas erradas**, e um novo pode ser pedido a cada **60 segundos** (**Não recebeu? Reenviar código**). Esse código confirma **você**. Não confunda com o **código de ativação** do WhatsApp, que chega depois, por ligação, na linha que você comprar. Enquanto os contatos não forem confirmados, **Corrigir dados** volta ao formulário. Quando o documento e os contatos estão enviados, a verificação é **aprovada** e o painel segue direto para a escolha dos números — ou fica **em análise** (**Verificação em análise — você já pode comprar**): a equipe da Pilot Status confere o documento manualmente, e você compra e usa as linhas normalmente enquanto isso. 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. A análise manual termina de um destes jeitos, e o titular e o proprietário do workspace recebem um aviso: | Resultado da análise | O que significa | | - | - | | Aprovada | Nada muda para você. | | Outro documento solicitado | O topo da lista de linhas mostra **Pedimos outro documento para concluir a verificação do titular.**, com **Enviar documento**. As linhas já compradas continuam funcionando; novas compras esperam o novo envio. | | Recusada | Não é possível comprar novas linhas. As linhas compradas durante a análise continuam funcionando por **3 dias** depois da recusa, sem renovar; nessa data elas voltam para a operadora, com o histórico de códigos apagado, e tudo o que foi pago por elas — compra e renovações, inclusive a parte cobrada no cartão — volta como saldo na carteira. O aviso da recusa informa a data e o valor. Para qualquer dúvida, fale com o suporte. | Escolha o **DDD** — dá para buscar pelo número do DDD, pela sigla ou pelo nome do estado — e clique em **Buscar números**. O painel lista números disponíveis naquele DDD; clique nos que quiser. Você escolhe **até 10 números por compra**. Para mais, faça outra compra depois desta — não há limite de linhas por workspace. Se o DDD não tiver números disponíveis no momento, tente outro. A tela **Confirme a compra** lista cada número com o preço mensal e o **Total agora**. Antes de clicar em **Comprar**, saiba que: * **O primeiro mês é cobrado inteiro agora**, sem valor proporcional. Cada linha renova todo mês no dia da compra. * **O valor sai do saldo da carteira; o cartão salvo cobre o que faltar.** * Você pode cancelar quando quiser: a linha fica até o fim do mês pago, **sem reembolso**. Cada número é comprado de forma independente, e o resultado aparece por número. Se um falhar, os outros não são desfeitos. Se um número falhar **depois** de cobrado, o valor volta **como saldo na carteira** — inclusive a parte paga no cartão. As falhas mais comuns: * **O pagamento não foi concluído** — nada fica cobrado. O painel abre **Adicionar saldo para concluir a compra** (depois, também pelo botão **Adicionar saldo e tentar de novo**): ele mostra o total, o saldo e quanto falta, aceita Pix (só em contas em BRL) ou cartão e, quando o saldo entra, volta à confirmação com os mesmos números. * **Este número não está mais disponível** — ele foi comprado por outra pessoa ou saiu do estoque da operadora. **Escolher outros números** volta à busca. * **A operadora do cartão não respondeu** — a carteira não foi debitada, mas o cartão pode ter sido cobrado. Confira a fatura antes de tentar de novo. Um clique duplo, ou uma nova tentativa da mesma confirmação, não cobra duas vezes o mesmo número. Abra a linha (**Ver linha**) e, **antes** de pedir o código no WhatsApp, clique em **Esperar novo código**. A linha é preparada na operadora — assim o áudio de uma ligação antiga nunca é lido como o código novo — e o painel mostra **Esperando a ligação da Meta**, com o **Tempo restante**: a linha espera a ligação por **5 minutos**. Agora, no WhatsApp Business, cadastre o número da linha e, quando o app perguntar como receber o código, toque em **Me ligue**. Quando a ligação chega, o painel mostra **A ligação chegou — lendo o código…**. Costuma levar alguns segundos, mas pode chegar a um ou dois minutos; não é preciso pedir outro código. Enquanto isso, você já pode ouvir a gravação (**Ouvir**). Se a leitura falhar, ela é refeita a partir da gravação guardada, até 3 tentativas. O código aparece em destaque, com **Copiar**. Digite-o no WhatsApp e pronto. ## Quando o código não aparece | O que o painel mostra | O que fazer | | - | - | | **Nenhuma ligação chegou** | A janela de 5 minutos fechou sem ligação. Os motivos mais comuns: o botão tocado no WhatsApp foi **Reenviar SMS**, e não **Me ligue**; o contador do WhatsApp ainda não liberou a opção de ligação; ou o WhatsApp está em carência por tentativas seguidas — espere alguns minutos. Clique em **Esperar de novo** antes de pedir outra ligação. | | **Recebemos a ligação, mas não conseguimos ler o código** | Ouça a gravação logo abaixo: o código está nela. | | **Não conseguimos capturar a ligação** | A ligação chegou, mas o áudio não pôde ser guardado. Clique em **Esperar de novo** e peça o código outra vez no WhatsApp. | Só existe **um pedido de código aguardando por linha**. Se você pediu por engano, ou quer recomeçar antes de os 5 minutos acabarem, clique em **Cancelar espera**: o pedido termina na hora e você pode pedir outro. Se a ligação já tiver sido capturada quando você clica, o cancelamento não vale: o código continua sendo lido e aparece na tela. Uma linha pode pedir quantos códigos precisar ao longo da vida. Os **20 pedidos mais recentes** aparecem no **Histórico de códigos** da página da linha, com o horário, o código, a gravação e a situação. ## Dê um nome à linha Clique no **lápis** ao lado do número, no topo da página da linha (**Editar nome**). O nome é opcional, tem até **60 caracteres** e passa a ser o título da linha na lista, na página dela e nas cobranças. Em branco, a linha volta a aparecer pelo número. Proprietário e Administrador podem renomear, em qualquer situação da linha. ## Receba os eventos das linhas por webhook Para o seu sistema saber na hora que um código chegou, que uma renovação falhou ou que uma linha foi suspensa, cadastre um webhook em **Linhas telefônicas → Webhooks das linhas**. É um cadastro separado dos webhooks de números: um webhook de números nunca recebe eventos de linha, e vice-versa. Os eventos de uma linha trazem o nome dela (ou o número formatado, se ela não tiver nome), e os eventos do código — áudio recebido, código recebido e código não obtido — trazem `audioUrl`, o endereço da gravação da ligação, que o seu sistema baixa com a chave da API. O passo a passo da tela está em [Linhas telefônicas no painel](/pt-BR/dashboard/phone-lines#webhooks-das-linhas); os eventos, payloads e a assinatura estão em [Webhooks das linhas](/pt-BR/api/phone-lines/webhooks). ## Renovação Cada linha renova **todo mês, no mesmo dia da compra** — a data aparece em cada linha (**renova …**). O primeiro mês já foi pago na compra; a partir daí, cada renovação sai da carteira, e o cartão salvo cobre o que faltar. Cerca de **48 horas** antes, você recebe um aviso com as linhas que vão renovar e o total. Se o saldo não cobrir as renovações dos próximos 7 dias e você não tiver cartão salvo, você também recebe um aviso antes. Datas, valores e o histórico de cada cobrança ficam em **Planos → Financeiro**. Os detalhes estão em [Preço e cobrança das linhas](/pt-BR/phone-lines-pricing). ## Suspensão por falta de pagamento Se uma renovação não puder ser cobrada, a linha entra em **Pagamento pendente** e a cobrança é tentada de novo **a cada 6 horas**: 1. **Pagamento pendente** — a linha continua funcionando, inclusive para códigos novos, por **2 dias**. 2. **Suspensa** — depois desses 2 dias. Ela para de receber códigos novos, mas o histórico continua visível. 3. **Devolvida** — **1 dia** depois da suspensão, o número volta para a operadora, e o histórico de códigos e as gravações da linha são apagados. Não tem volta. Da primeira cobrança que falhou até perder o número são cerca de **3 dias**. Cada etapa gera um aviso para o titular e para o proprietário do workspace. Para resolver, adicione saldo e clique em **Pagar tudo** na lista de linhas, que cobra todas as linhas em atraso — ou em **Pagar … agora** / **Pagar … e reativar** na página de uma linha, que cobra **só aquela linha** (se houver outras em atraso, a página avisa, com **Ver e pagar todas**). Pagar em atraso reativa a linha e **mantém a data de renovação original**. **Um número devolvido deixa de ser seu, e a conta do WhatsApp ativada nele continua ligada a ele.** Quem alugar o número depois pode pedir um código de verificação e assumir a conta. Mantenha saldo ou um cartão salvo — ou, se não precisa mais da linha, migre a conta do WhatsApp para outro número antes. ## Cancelar ou devolver uma linha O botão fica no topo da página da linha, ao lado da situação, e só aparece para o Proprietário. Para confirmar, você digita o número da linha. * **Linha em dia: Cancelar linha.** O cancelamento é agendado. A linha continua funcionando até o fim do mês já pago, **sem reembolso**, não é renovada e, nesse dia, o número é devolvido à operadora. Até lá, **Desistir do cancelamento** desfaz o agendamento. * **Linha em atraso: Devolver número.** Não resta período pago, então o número é devolvido **na hora**. Não dá para desfazer. Em qualquer caso, depois que o número volta à operadora, a linha sai da lista e a página dela só informa que o número não pertence mais a você. Não há garantia de conseguir comprar o mesmo número de volta. **O histórico de códigos e as gravações das ligações são apagados** quando o número volta à operadora: na hora, em **Devolver número**; no fim do mês pago, num cancelamento. Depois de **Devolver número**, a lista mostra **… foi devolvido** — **O histórico de códigos e os áudios foram apagados. Não há cobrança pendente para esta linha.** ## Para desenvolvedores Verificar o titular, buscar e comprar números, listar e cancelar linhas, pedir códigos de ativação e baixar a gravação da ligação também funcionam pela API pública, com uma chave com escopo de tenant — a verificação está em [Verificação do titular](/pt-BR/api/phone-lines/verification). Ficam só no painel: dar nome à linha, desistir de um cancelamento, pagar linhas em atraso na hora (**Pagar tudo**, **Pagar … agora**) e **Escolher quais manter**, e o cadastro dos webhooks das linhas. Escopo da chave, permissões, ciclo de vida, limites e todos os códigos de erro. `GET /v1/phone-lines/available` e `POST /v1/phone-lines`, com `Idempotency-Key`. Preparar a linha, consultar o pedido, cancelar a espera e o histórico. Eventos `phone_line.*`, payloads, assinatura e retentativas. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.