Enriquecimiento de números de teléfono: Añada contexto del operador original a los registros de contacto
Un flujo de trabajo práctico para añadir el operador original, el tipo de línea y la geografía de asignación a los registros sin tratarlos como señales de contacto.
Enriquezca los registros de contacto con campos de asignación claramente etiquetados, una ruta de búsqueda documentada y un manejo explícito de los resultados vacíos.
El enriquecimiento de números de teléfono puede añadir el operador original, el operador subyacente, el tipo de número y la geografía de asignación a un registro de contacto. Prepare el número, elija una búsqueda en tiempo real para registros nuevos o una tarea de archivo asíncrona para un catálogo histórico preparado, y almacene el resultado con su fuente y fecha de comprobación. Mantenga los valores faltantes como desconocidos. Estos campos describen la asignación del número, por lo que no deben promoverse como una afirmación sobre la red actual, el propietario o si un contacto puede recibir un mensaje.
Defina los campos de enriquecimiento de números de teléfono antes de buscar registros
Comience con un diccionario de datos en lugar de una respuesta del proveedor. Asigne al número de teléfono del contacto un campo separado del resultado de la búsqueda. Añada columnas para el operador original, el operador subyacente, el tipo de número, el país de asignación, la región de asignación, la ciudad de asignación, el servicio de origen, la hora de comprobación y el resultado de la búsqueda. Describa la columna del operador como el operador al que se asignó originalmente el rango de números. Es posible que un número haya sido portado, por lo que debe denominar a ese campo operador original para evitar confundir a los usuarios del CRM. De manera similar, la región y la ciudad describen la geografía de asignación del rango de números, no la ubicación actual de una persona.
Decida cómo representa el CRM tres estados distintos: un resultado completado con un valor, un resultado completado con un valor opcional vacío y una solicitud que no produjo un resultado normal. Una celda de operador vacía debe permanecer como datos no disponibles. No debe activar una etiqueta de no carrier, invalid phone o safe to message. Mantenga una copia intacta del registro de contacto y el número canónico utilizado para la solicitud. Esto hace posible la reconciliación posterior si un usuario edita el campo de teléfono mientras el enriquecimiento está en curso.
Una pequeña revisión del esquema evita que los analistas posteriores conviertan silenciosamente el contexto de asignación en una puntuación de capacidad de contacto. Documente el significado junto a cada campo, incluya la fecha de recopilación en las exportaciones y haga que la procedencia esté disponible en los paneles. La página del producto Consulta del operador original describe el servicio en tiempo real; la documentación de la API es la referencia para el comportamiento de integración.
Utilice comprobaciones en tiempo real para números de contacto nuevos o modificados recientemente
Cuando llegue un registro nuevo, primero normalice su entrada de teléfono a un número E.164 con código de país, con un signo más inicial y sin espacios ni separadores. Conserve la entrada original del usuario por separado si es necesaria para soporte. Un rechazo de formato pertenece a una cola de corrección de entrada, no al mismo grupo que una búsqueda completada con campos de operador vacíos. La ruta REST única acepta un número. La opción multi-síncrona acepta un conjunto ordenado de números, incluidos números de diferentes países. El panel también tiene un flujo de trabajo de procesamiento por lotes en tiempo real. Elija entre estos según la ruta de entrada del equipo en lugar de asumir que cada lote significa una carga de archivo.
Para una integración de CRM automatizada, empareje cada identificador enviado con el ID del registro de contacto y la versión del registro. En una respuesta, reconcilie el identificador y el resultado antes de escribir los campos de enriquecimiento. Si el número de contacto cambió después del envío, retenga el resultado para su revisión en lugar de sobrescribir un registro más nuevo con una búsqueda más antigua. Esta comparación es una regla en la propia integración de CRM del equipo, no una característica anunciada de CarrierLookup.
Una búsqueda completada puede dejar legítimamente algunos detalles del operador en blanco. Sigue representando una búsqueda completada, por lo que debe conservar su resultado y fecha mientras deja los atributos faltantes como desconocidos. En la opción multi-síncrona, un elemento sin un resultado normal también necesita su propio estado. No prueba que el número esté desconectado. Para conocer los límites exactos de solicitud y el manejo de respuestas, utilice la documentación de la API en lugar de establecer límites a partir de una solicitud de ejemplo.
Utilice una tarea de archivo para un catálogo histórico
Una exportación histórica de CRM requiere un flujo de trabajo diferente. Extraiga los registros a un archivo de trabajo, asigne a cada fila de origen un ID estable y normalice los valores de teléfono antes del envío. Cree una tabla auxiliar que asigne cada número preparado a cada fila de origen que lo contenía. Si el mismo número aparece en varios contactos, el equipo puede preservar todas las relaciones de origen mientras evita identificadores preparados duplicados. Mantenga las filas de origen rechazadas o ambiguas en un informe de revisión separado.
El servicio de archivos de consulta de operador global acepta un archivo TXT o CSV de una columna con números con código de país y un país ISO seleccionado. Prepare un archivo que sea esencialmente para ese país seleccionado. El servicio excluye filas no válidas, duplicadas, sin código y fuera del país durante el preprocesamiento; esas exclusiones no deben escribirse como respuestas negativas del operador. Una tarea puede fallar durante la preparación cuando no se cumplen las condiciones de aceptación. Compruebe los límites de entrada y archivo documentados actualmente antes de crear cada tarea en lugar de rellenar un archivo con registros no relacionados.
La tarea se ejecuta de forma asíncrona. Almacene la referencia de la tarea en el registro de trabajos del equipo, realice sondeos en el intervalo documentado y espere a que se complete con éxito antes de descargar su archivo CSV único. Haga coincidir el identificador de salida, representado como dígitos con un código de país y sin signo más, con el número canónico de la tabla auxiliar. Compare los recuentos enviados, excluidos, devueltos y no coincidentes. Luego, expanda cada búsqueda exitosa a sus ID de fila de CRM originales. Este paso evita perder contactos duplicados o asignar silenciosamente un resultado al registro incorrecto.
Revise los registros enriquecidos antes de utilizar segmentos
Cree un informe de aceptación antes de escribir en producción. Muestree filas con campos poblados, filas con todos los campos de operador opcionales vacíos y filas sin un resultado normal. Verifique que el resultado de la búsqueda y la fecha de recopilación sobrevivan a la importación. Asegúrese de que un campo de CRM llamado carrier esté claramente etiquetado como asignación original y que la región y la ciudad no aparezcan bajo un encabezado de ubicación de la persona. Cuando un número ha cambiado en el registro de origen, dirija ese conflicto a un revisor.
El operador y el tipo de número pueden ayudar a los equipos a organizar la revisión manual, comparar fuentes de datos o planificar pruebas específicas del proveedor. No establecen la validez del servicio, la capacidad de contacto, la propiedad o el consentimiento. Un equipo que decide si enviar un mensaje necesita los controles de permiso y entrega adecuados para su propio flujo de trabajo. CarrierLookup proporciona contexto de asignación, no un sustituto de esos controles.
Para ejecuciones repetidas, mantenga juntos la exportación sin procesar, el manifiesto del archivo preparado, las referencias de tareas o solicitudes, el resultado devuelto, la versión de transformación y el informe de importación final. Este registro de auditoría permite a un analista explicar por qué un campo está presente, vacío o retenido. También permite al equipo volver a ejecutar solo la parte no resuelta sin reemplazar los valores conocidos con suposiciones. Por lo tanto, el resultado útil del enriquecimiento de números de teléfono es un registro rastreable con significados de campo precisos, no simplemente una nueva etiqueta de operador en una tarjeta de contacto.
Preguntas frecuentes
¿Cómo pueden los equipos almacenar una búsqueda completada sin nombre de operador?
Conserve el resultado de la búsqueda y la hora de comprobación, y deje el campo de operador opcional como no disponible. Un resultado completado puede tener detalles de operador vacíos. No convierta el espacio en blanco en un veredicto de que el número no es válido o no tiene operador. Si un flujo de trabajo empresarial requiere un operador conocido, coloque la fila en un grupo de revisión explícito en lugar de filtrarla silenciosamente.
¿Cómo pueden los equipos enriquecer números de teléfono duplicados en los contactos?
Conserve el ID de fila estable de cada contacto en una asignación auxiliar local, luego asocie el número canónico preparado con todos los ID de fila coincidentes. Después de reconciliar un resultado con ese número, expándalo a los contactos relevantes. Esto preserva los registros de CRM distintos mientras hace que la búsqueda y la importación sean auditables. Revise cualquier número que no pueda asignarse limpiamente antes de actualizar los registros de producción.
¿Puede el enriquecimiento probar que un contacto recibirá un mensaje?
No. El operador original, el tipo de línea y la geografía de asignación son contexto de rango de números. No muestran si un dispositivo está activo, si se puede entregar un mensaje o si el contacto ha dado su consentimiento. Trátelos como metadatos de apoyo para la segmentación y la revisión. Las decisiones de entrega y permiso requieren sus propios controles y evidencia fuera de esta búsqueda.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.