Formatear números de teléfono para la importación masiva

Genesys Cloud sigue la especificación E.164 para los números de teléfono utilizados en el sistema. Cuando importe de forma masiva contactos externos y organizaciones externas a través de un archivo .csv, los números de teléfono de entrada en su archivo .csv deben seguir el estándar E.164. Este artículo describe cómo dar formato a los números de teléfono antes de importarlos a Genesys Cloud.

Nota: La función de importación masiva acepta formatos válidos de números de teléfono y los convierte a un formato coherente. Los formatos de números de teléfono no válidos no se convierten y no se importan al sistema. Al procesar esos números, aparecen los errores pertinentes durante el paso de validación de datos.

Formatos de números de teléfono aceptables en

La función de importación masiva y las API de enriquecimiento reconocen los siguientes formatos de números de teléfono y los procesan internamente para adaptarlos al algoritmo de resolución de identidades para la coincidencia de contactos:

  • +441213315xxx
  • +1 232xxx4316
  • +29234xxx32432
  • +1 xxx 555 5554
  • +591 743392xxx3
  • +1 321 yyy 9872 x 123
  • (+44)121.xxx.5251
  • +1 415-xxx-2629

Formatos de código de país aceptables

La función de importación masiva y las API de enriquecimiento reconocen y procesan los siguientes formatos de código de país suministrados en la columna Número de teléfono de la plantilla .csv:

Número de teléfono que empieza por el signo +

  • EE.UU: +1
  • GB: +44
  • HU: +36

Número de teléfono que empieza por 00

  • UU: 001
  • GB: 0044
  • HU: 0036

Otros formatos de números de teléfono

  • Para utilizar este formato, debe indicar el código de país en la columna Código de país (por ejemplo, US, GB) de la plantilla .csv:
    • UU: 1
    • GB: 44
    • HU: 36
  • Cualquier otro formato específico de un país, debe proporcionar el código de país en la columna Código de país (por ejemplo, US, GB) en la plantilla .csv: 
    • HU: 06

Ejemplos de formatos no E.164

Por lo general, la función de importación masiva no procesa los números de teléfono E.164 no conformes y muestra las advertencias y mensajes de error correspondientes.

Los formatos no E.164 pueden tener: 

  • Menos de los dígitos esperados
  • Más de los dígitos esperados
  • Caracteres no numéricos

Errores y advertencias

Estos escenarios de ejemplo describen errores y mensajes de advertencia relacionados con el número de teléfono. 

Ejemplo de situación 1

En este escenario, el número de teléfono sigue el formato E.164 pero no coincide con el formato norteamericano . La función de importación masiva aplica el formato norteamericano insertando los guiones necesarios.

Introducir número de teléfono en .csv Normalización del código de país en .csv Número de teléfono almacenado en Genesys Cloud Código de país de normalización telefónica almacenado en Genesys Cloud Mensaje de advertencia
+13216549870 +1 321-654-9870
+1 3216549871 +1 321-654-9871

Ejemplo de situación 2

En este caso, el número de teléfono sigue el formato E.164 pero no coincide con el formato del Reino Unido. La función de importación masiva ajusta el formato eliminando guiones y añadiendo los espacios necesarios.

Introducir número de teléfono en .csv Normalización del código de país en .csv Número de teléfono almacenado en Genesys Cloud Código de país de normalización telefónica almacenado en Genesys Cloud Mensaje de advertencia
+44 1213315014 +44 121 331 5014
+44 121-231-5416 +44 121 231 5416

Ejemplo de situación 3

En este caso, el número de teléfono no es compatible con E.164 debido a que se han introducido dígitos o caracteres adicionales y no se ha especificado ningún código de país de normalización. Si continúa con la importación, la función de importación masiva almacena el número tal cual en el sistema y aparece un mensaje de advertencia al final del proceso de importación.

Introducir número de teléfono en .csv Normalización del código de país en .csv Número de teléfono almacenado en Genesys Cloud Código de país de normalización telefónica almacenado en Genesys Cloud Mensaje de advertencia
(+44)121 231 54023 (+44)121 231 54023

contact.cellPhone[(+44)121 231 54023]{Su número de teléfono no es compatible con la norma E164};

