Skip to main content
jelou phone-numbers gerencia os números de WhatsApp que sua empresa compra pela Jelou: números dos Estados Unidos (+1) faturados com o seu plano. Com estes comandos você verifica se pode comprar, compra um número, lê o SMS com o código de verificação da Meta e libera números que não usa mais.
Para WhatsApp, use sempre jelou phone-numbers buy. jelou voice numbers buy --provider twilio compra números para o serviço de voz: não passa pelo seu plano e o número não funciona para WhatsApp.

​
Do número ao canal conectado

1

Verifique se você pode comprar

Não compra nada. Informa se a compra é permitida e qual seria o custo (veja Custo da compra).
2

Encontre um número disponível

Só consulta o inventário do provedor; não compra nada.
3

Compre o número

A CLI mostra o custo e pede confirmação. Ao confirmar, o número é comprado na hora e você recebe o seu id.
4

Conecte-o ao WhatsApp

A ativação do WhatsApp abre na Jelou com o número já selecionado. Enquanto você conclui o login da Meta, a CLI mostra no terminal o SMS com o código de verificação e termina quando o canal desse número fica conectado.

​
Custo da compra

A compra é cobrada conforme o plano da sua empresa: Antes de confirmar, buy mostra qual dos três casos se aplica e, se houver cobrança, o preço da linha. Se não conseguir ler o preço, não compra. A compra também depende dos canais do seu plano: se você já usou todos, capability e buy avisam e nada é comprado.

​
jelou phone-numbers capability

Mostra:
  • se você pode comprar agora;
  • o custo da próxima compra (incluída no plano, linha já paga ou linha nova);
  • as linhas abertas (pagas e sem número);
  • os canais conectados em relação ao limite do seu plano;
  • os números que ainda não têm canal.

​
jelou phone-numbers list

Lista os números da empresa, do mais recente ao mais antigo. --status filtra por estado:

​
jelou phone-numbers messages

Mostra os SMS que o número recebeu desde a compra, do mais recente ao mais antigo (até 20). Quando a Meta verifica o número, o código chega aqui. Se você acabou de pedir o código e ele não aparece, aguarde alguns segundos e execute o comando de novo.

​
jelou phone-numbers buy

Se a compra falhar porque o pagamento ou a compra ficaram pendentes de confirmação, execute o mesmo comando de novo após alguns segundos. Repeti-lo não cobra nem compra duas vezes.
Erros frequentes:

​
jelou phone-numbers delete

Libera o número: ele volta ao provedor e, no Self Service, sua linha deixa de ser cobrada a partir da próxima fatura (o período atual não é reembolsado). Só é possível liberar números ativos sem canal; se o número estiver conectado, exclua ou desconecte esse canal primeiro.
Liberar um número é irreversível: não é possível recuperá-lo depois.

​
Conectar o número com channels activate

--phone-number faz jelou channels activate whatsapp trabalhar sobre um número comprado com phone-numbers buy:
  • A ativação do WhatsApp abre na Jelou com esse número já selecionado.
  • Enquanto você espera, a CLI mostra no terminal cada SMS que o número recebe, incluindo o código da Meta.
  • A espera termina quando esse número fica conectado, não quando aparece qualquer outro canal de WhatsApp da empresa.
--project e --name só preenchem a ativação: você pode alterá-los lá antes de concluir.
Ao terminar, a CLI devolve o channel_id, o bot_id e o projeto do novo canal. O bot_id é o que usam jelou template e jelou campaign.
Se o número já tiver um canal, activate --phone-number falha antes de abrir o navegador e devolve o id desse canal. Com --watch, por outro lado, termina na hora com esse canal como resultado.

​
Uso a partir de um agente

Com --agent ou --no-input, buy e delete exigem --yes. Um agente deve ler capability, mostrar o custo ao usuário e passar --yes só depois que o usuário aceitar.
No modo JSON, buy adiciona o campo charge com o tipo de cobrança (included, open_line ou new_line) e, se houver cobrança, o preço. Quando uma compra fica pendente, o erro é TRANSIENT_ERROR com retryable: true: o agente pode repetir o mesmo comando sem risco de cobrança dupla.