Uso del campo Teléfono

Esta guía describe cómo trabajar con un campo personalizado de tipo Phone Number Field ya configurado por su administrador. Si todavía no ve el campo en sus pantallas de issue, consulte con su administrador de Jira: probablemente sólo falte añadirlo a la pantalla correspondiente.

Capturar un número en un issue

A partir de la versión 3.1.0, el campo Teléfono presenta una interfaz estructurada compuesta por dos partes en disposición inline:

1. Selector de país (desplegable buscable): muestra ~250 países con su bandera, nombre y código de marcación. Puede escribir en el desplegable para filtrar por nombre de país o por código (por ejemplo, escriba "Peru" o "51" para seleccionar Perú).
2. Campo de número local (texto libre): introduzca únicamente la parte local del número, sin anteponer el código de país.

Para capturar un número:

1. Abra el formulario de creación, edición o transición.
2. Localice el campo Teléfono (el nombre exacto lo define el administrador, por ejemplo "Teléfono del solicitante").
3. Verifique que el selector de país muestre el país correcto. Si no es así, haga clic en el desplegable y seleccione el país correspondiente.
4. Escriba el número local en el campo de texto (por ejemplo, 943 824 375).
5. Guarde los cambios.

El complemento combinará automáticamente el código de marcación del país seleccionado con el número local para almacenar el valor completo (por ejemplo, +51 943 824 375).

País preseleccionado desde la configuración

El selector de país se preselecciona con el país configurado por su administrador para este campo en el contexto actual (proyecto o tipo de issue). Normalmente coincidirá con el país de su organización, por lo que en la mayoría de los casos no necesitará cambiarlo.

Mantenga los separadores que usted prefiera

El complemento conserva los espacios, guiones, puntos y paréntesis que use para agrupar dígitos en el número local: el número se mostrará tal como lo escribió. Solo se le quitan los separadores al construir el enlace clicable para no confundir al marcador del dispositivo.

Si el valor no es un número válido, Jira mostrará el mensaje "The value is not a valid phone number." y no permitirá guardar hasta que el formato sea correcto.

Visualizar el número en el issue

Una vez guardado, el número aparece en la vista del issue como un enlace clicable precedido por el icono de un teléfono y el código de país. El formato de visualización es del tipo 📱 PE +51 943 824 375. Al hacer clic:

• En móviles, se abre directamente el marcador con el número listo para llamar.
• En macOS o Windows, se abre la aplicación de llamadas predeterminada (FaceTime, Teams, Skype, etc.), según la configuración del sistema.

Esto facilita el contacto rápido sin necesidad de copiar y pegar el número.

Errores comunes al capturar

Mensaje de error	Causa	Cómo corregirlo
"The value is not a valid phone number."	El texto contiene caracteres no permitidos, o no respeta la longitud mínima/máxima.	Verifique que use solo dígitos y los separadores +, espacio, ., -, (, ), y que el número tenga entre 7 y 25 caracteres en total (incluyendo el código de marcación).

Buscar issues por número de teléfono

Puede usar JQL para localizar issues por el valor exacto del campo. A partir de la versión 3.1.0, el valor almacenado incluye el código de marcación del país, por lo que las búsquedas deben incluirlo:

"Teléfono del solicitante" = "+51 943 824 375"

"Teléfono del solicitante" is not EMPTY

Reemplace Teléfono del solicitante por el nombre exacto que su administrador haya asignado al campo.

La búsqueda parcial no está disponible

Los operadores ~ y !~ (coincidencia parcial) no son compatibles con este tipo de campo en Jira Cloud por una limitación de la plataforma. Para localizar varios teléfonos use listas: "Teléfono del solicitante" in (...).