Para listas de direcciones existentes
Verifique listas de correo mediante la API
Su script o aplicación envía una petición a Emvero por cada dirección de la lista. La API devuelve un estado, una acción recomendada y los motivos del resultado, que puede guardar junto a los datos originales.
Emvero no ofrece una interfaz para subir archivos CSV ni un panel para ejecutar verificaciones masivas. Su sistema lee la lista, envía las peticiones y guarda los resultados. La verificación no envía mensajes a las direcciones comprobadas.
Una petición por dirección · Sin envío de mensajes · Resultados en su sistema
| Resultado | Filas | Porcentaje |
|---|---|---|
| Entregable | 104.852 | 83,6 % |
| Con riesgo | 9112 | 7,3 % |
| No entregable | 9804 | 7,8 % |
| Desconocido | 1652 | 1,3 % |
Lista ficticia con cifras de ejemplo. No son resultados de una lista de clientes ni una previsión para otras listas.
Cómo se comprueba una lista
La API comprueba una dirección en cada petición. Para verificar una lista, un script, una tarea programada o una aplicación repite la operación con cada dirección. La respuesta usa los mismos campos que una verificación individual.
Lea las direcciones
El proceso puede leer un archivo CSV, una exportación del CRM o una base de datos. Emvero recibe las direcciones en peticiones individuales; el archivo completo permanece en su sistema.
Elija la profundidad
La verificación completa puede consultar al servidor receptor sobre el destinatario, si el servidor lo permite. La comprobación de dominio se detiene antes de SMTP y no confirma que exista un buzón concreto.
Guarde los resultados
Guarde el estado y la acción recomendada junto a la fila original. Los campos checks y reason_codes describen las comprobaciones realizadas y los motivos del resultado.
Pasos para procesar un CSV
Antes de empezar, necesita una cuenta confirmada, una clave de API y saldo de créditos. Guarde la clave en su servidor; no la incluya en el código del navegador.
- Lea una dirección y conserve el identificador de su fila.
- Envíe la dirección desde su servidor a
POST /v1/verifications. - Si la respuesta es
pending, guarde el identificador de la verificación. Espere el intervaloretry_after_msy consulte el resultado con la misma credencial. Si sigue pendiente, repita la consulta dentro del plazo que haya fijado. - Guarde el resultado final junto a la fila original. Si la comprobación sigue pendiente al vencer su plazo, conserve el identificador para consultarla más tarde. Continúe con las demás direcciones.
Su proceso decide cuántas peticiones enviar a la vez, cuándo reintentar y cómo guardar los resultados. Debe respetar los límites de la API y fijar un plazo de espera para las verificaciones pendientes. La página de la API de verificación de correo explica las peticiones, la consulta de resultados y el tratamiento de errores.
Cómo interpretar los cuatro estados finales
- Entregable (
deliverable): las pruebas disponibles indican que la dirección puede recibir correo. - Con riesgo (
risky): hay una señal que requiere tener en cuenta los motivos del resultado y la acción recomendada. - No entregable (
undeliverable): se ha identificado un impedimento técnico permanente, como un dominio inexistente. - Desconocido (
unknown): la información reunida no permite resolver si la dirección puede recibir correo.
Los siguientes ejemplos muestran por qué un mismo estado «con riesgo» puede llevar acciones distintas:
| Dirección | Estado | Acción | Códigos de motivo |
|---|---|---|---|
| k.novak@catchall.example | Con riesgo | allow_with_email_confirmation | SMTP_RCPT_ACCEPTED - Destinatario aceptadoACCEPT_ALL_DOMAIN - El dominio acepta a cualquier destinatario |
| a.dvorak@corp.example | Con riesgo | allow_with_email_confirmation | SMTP_MAILBOX_DISABLED - Buzón desactivado |
| p.ruiz@corp.example | Con riesgo | allow_with_email_confirmation | SMTP_MAILBOX_STATUS_ERROR - El buzón informó de un problema |
| test@mailinator.example | Con riesgo | allow | SMTP_RCPT_ACCEPTED - Destinatario aceptadoDISPOSABLE_DOMAIN - Proveedor de direcciones desechables |
Direcciones ficticias de ejemplo. Los dominios .example están reservados para este tipo de uso; las filas no corresponden a buzones reales.
Un resultado risky no exige siempre la misma decisión. Los ejemplos incluyen un dominio catch-all, un buzón con incidencias y una dirección desechable. Cada caso tiene sus propios motivos y la acción puede variar. Una dirección genérica también puede aportar una señal, pero esa señal por sí sola no determina el estado. Lea action para conocer la recomendación y reason_codes para aplicar reglas más específicas.
Mantenga los resultados unknown separados de los undeliverable. Un tiempo de espera agotado o un servidor que no proporciona información suficiente pueden dejar una dirección sin resolver; no demuestran que sea inválida. pending, por su parte, significa que la comprobación sigue en curso y aún no hay un resultado final.
Profundidad de la comprobación y coste
Una verificación completa puede obtener información sobre el destinatario mediante SMTP y consume como máximo 10 créditos. La comprobación de dominio revisa el formato de la dirección, el DNS y la ruta de correo, sin abrir una sesión SMTP; consume como máximo 2 créditos. Ambas están disponibles para todas las cuentas y usan el mismo saldo.
El cargo final depende del resultado y puede ser menor que ese máximo. Si solo se obtienen pruebas sobre la ruta, el cargo puede ser de 2 créditos; una entrada mal formada, un fallo técnico o una ruta sin resolver no consumen créditos. Los créditos iniciales también pueden usarse en cualquiera de las dos profundidades. Elija según la información que necesite: una ruta de correo válida no confirma un buzón concreto.
Qué puede cambiar después de verificar la lista
Una dirección guardada puede contener una errata o dejar de recibir correo con el tiempo. Por ejemplo, alguien puede abandonar una empresa y perder el acceso a su buzón, o el dominio puede cambiar su configuración. Comprobar la lista cerca del momento del envío permite detectar los problemas técnicos que ya se pueden establecer.
La verificación no garantiza que un mensaje posterior se entregue o llegue a la bandeja de entrada. La entrega también depende de la reputación y la autenticación del remitente, del contenido, del comportamiento del destinatario y de la política del servidor receptor. La comparación entre verificación e higiene de listas explica qué corresponde a cada tarea.
Cuándo usar la verificación masiva o en tiempo real
| Masiva | En tiempo real |
|---|---|
| Comprueba direcciones guardadas en una lista | Comprueba la dirección introducida en un formulario |
| Se ejecuta en un proceso propio, como una tarea programada | Se ejecuta durante un registro, una compra o una solicitud |
| Guarda los resultados junto a los datos originales | Permite decidir cómo continuar el formulario |
Puede consultar después un resultado pending |
Necesita prever qué mostrar mientras el resultado sea pending |
La verificación en tiempo real explica cómo comprobar una dirección mientras una persona rellena el formulario. Las dos formas de uso recurren a la misma API desde el servidor y comparten el saldo de créditos.
Cómo se tratan las direcciones comprobadas
Verificación y reutilización de resultados
La verificación no envía mensajes a las direcciones de la lista. Si hay un resultado guardado que sigue vigente para la profundidad elegida, puede reutilizarse sin consultar de nuevo al servidor de correo. Las respuestas no incluyen el texto original de ese servidor: los códigos de motivo describen la información obtenida.
Compromisos de tratamiento de datos
El cifrado en reposo es AES-256, el plazo de conservación es de 30 días y la supresión a petición se realiza en 72 horas. El tratamiento se limita al EEE.
Uso aceptable
Verificación de direcciones ya obtenidas
Emvero verifica las direcciones proporcionadas. No recopila contactos ni determina si el destinatario ha dado su consentimiento para recibir mensajes.
Las direcciones las proporciona el cliente
Emvero no busca, adivina, vende ni sugiere direcciones de correo, ni completa datos de contacto con direcciones nuevas. No dispone de un directorio de contactos. Solo comprueba las direcciones que ya se han obtenido.
El consentimiento se comprueba por separado
El estado «entregable» describe la evidencia técnica sobre la dirección. El permiso para escribir a la persona depende de cómo se obtuvieron sus datos y de lo que haya consentido.
Usos prohibidos
No se permite enumerar buzones de un dominio, comprobar listas compradas o direcciones extraídas automáticamente de otras fuentes, ni usar el servicio para facilitar mensajes no solicitados. Los patrones de enumeración se consideran abuso con independencia del volumen y conllevan la suspensión de la credencial. Las condiciones de uso recogen estas restricciones.
La verificación no envía mensajes
Una verificación completa puede consultar al servidor de correo del destinatario. La sesión SMTP termina antes de transmitir los datos del mensaje, por lo que no se envía correo a la dirección comprobada.
Preguntas
Preguntas frecuentes.
¿Cómo funciona la verificación masiva de correo en Emvero?
Un script o una aplicación propios recorre la lista y envía una petición a la API por cada dirección. Cada resultado puede guardarse junto a la fila de origen. Se usa el mismo endpoint que para verificar una sola dirección; no hay carga de archivos ni un endpoint específico para lotes.
¿Puedo verificar un archivo CSV?
Sí, mediante un script o una aplicación propios. El proceso lee la columna de direcciones, envía una petición por cada una y guarda el resultado final en el archivo. Si recibe pending, debe esperar el intervalo indicado y consultar de nuevo el resultado por su identificador. El CSV permanece en su sistema.
¿La verificación masiva envía correos a la lista?
No. Una verificación completa puede consultar al servidor de correo sobre el destinatario mediante SMTP, pero la sesión termina antes de DATA. No se transmite ningún asunto ni cuerpo de mensaje.
¿Qué hago con los resultados desconocidos?
Manténgalos separados de los no entregables. unknown significa que la información disponible no permite determinar si la dirección puede recibir correo. Puede volver a comprobarla más tarde o pedir confirmación por correo cuando tenga sentido para su proceso. La incertidumbre por sí sola no justifica tratarla como inválida.
¿La verificación garantiza que no habrá rebotes?
No. Un buzón puede cerrarse o llenarse después de comprobarlo, y el servidor puede rechazar un mensaje posterior por otros motivos. La verificación permite detectar problemas técnicos antes del envío, pero no garantiza que el mensaje se entregue ni que llegue a la bandeja de entrada.
En comparación directa
Tiempo real frente a verificación masiva
Las mismas comprobaciones y los mismos cuatro veredictos, en dos formas. Tiempo real responde una dirección mientras alguien espera; masiva recorre una lista que ya tiene.
Verificación frente a higiene de listas
La verificación es un hecho sobre una dirección en un momento. La higiene de listas es una práctica sobre el interés a lo largo del tiempo. Ninguna sustituye a la otra.
Dominio catch-all
Un dominio cuyo servidor acepta destinatarios aunque no exista un buzón para cada dirección.
Pruebe la API con su lista
Empiece con los créditos de su cuenta
Cree una cuenta y confírmela para recibir 1000 créditos sin tarjeta. Alcanzan para 100 verificaciones completas o hasta 500 comprobaciones de dominio. Después, cree una clave de API y envíe una petición por dirección desde su servidor.