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.
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:
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.
- 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.
Comprar linhas
Comprar linha abre/linhas/comprar, em três etapas:
- 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.
- Números — escolha o DDD, clique em Buscar números e marque até 10.
- 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.
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.
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: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.
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.
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
httpse 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.
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.
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.