Pular para o conteúdo principal
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. Este guia descreve o fluxo do painel. Para fazer o mesmo por código, veja a API de Linhas telefônicas.

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

​
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

1

Abra Linhas telefônicas e clique em Comprar linha

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

Confirme quem é o titular (só na primeira compra)

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 — é 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:
3

Escolha os números pelo DDD

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

Confirme e pague

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

Peça o código de ativação

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

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; os eventos, payloads e a assinatura estão em Webhooks das linhas.

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

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

Visão geral da API

Escopo da chave, permissões, ciclo de vida, limites e todos os códigos de erro.

Buscar e comprar

GET /v1/phone-lines/available e POST /v1/phone-lines, com Idempotency-Key.

Códigos de ativação

Preparar a linha, consultar o pedido, cancelar a espera e o histórico.

Webhooks das linhas

Eventos phone_line.*, payloads, assinatura e retentativas.