Phone Numbers

Compra un número de EE. UU. en Helios, ponle nombre y úsalo para un agente de voz o WhatsApp, con dirección E911 y un asistente guiado.

Objetivo

Compra un número de teléfono de EE. UU. aprovisionado directamente por Helios, ponle un nombre y ponlo a trabajar: asígnalo a un agente de voz o úsalo para conectar WhatsApp. El asistente de compra te guía para elegir un número, registrar la dirección de emergencia (911) exigida por ley y confirmar la compra. El número queda listo para recibir llamadas en cuanto se completa la compra.

Esta es la alternativa gestionada al modo Bring-Your-Own-Twilio que se usa en Voice Agents: con un número de Helios no administras una cuenta de operador aparte.

Acceso

Sidebar -> Telephony -> Phone Numbers Ruta: /app/{tenant}/phone-numbers

Roles

owner, admin — acceso completo (ver la lista, buscar, comprar, renombrar, liberar).
agent — sin acceso. La página es solo para owner/admin; los agentes no la ven en el sidebar y, si entran por la ruta directa, aparece "Only owners and admins can manage phone numbers."

Cada acción (buscar, comprar, renombrar, liberar) se vuelve a validar en el servidor, así que solo owners y admins pueden aprovisionar, renombrar o liberar un número sin importar cómo se llegue a la página.

Disponibilidad y requisitos previos

Los números gestionados deben estar habilitados en tu espacio de trabajo. Si el módulo no está activo en tu entorno, verás una tarjeta discreta "Phone numbers are not available yet." en lugar del gestor.
Rol owner o admin (ver Roles arriba).
Un correo verificado. La búsqueda está abierta, pero la compra se bloquea hasta que el correo del espacio de trabajo esté verificado ("Please verify your email address before purchasing a phone number.").
Un plan que incluya un cupo de número para completar una compra. Buscar siempre es gratis en cualquier plan, incluido el gratuito; solo el paso final de compra está limitado por plan. Ver Límites de plan y facturación más abajo.

Your numbers

Tus números

El gestor lista los números que posee tu espacio de trabajo.

Una línea de uso muestra cuántos números están en uso, por ejemplo "N of M numbers used" (o un conteo ilimitado cuando tu plan no tiene tope).
Cada número activo se muestra como una tarjeta con:

Elemento	Significado
Name	El nombre de referencia que le diste al número, mostrado primero. Un número sin nombre muestra el número en su lugar.
Phone number	El número, con formato de visualización (por ejemplo +1 (302) 555-1234). Aparece debajo del nombre cuando hay un nombre asignado.
Active badge	El número está activo y puede recibir llamadas.
Purchased date	Cuándo se compró el número.
Emergency address registered	Confirma que la dirección E911 está registrada (todo número activo de Helios tiene una).
Number options (menú de tres puntos)	Edit name abre el diálogo para renombrar; Release abre la confirmación para liberar.

Los números liberados pasan a un historial plegable de released numbers al final de la página, cada uno con una insignia Released y la fecha de liberación.

Buy a number

Haz clic en Buy a number para abrir el asistente de compra. Tiene tres pasos más una pantalla de éxito; el encabezado muestra "Step 1 of 3", "Step 2 of 3", etc.

Paso 1: Choose a number

Busca en el inventario en vivo de Helios de números locales de EE. UU. habilitados para voz.

Campo	Obligatorio	Formato	Ejemplo	Nota
Area code	No	3 dígitos	302	Déjalo en blanco para ver números de cualquier código de área de EE. UU.
Contains	No	2-10 letras, dígitos o *	2020, CAFE	Filtra por números memorables; las letras corresponden al teclado telefónico.

Deja ambos campos en blanco para explorar números de cualquier código de área de EE. UU.
Solo hay números de EE. UU. Un código de área fuera de EE. UU. (como +1 809) no devuelve resultados.
Los resultados aparecen como una lista seleccionable con un conteo en vivo ("N numbers available"). Elige uno o usa Show more para volver a generar un conjunto nuevo de números disponibles.
Si no hay coincidencias, aparece el mensaje "No available numbers matched your search." — prueba con otro código de área.

Paso 2: Emergency address

Este paso también da nombre al número y registra su dirección de emergencia.

Campo	Obligatorio	Formato	Ejemplo	Nota
Name for this number	No	texto, hasta 60 caracteres	Sales line	Una referencia para distinguir tus números. En blanco, el número se llama "Helios number". Puedes cambiarlo después.
Business or full name	Sí	texto	Building Your Dreams Tech LLC	El nombre bajo el que se registra la dirección de emergencia.
Street address	Sí	calle + unidad únicamente	123 Main St, STE 100	No incluyas ciudad, estado ni ZIP aquí.
City	Sí	texto	Wilmington
State	Sí	selección	DE	Se elige de una lista con los 50 estados más DC y Puerto Rico.
ZIP code	Sí	5 dígitos o ZIP+4	19801

La ley de EE. UU. exige que todo número de teléfono tenga una dirección registrada para llamadas de emergencia (911). Esta dirección se usa solo para el despacho de emergencias y nunca se comparte con quienes llaman.

El formulario valida sobre la marcha: marca un campo de calle que parezca una dirección completa, un estado sin seleccionar y un ZIP inválido, para detectar los errores aquí en vez de fallar después.

Paso 3: Confirm purchase

El paso de confirmación muestra el número elegido y la dirección de emergencia que ingresaste.

