Verificación masiva de avatares de email: prepare el archivo y lea el CSV
Prepare un TXT o CSV de email, envíe una tarea asíncrona y analice los campos identifier, activated, avatar y avatar_url con precaución.
Una tarea masiva de avatares de email devuelve observaciones en formato CSV específicas de la fuente tras una ejecución asíncrona.
Una verificación masiva de avatares de email comienza con un archivo TXT o CSV que contiene una dirección de Gmail, Yandex o Mail.ru compatible por línea. El producto de avatares de email masivos de AvatarLookup se ejecuta de forma asíncrona: usted envía el archivo, comprueba el estado de la tarea y, cuando finaliza con éxito, descarga un CSV. El CSV contiene los campos identifier, activated, avatar y avatar_url. Interprete cada campo en el contexto de este producto de email y nunca convierta una URL de avatar vacía en una afirmación sobre el buzón o la persona.
Prepare un archivo limpio con direcciones de email compatibles
Comience con una lista que su organización esté autorizada a procesar. Mantenga una dirección de email por línea en formato TXT o CSV. Filtre las direcciones según las familias de dominios compatibles: Gmail, Yandex y Mail.ru; la documentación del producto de AvatarLookup proporciona el alcance actual y las reglas de entrada. Conserve una copia de la lista original con una clave de registro interna para que el resultado descargado pueda vincularse correctamente al registro de contacto correspondiente más adelante.
Normalice los espacios accidentales al principio o al final y marque las direcciones mal formadas antes de cargarlas. Una segunda pasada debería detectar duplicados para que el equipo comprenda si una dirección repetida representa un solo contacto o varios registros. No asuma que una exportación de hoja de cálculo CSV es automáticamente adecuada: inspeccione el archivo real y mantenga el campo identifier en el formato esperado de uno por línea. XLSX no es un formato de carga masiva aceptado.
Las tareas de email no utilizan un campo de país. Esa distinción es importante cuando un equipo también ejecuta productos masivos basados en números de teléfono con requisitos de entrada diferentes. Mantenga la selección del producto y el nombre del archivo explícitos en el registro de trabajo; un archivo de email enviado bajo un producto de teléfono no sería una verificación de avatar significativa. Confirme el mínimo, el máximo y las reglas de archivo actuales del producto seleccionado en la documentación de la API en lugar de aplicar un límite antiguo a una ejecución operativa.
Envíe, supervise y descargue la tarea
El endpoint documentado para tareas masivas es POST /api/v1/bulk-tasks. Un envío exitoso inicia una tarea asíncrona y proporciona al equipo una referencia para realizar consultas. Utilice GET /api/v1/bulk-tasks/{id} para comprobar su estado; la documentación del producto indica no realizar consultas con una frecuencia superior a 30 segundos. Cuando la tarea finalice con éxito, descargue el CSV de resultados desde el enlace proporcionado. Si el enlace ya no está disponible, consulte la misma tarea para obtener un enlace actualizado según el comportamiento documentado.
No considere la aceptación de una carga como la finalización de las verificaciones. Una tarea puede permanecer en curso o fallar. Una hoja de operaciones sencilla puede registrar la versión del archivo de entrada, el producto de email masivo seleccionado, la hora de envío, la referencia de la tarea, el último estado observado y si se descargó el CSV. El estado, no el tiempo transcurrido, determina si el equipo dispone de un conjunto de datos completo.
Almacene el CSV junto con el registro de la tarea para que otro compañero pueda auditar qué entrada lo produjo. Si el número de filas descargadas difiere del recuento de la entrada preparada, investigue antes de fusionar las observaciones en un CRM. Mantenga los errores y los resultados indeterminados separados de las filas completadas. El flujo de trabajo masivo del producto tiene sus propios campos y semántica de resultados, por lo que no traslade suposiciones de un artículo sobre WhatsApp o Telegram masivo a esta tarea de email.
Lea las cuatro columnas del CSV de email masivo
El CSV de avatares de email masivos tiene cuatro columnas documentadas: identifier, activated, avatar y avatar_url. Identifier vincula la fila con la dirección de email enviada. Activated es el campo de presencia de cuenta del servicio para este producto de email. Avatar registra la señal de avatar público del producto, y avatar_url es la ubicación de la imagen relacionada cuando está disponible. Deben utilizarse los recursos oficiales de AvatarLookup para conocer las definiciones de campo actuales y cualquier ejemplo actualizado.
| Columna | Pregunta de revisión | Interpretación segura |
|---|---|---|
| identifier | ¿A qué dirección enviada corresponde esta fila? | Coincídala con la lista preparada |
| activated | ¿Qué señal de presencia de cuenta se devolvió? | Trátela como específica de la fuente, no como verificación de persona |
| avatar | ¿Se informó sobre la disponibilidad de avatar público? | Manténgalo distinto del estado del buzón |
| avatar_url | ¿Se proporcionó una ubicación de imagen? | Un campo vacío no es prueba de que no exista un avatar |
Una celda avatar_url vacía es especialmente fácil de malinterpretar. Por sí sola, no establece que la dirección de email sea inválida, que no exista un buzón o incluso que la persona no tenga una imagen. La visibilidad y el comportamiento de la fuente limitan lo que se puede observar. La guía de uso compartido de perfiles de Google ilustra que los usuarios controlan aspectos del descubrimiento de perfiles y la visibilidad de las fotos. Un revisor debe utilizar el resultado real del producto y el momento de la verificación, no una historia inventada a partir de una celda en blanco.
Convierta el CSV en una actualización cuidadosa de datos de contacto
Antes de importar los resultados, decida qué columnas pueden actualizar el sistema de contactos y cuáles deben permanecer en una vista de auditoría. El identifier debe coincidir con una clave de registro conocida; una imagen pública disponible puede considerarse solo bajo las reglas de manejo de datos de la organización. Un resultado de imagen ausente o indeterminado no debería borrar una foto proporcionada por el cliente. Un conflicto entre una imagen pública y un registro existente debería pasar a revisión en lugar de ser reemplazado automáticamente.
Inspeccione una muestra de filas con una imagen disponible, filas sin ella y filas que necesiten investigación. Confirme que las etiquetas de fuente, la fecha de verificación y la referencia de la tarea permanezcan adjuntas a las observaciones. Esto permite volver a examinar un resultado cuestionable sin tratar un CSV antiguo como una verdad permanente. La información del perfil público puede cambiar, por lo que una verificación posterior puede diferir de la instantánea del archivo.
Finalmente, informe sobre la ejecución en términos operativos: cuántas direcciones preparadas eran elegibles, cuántas filas aparecieron en el CSV exitoso y qué filas necesitan seguimiento. No informe sobre "personas verificadas" o "cuentas reales confirmadas". La tarea proporciona un contexto limitado de avatar público y presencia de cuenta para las fuentes de email compatibles. Su valor reside en un flujo de trabajo de datos de contacto más claro con incógnitas explícitas.
Preguntas frecuentes
¿Cómo pueden los equipos formatear la entrada de avatares de email masivos?
Utilice TXT o CSV con una dirección de email compatible por línea y siga las reglas actuales de recuento y archivo específicas del producto.
¿Cómo pueden los equipos saber cuándo están listos los resultados?
Consulte el estado de la tarea en el intervalo documentado y descargue el CSV solo después de que la tarea finalice con éxito.
¿Cómo pueden los equipos interpretar una celda avatar_url en blanco?
Significa que no hay ninguna URL disponible en esa fila; no es prueba de que no exista un buzón, una cuenta o una imagen pública.
¿Cómo pueden los equipos vincular los resultados a los registros de contacto?
Haga coincidir el identifier con la entrada preparada y conserve la referencia de la tarea y la hora de verificación antes de aplicar una actualización de datos autorizada.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.