Phone Numbers

Compra un número de EE. UU. directamente en Helios y asígnalo a un agente de voz, con dirección de emergencia E911 y un asistente guiado.

Objetivo

Compra un número de teléfono de EE. UU. aprovisionado directamente por Helios y asígnalo a un agente de voz, sin conectar tu propia cuenta de Twilio. 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, 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, liberar) se vuelve a validar en el servidor, así que solo owners y admins pueden aprovisionar 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

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
Phone number	El número, con formato de visualización (por ejemplo +1 (302) 555-1234).
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).
Release	Abre la confirmación para liberar ese número.

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 X of 3".

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

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.

Campo	Obligatorio	Formato	Ejemplo	Nota
Business or full name	Sí	texto	Building Your Dreams Tech LLC	El nombre bajo el que se registra la dirección.
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

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.

Release a number

Para dar de baja un número, haz clic en Release en su tarjeta y confirma. Al liberar:

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

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

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.