contact.cellPhone.normalizationCountryCode[null]{Debe proporcionar un código de país de normalización}

(44)1213315082 (44)1213315082

contact.cellPhone[(44)1213315082]{Su número de teléfono no es compatible con la norma E164};

contact.cellPhone.normalizationCountryCode[null]{Debe proporcionar un código de país de normalización}

(44) 121.331.5290 (44) 121.331.5290

contact.cellPhone[(44) 121.331.5290]{Su número de teléfono no es compatible con la norma E164};

contact.cellPhone.normalizationCountryCode[null]{Debe proporcionar un código de país de normalización}

  • El número de teléfono (+44)121 231 54023 tiene dígitos de más en la entrada. 
  • Los números de teléfono (44)1213315082 y (44) 121.331.5290, tienen un código de país no válido especificado entre paréntesis (44). Para más información, consulte la sección Formato de código de país válido.

Ejemplo de escenario 4

En este caso, el número de teléfono no es compatible con E.164 porque falta el código de país en el campo de entrada o normalización. Si procede con la importación, la función de importación masiva añade el código de país de EE.UU. por defecto.

Introducir número de teléfono en .csv Normalización del código de país en .csv Número de teléfono almacenado en Genesys Cloud Código de país de normalización telefónica almacenado en Genesys Cloud Mensaje de advertencia
321.654.9881 +1 321-654-9881

contact.cellPhone[321.654.9881]{Su número de teléfono no es compatible con la norma E164};

contact.cellPhone.normalizationCountryCode[null]{Debe proporcionar un código de país de normalización}

321 654 9879

+1 321-654-9879

contact.cellPhone[321 654 9879]{Su número de teléfono no es compatible con la norma E164};

contact.cellPhone.normalizationCountryCode[null]{Debe proporcionar un código de país de normalización}

Ejemplo de situación 5

En este escenario, el número de teléfono está en formato E.164 y el número de teléfono de entrada no tiene código de país, sin embargo, el archivo de importación tiene el código de país de normalización en el campo de normalización. No se generan advertencias, y la función de importación masiva aplica el formato regional adicional que sea necesario.

Introducir número de teléfono en .csv Normalización del código de país en .csv Número de teléfono almacenado en Genesys Cloud Código de país de normalización telefónica almacenado en Genesys Cloud Mensaje de advertencia

3216549891

EE.UU.

+1 321-654-9891

EE.UU.

(44)1213315095

GB

+44 121 331 5095

GB

Ejemplo de escenario 6

En este escenario, el número de teléfono está en formato E.164 y el código de país de normalización está correctamente especificado tanto en el número de entrada como en el campo de normalización. No se generan advertencias, y la función de importación masiva aplica el formato regional adicional que sea necesario.

Introducir número de teléfono en .csv Normalización del código de país en el .csv Número de teléfono almacenado en Genesys Cloud Código de país de normalización telefónica almacenado en Genesys Cloud Mensaje de advertencia

(+1)321.654.9838

EE.UU.

+1 321-654-9838

EE.UU.

+441213315039

GB

+44 121 331 5039

GB

Ejemplo de escenario 7

En este escenario, el número de teléfono está en formato E.164, pero el número de entrada y el campo de normalización tienen dos códigos de país de normalización diferentes. Un mensaje de advertencia indica que la función de importación masiva utiliza sólo el código de país del número de teléfono introducido e ignora el valor del campo de normalización.

Introducir número de teléfono en .csv Normalización del código de país en .csv Número de teléfono almacenado en Genesys Cloud Código de país de normalización telefónica almacenado en Genesys Cloud Mensaje de advertencia

+13216549852

GB

+1 321-654-9852

GB

contact.cellPhone.normalizationCountryCode[GB]{Tu número de teléfono es de EE.UU., pero tu código de país es de GB. Estamos resolviendo su número de teléfono con un código de país de EE.UU.}

(+44)1213315074

EE.UU.

+44 121 331 5074

EE.UU.

contact.cellPhone.normalizationCountryCode[US]{Tu número de teléfono es de GB, pero tu código de país es de US. Estamos resolviendo su número de teléfono con un código de país GB.}