Dividir una lista de números de teléfono de varios países en tareas de Consulta del operador original
Cree un manifiesto de país a archivo, revise los números excluidos y envíe tareas masivas de Consulta del operador original con resultados trazables.
Un manifiesto de país a archivo convierte una exportación mixta de CRM en tareas revisadas de Consulta del operador original específicas por país.
Para dividir una lista de números de teléfono de varios países para las tareas masivas de CarrierLookup, conserve la exportación original, analice cada número en un formato internacional, agrupe las filas elegibles por el país ISO seleccionado y escriba un archivo TXT o CSV revisado por cada país. Mantenga un manifiesto que vincule cada archivo de salida con su país, filas de entrada, exclusiones y resultados posteriores. El servicio masivo de CarrierLookup procesa un archivo de un país seleccionado; no divide una exportación mixta para el equipo.
Comience con la lista de origen y su evidencia de país
Un campo de mercado de CRM no es suficiente para asignar un número a una tarea masiva. Un cliente puede vivir en un país y conservar un número de otro. Comience desde el código de país internacional del número de teléfono y mantenga el país o mercado original del CRM como un campo comercial separado. La ITU-T Recommendation E.164 define la estructura de numeración internacional; también reconoce códigos de numeración que cubren un plan integrado en lugar de una etiqueta simple de un solo país. Utilice un analizador de numeración mantenido e inspeccione las filas ambiguas en lugar de asignar un país basándose únicamente en el primer dígito o en una columna de hoja de cálculo.
Lea los identificadores de teléfono como texto. De lo contrario, el software de hoja de cálculo y los lectores de CSV pueden alterar los caracteres iniciales o inferir tipos numéricos. Por ejemplo, la pandas read_csv documentation describe el uso explícito de dtype y la lectura por fragmentos. Un equipo que utilice otra herramienta necesita las mismas propiedades: una importación que preserve el texto y una forma repetible de manejar una exportación grande sin cambiar los identificadores de forma silenciosa.
Conserve el archivo de origen intacto y una referencia de fila local. Si un valor de teléfono carece de un código de país internacional, no adivine uno simplemente para que la fila pase la aceptación masiva. Márquelo para una revisión de los datos de origen. Una fila rechazada antes del envío debe permanecer visible en el informe de aceptación, aunque nunca aparezca en un archivo de resultados de CarrierLookup.
Cree un manifiesto de país a archivo antes de la carga
Cree un manifiesto con una fila por cada archivo de salida previsto. Los campos sugeridos propiedad del cliente son: país ISO seleccionado, nombre del archivo de salida, fecha de exportación de origen, recuento de filas de origen, recuento de números únicos preparados, recuento de filas excluidas, revisor y una suma de verificación del archivo. Mantenga un archivo auxiliar separado desde cada número canónico hasta cada fila de contacto original. Estos son controles locales, no campos en la respuesta o el CSV de CarrierLookup.
Divida solo los números preparados con código de país en archivos TXT o CSV de una sola columna. La CarrierLookup API documentation identifica un país seleccionado para el servicio masivo de Consulta del operador original global, mientras que las consultas individuales y múltiples en tiempo real aceptan números de diferentes países. Esta distinción es la razón por la que una exportación mixta necesita preparación para el procesamiento masivo, pero puede manejarse de manera diferente en un flujo de trabajo en tiempo real más pequeño.
El manifiesto también debe indicar el motivo por el que se excluyó una fila: falta de código de país, número no analizable, identificador preparado duplicado o país no incluido en la ejecución actual. Los duplicados pueden representar varios contactos de origen legítimos. Elimine los duplicados de la clave de envío mientras conserva cada relación de fila de origen en el archivo auxiliar; después de un resultado exitoso, el equipo puede asignar deliberadamente el contexto de asignación de nuevo a cada registro correspondiente.
Ejecute un informe de aceptación para cada partición de país
Antes del envío, compare cada archivo con el manifiesto. Compruebe que cada línea contenga un número con código de país, que el país seleccionado sea coherente con las filas preparadas y que no se haya filtrado ningún encabezado o columna de CRM en el archivo de una sola columna. El archivo debe ser esencialmente para el país seleccionado bajo las reglas de servicio actuales. No indique un umbral fijo de filas o tamaño de archivo de memoria; consulte la bulk product information en vivo y la documentación de la API para conocer los límites de aceptación actuales.
Un informe de aceptación puede mostrar cuatro totales: filas de origen consideradas, filas retenidas para reparación de datos, identificadores únicos escritos y filas de origen duplicadas representadas a través del archivo auxiliar. Vuelva a calcular esos totales a partir de los archivos en lugar de copiarlos de una exportación anterior. Un manifiesto que indica un país mientras su archivo contiene otro es un error operativo evitable; haga que un revisor compare el archivo y el país seleccionado antes del envío.
Trate una partición de país pequeña como un punto de decisión. Si no cumple con las reglas de aceptación masiva actuales, reténgala o utilice un flujo de trabajo en tiempo real documentado cuando sea adecuado. No la rellene con números repetidos. CarrierLookup tiene una Consulta del operador original síncrona para números individuales y solicitudes de números múltiples, además de un servicio de archivo de Consulta del operador original global asíncrono. Son flujos de trabajo diferentes y el equipo debe elegir según la partición real y los límites actuales del producto.
Envíe y supervise cada tarea por separado
Para cada partición aprobada, envíe el archivo con el país seleccionado correspondiente y registre la referencia de la tarea devuelta en el manifiesto. No adjunte el archivo de un país a la tarea de otro país simplemente porque los nombres de archivo parezcan similares. La referencia de la API de CarrierLookup documenta los puntos finales de envío masivo y estado de la tarea; las reglas actuales de la API deben regir los detalles de carga y el sondeo. El procesamiento masivo es asíncrono, por lo que una carga aceptada no es un resultado de operador completado.
Realice un seguimiento de cada tarea de forma independiente como processing, success o failed. Una tarea que falla durante la preparación puede haber excluido filas no válidas, duplicadas, sin país o fuera del país, y puede volver a fallar en otra condición de aceptación. Conserve su manifiesto y error para su reparación. No infiera valores de operador de una tarea fallida o del prefijo del número de origen. Una tarea exitosa proporciona un CSV para sus números preparados, que debe almacenarse junto con el manifiesto y el archivo auxiliar correspondientes.
Después de la descarga, verifique que el archivo pertenezca a la tarea y al país seleccionado previstos. Los identificadores masivos son dígitos simples con su código de país, sin signo más ni espacios. Normalice la clave de comparación propiedad del cliente en ambos lados mientras conserva los archivos sin procesar. El resultado describe el operador originalmente asignado, el operador subyacente, el tipo de línea y la geografía del rango de números cuando está disponible; no es un operador actual después de la portabilidad ni la ubicación en vivo de una persona.
Concilie los resultados sin perder los contactos de origen
Una los identificadores devueltos al archivo auxiliar, no a las posiciones originales de las filas del CSV. El preprocesamiento masivo puede eliminar entradas duplicadas y no válidas, por lo que el orden de las filas no es una clave de unión confiable. Produzca recuentos para los identificadores devueltos, los identificadores preparados no coincidentes y los identificadores devueltos que no coinciden con el manifiesto. Detenga cualquier actualización automática de CRM para claves inesperadas hasta que un operador investigue.
Para un número compartido por varias filas de origen, asigne una consulta completada a esas filas deliberadamente y conserve el mismo tiempo de observación y referencia de tarea. Si el número de un contacto cambió después de la exportación, marque un conflicto en lugar de sobrescribir sus datos actuales. Las comprobaciones de versión opcionales son una elección de integración del cliente, no una característica del producto. Mantenga los campos de operador vacíos como información de asignación no disponible en lugar de recodificarlos como un número no válido o inalcanzable.
La acción final es enviar un archivo revisado específico por país a través de la Consulta del operador original global y guardar su manifiesto con el resultado. Esto brinda a los operadores de CRM una ruta trazable desde la exportación de origen mixta hasta tareas separadas y viceversa, sin afirmar que los datos de asignación prueban la red presente, la contactabilidad, la identidad o el consentimiento.
Preguntas frecuentes
¿Puede CarrierLookup masivo dividir automáticamente un CSV de varios países?
No se documenta tal división. Prepare archivos específicos por país y seleccione el país correspondiente para cada tarea.
¿Qué debería suceder con los números a los que les faltan códigos de país?
Reténgalos para una revisión de los datos de origen. No invente un código de país para que la carga sea aceptada.
¿Deberían unirse los resultados a la exportación original por número de fila?
No. Utilice el identificador devuelto y un archivo auxiliar propiedad del cliente que asigne cada número preparado a sus filas de origen.
Más información
Elija la información del producto que se ajuste al siguiente paso en su flujo de trabajo.