Si tu plan incluye un cupo de número: aparece una línea de precio con cuánto suma el número a tu facturación mensual (cuando hay un precio configurado), y debes marcar la casilla de aceptación de los Phone Number Terms and Acceptable Use Policy antes de que se active el botón Purchase. En resumen: los números son solo para IA de voz entrante, sin spam ni robocalls, eres responsable del uso lícito y un número puede suspenderse por abuso. Los términos completos se abren en una pestaña nueva.
Si tu plan no incluye un cupo de número: en lugar del botón de compra ves "Upgrade your plan to buy this number" con un enlace View plans a facturación. La búsqueda sigue siendo gratis; solo la compra está limitada.

Usa Back para revisar un paso anterior o Cancel para cerrar el asistente.

Éxito

Tras una compra exitosa ves "Your new number is ready" con el nuevo número y un botón Assign it to a voice agent que te lleva a Voice Agents. El número ya está configurado para recibir llamadas; asígnalo a un agente de voz para empezar a atender.

Ponerle nombre a un número

Todo número de Helios lleva un nombre de referencia que lo identifica en toda la app: en la lista de números, en el selector de agentes de voz y al conectar WhatsApp.

Al comprar: define el nombre en el Paso 2 del asistente ("Name for this number"). En blanco, el número se llama "Helios number".
Después de comprar: abre el menú de tres puntos del número y elige Edit name. El diálogo "Name this number" muestra un campo Name (hasta 60 caracteres, por ejemplo "Sales line"). Save lo aplica de inmediato ("Name updated.").
Borrar el nombre está permitido: guarda un nombre vacío y la tarjeta muestra el número de teléfono a secas.

Usar un número para WhatsApp

Un número activo de Helios también puede alimentar WhatsApp. En la sección de WhatsApp, elige Use a Helios number al conectar: Meta envía su código de verificación por SMS al número, y Helios lo recibe y lo introduce automáticamente — nunca lo lees ni lo escribes tú. Funciona con todo número activo de Helios, incluidos los comprados antes de que existiera esta opción.

Si aún no tienes números, el flujo de WhatsApp te lo dice: "You do not have a Helios number yet. Buy one first, then connect it to WhatsApp."
Un número conectado a WhatsApp no se puede liberar hasta que primero lo desconectes allí (ver Release a number más abajo).

Consulta WhatsApp para el flujo de conexión completo.

Release a number

Para dar de baja un número, abre su menú de tres puntos, elige Release y confirma ("Release this number?"). Al liberar:

El número deja de funcionar de inmediato y no se puede deshacer — "{number} will stop working immediately and cannot be recovered. You will need to buy a new number to replace it."
Se libera el cupo del plan y se detiene el cargo mensual del número.
El número pasa al historial de liberados.

Un número conectado a WhatsApp no se puede liberar. Aparece "This number is connected to WhatsApp. Disconnect it in the WhatsApp section first, then release it here." Desconecta WhatsApp y luego libera.

Necesitarías comprar un número nuevo para reemplazar uno liberado; no se garantiza que el mismo número vuelva a estar disponible.

Límites de plan y facturación

Buscar es gratis en cualquier plan, incluido el gratuito; nunca cuenta contra un límite.
Comprar está limitado por plan. Tus cupos disponibles son la asignación de números de tu plan más cualquier add-on de número que hayas comprado. Algunos planes no otorgan ninguno; otros son ilimitados.
Cada número activo suma un cargo mensual recurrente a tu suscripción, mostrado en el paso de confirmación cuando hay un precio configurado. Liberar un número elimina ese cargo.
En el límite: el botón Buy a number queda deshabilitado con un tooltip que explica que alcanzaste el máximo de tu plan. Libera un número o mejora tu plan para comprar más.
Después de una baja de plan: si ahora posees más números de los que permite tu nuevo plan, los conservas todos — Helios nunca libera tus números automáticamente — pero no puedes comprar más hasta liberar algunos o mejorar el plan. Un aviso en la parte superior de la página explica este estado.

Buenas prácticas

Verifica el correo de tu espacio de trabajo antes de intentar comprar, para que la compra no se bloquee.
Nombra cada número según su función ("Sales line", "Support desk") para elegirlo fácil en los flujos de agentes de voz y WhatsApp; puedes renombrarlo cuando quieras.
Ingresa solo la calle y la unidad en el campo Street address; pon ciudad, estado y ZIP en sus propios campos para pasar la validación de la dirección de emergencia.
Usa el filtro Contains para encontrar un número memorable (dígitos o letras del teclado).
Asigna un número nuevo a un agente de voz enseguida para que empiece a atender llamadas.
Libera los números que ya no uses para detener su cargo mensual — desconectando WhatsApp antes si el número está conectado allí.

Errores comunes

"Phone numbers are not available yet." — los números gestionados aún no están habilitados en tu espacio de trabajo.
Sin resultados al buscar — el código de área puede estar agotado, o buscaste un código de área fuera de EE. UU. (solo se ofrecen números de EE. UU.).
Compra bloqueada con un aviso de mejora — tu plan actual no otorga cupos de número; mejóralo desde el enlace View plans.
"Please verify your email address before purchasing a phone number." — verifica el correo de tu espacio de trabajo y vuelve a intentarlo.
Botón de compra deshabilitado — estás en el límite de números de tu plan; libera un número o mejora el plan.
"This number is connected to WhatsApp. Disconnect it in the WhatsApp section first, then release it here." — la liberación se bloquea mientras el número respalda una conexión activa de WhatsApp; desconecta WhatsApp primero.
"Number not found." al renombrar — el número ya no existe en tu espacio de trabajo o ya fue liberado.