Skip to main content
jelou phone-numbers administra los números de WhatsApp que tu empresa compra a través de Jelou: números de Estados Unidos (+1) que se facturan con tu plan. Con estos comandos revisas si puedes comprar, compras un número, lees el SMS con el código de verificación de Meta y liberas números que ya no usas.
Para WhatsApp usa siempre jelou phone-numbers buy. jelou voice numbers buy --provider twilio compra números para el servicio de voz: no pasa por tu plan y el número no sirve para WhatsApp.

​
Del número al canal conectado

1

Revisa si puedes comprar

No compra nada. Te dice si la compra está permitida y qué costo tendría (ver Costo de la compra).
2

Busca un número disponible

Solo consulta el inventario del proveedor; no compra nada.
3

Compra el número

El CLI muestra el costo y pide confirmación. Al confirmar, el número se compra de inmediato y obtienes su id.
4

Conéctalo a WhatsApp

Se abre la activación de WhatsApp en Jelou con el número ya seleccionado. Mientras completas el inicio de sesión de Meta, el CLI muestra en la terminal el SMS con el código de verificación y termina cuando el canal de ese número queda conectado.

​
Costo de la compra

La compra se cobra según el plan de tu empresa: Antes de confirmar, buy te muestra cuál de los tres casos aplica y, si hay cobro, el precio de la línea. Si no puede leer el precio, no compra. La compra también depende de los canales de tu plan: si ya usaste todos, capability y buy te lo indican y no se compra nada.

​
jelou phone-numbers capability

Muestra:
  • si puedes comprar ahora;
  • el costo de la próxima compra (incluida en el plan, línea ya pagada o línea nueva);
  • las líneas abiertas (pagadas y sin número);
  • los canales conectados frente al límite de tu plan;
  • los números que todavía no tienen canal.

​
jelou phone-numbers list

Lista los números de la empresa, del más reciente al más antiguo. --status filtra por estado:

​
jelou phone-numbers messages

Muestra los SMS que recibió el número desde que lo compraste, del más reciente al más antiguo (hasta 20). Cuando Meta verifica el número, el código llega aquí. Si acabas de pedir el código y no aparece, espera unos segundos y vuelve a ejecutar el comando.

​
jelou phone-numbers buy

Si la compra falla porque el pago o la compra quedaron pendientes de confirmación, vuelve a ejecutar el mismo comando después de unos segundos. Repetirlo no cobra ni compra dos veces.
Errores frecuentes:

​
jelou phone-numbers delete

Libera el número: vuelve al proveedor y, en Self Service, su línea deja de cobrarse desde la siguiente factura (el periodo en curso no se reembolsa). Solo se pueden liberar números activos que no tengan canal; si el número está conectado, elimina o desconecta ese canal primero.
Liberar un número es irreversible: no lo puedes recuperar después.

​
Conectar el número con channels activate

--phone-number hace que jelou channels activate whatsapp trabaje sobre un número comprado con phone-numbers buy:
  • La activación de WhatsApp se abre en Jelou con ese número ya seleccionado.
  • Mientras esperas, el CLI muestra en la terminal cada SMS que recibe el número, incluido el código de Meta.
  • La espera termina cuando ese número queda conectado, no cuando aparece cualquier otro canal de WhatsApp de la empresa.
--project y --name solo prellenan la activación: puedes cambiarlos ahí antes de terminar.
Al terminar, el CLI devuelve el channel_id, el bot_id y el proyecto del canal nuevo. El bot_id es el que usan jelou template y jelou campaign.
Si el número ya tiene un canal, activate --phone-number falla antes de abrir el navegador y te devuelve el id de ese canal. Con --watch, en cambio, termina de inmediato con ese canal como resultado.

​
Uso desde un agente

Con --agent o --no-input, buy y delete exigen --yes. Un agente debe leer capability, mostrarle el costo al usuario y pasar --yes solo después de que el usuario acepte.
En modo JSON, buy agrega el campo charge con el tipo de cobro (included, open_line o new_line) y, si hay cobro, el precio. Cuando una compra queda pendiente, el error es TRANSIENT_ERROR con retryable: true: el agente puede repetir el mismo comando sin riesgo de doble cobro.