Integración de validación de correo electrónico para Cloudflare Worker

La validación de correo electrónico de ZeroBounce le permite identificar rápidamente los correos electrónicos válidos, no válidos y de alto riesgo. La nueva integración con Cloudflare Worker le permite validar correos electrónicos en cualquiera de sus sitios web en tiempo real sin sobrecarga ni ralentización. La perfecta integración permite un impacto nulo en la experiencia del usuario.

Para iniciar la integración de Cloudflare Worker, solo necesita copiar y pegar el script del worker en su sitio. No necesita clonar ningún proyecto de Git, instalar Wrangler ni ninguna herramienta adicional.Copie el script del worker desde aquí

Sin embargo, hay varios requisitos previos que debe configurar antes de aplicar el script del worker.

Siga estos pasos para utilizar la integración:

Paso 1 - Crear almacenamiento para sus registros de validación de correo electrónico

1. Desde su cuenta de Cloudflare, vaya al menú de la izquierda y haga clic en Workers KV.
2. Clic Cree un espacio de nombres.
   Captura de pantalla del espacio de nombres de Cloudflare Workers KV para almacenar registros de validación de correo electrónico
3. Ingrese un nombre para sus registros en el campo "Nombre del espacio de nombres". Recomendamos usar el nombre ZEROBOUNCE_LOGS.
4. Clic Agréguelo.

Paso 2 - Crear el worker

1. Desde el menú de la izquierda, haga clic en Workers.
2. En el menú Crear un servicio, ingrese un nombre en el campo "Nombre del servicio". Puede nombrarlo como quiera o usar el nombre predeterminado proporcionado por Cloudflare.
   Una captura de pantalla del menú de Cloudflare Workers donde puede crear un servicio para la integración de ZeroBounce Cloudflare Worker
3. En las opciones, seleccione controlador HTTP.
4. Click Cree el servicio.

Paso 3 - Configurar variables

Después de crear el servicio, se lo redirigirá automáticamente a la descripción general del servicio.

Desde aquí

1. Haga clic en la pestaña Configuración.
2. Haga clic en Variables.
3. Click Agregue la variable. Cree los siguientes nombres y valores de variables,
   Ejemplo de cómo crear variables para usar en la integración de ZeroBounce Cloudflare Worker

   Nombre de la variable	Valor
   API_KEY	(Recupere su API y aplíquela aquí)
   API_TIMEOUT	5000
   VALID_STATUS	[‘valid’, ‘catch-all’, ‘unknown’]

   Para una explicación más detallada:

   ● API_KEY - Su clave de API de ZeroBounce - Recupérela desde su cuenta

   ● API_TIMEOUT - Tiempo en milisegundos

   ● VALID_STATUS - Sus códigos de estado de validación aceptados. Puede encontrar más códigos de estado de validación de correo electrónico disponibles y conocerlos aquí

4. Para mayor seguridad, haga clic en Cifrar junto a su variable API_KEY.
5. Click Guarde e implemente. Sus resultados deberían aparecer como lo hacen en la imagen a continuación.
   Ejemplo de cómo se ven las variables de entorno en Cloudflare Worker

Paso 4 - Agregar un enlace

1. En los detalles del worker, vaya a la pestaña Configuración -> Variables, busque la sección titulada Vínculos de espacio de nombres KV. Haga clic en Agregar enlace.
Captura de pantalla de cómo agregar un enlace para un espacio de nombres en Cloudflare Worker
2. En "Nombre de la variable", ingrese LOGS.
Ejemplo de cómo crear registros para la integración de validación de correo electrónico de ZeroBounce Cloudflare Worker
3. En "Espacio de nombres KV", seleccione el espacio de nombres que creó en el paso 1.
4. Click Guarde e implemente.

Paso 5 - Agregar el script del worker

1. Haga clic en el botón Edición rápida en la página de detalles de Worker.
2. Copie el script del worker desde aquí y péguelo en el lado izquierdo de la página:
   Página de Cloudflare Worker que muestra dónde agregar el script del worker
3. Click Guarde e implemente.
4. Su script de trabajo ahora se ha actualizado y está listo para usarse.

Paso 6 - Desencadenadores

1. Haga clic en la pestaña Desencadenadores.
Menú de Cloudflare Worker que muestra dónde agregar desencadenadores y rutas para la integración de ZeroBounce
2. En la sección "Rutas", haga clic en Agregar ruta.
3. En el campo "Ruta", ingrese la URL del sitio web donde desea ejecutar el worker.
4. Utilice el menú desplegable "Zona" para seleccionar una zona que coincida con la URL ingresada.
Ejemplo de cómo crear una ruta y una zona para su Cloudflare Worker cuando usa la validación de correo electrónico de ZeroBounce

Ejemplo

Ruta - "example.com"

Zona - example.com

Al especificar este patrón, le indica al worker que

• Coincide con todos los subdominios de "example.com"
• Coincide con todas las URL de "example.com"

Este es el método más directo de aplicar el worker. Sin embargo, si ya tiene un worker existente en esta ruta, puede ejecutar el worker en /solo contacto, por ejemplo.

Con esto, la instalación está completa. Para probar la integración de Cloudflare Worker, ingrese un correo electrónico en uno de los formularios de su sitio web. A continuación, puede consultar los registros en su espacio de nombres de Worker KV para ver los resultados.

Dado que se trata de almacenamiento de clave-valor, cada entrada del registro tiene un prefijo, por lo que también puede enumerar todos los registros que comienzan con un prefijo particular. Por ejemplo, es posible que quiera ver los registros de una fecha, un correo electrónico o una URL específicos.

El siguiente ejemplo es un prefijo de registro con un correo electrónico temporario en un formulario de contacto.

{2023-02-25}-{caligyje@brand-app.biz}-{/.testing/contact.php}-{07:49}-47.373

Puede usar el siguiente método para enumerar los registros por un prefijo específico, por ejemplo, para enumerar todos los registros del 25 de febrero de 2023:

Y, por ejemplo, para enumerar por correo electrónico (también necesita fecha):

Solución de problemas

Si tiene problemas con el worker, intente los siguientes pasos de solución de problemas.

Problemas de validación

Si no se produce la validación de correo electrónico, verifique lo siguiente:

1. Asegúrese de que su formulario tenga una entrada de correo electrónico, preferiblemente con el nombre/ID: "correo electrónico".
2. Vuelva a verificar las variables del entorno.
3. Asegúrese de implementar el worker en la ruta de la URL correcta.

Si se verifica lo anterior, puede habilitar el registro del worker; para ello, vaya a la pestaña Registros (junto a Desencadenadores) y habilite los registros en tiempo real. Luego, vaya a su formulario e intente nuevamente con un correo electrónico no válido. Se deben generar registros que puedan identificar el problema.

Problemas de ejecución

Otro problema común es que el worker podría interrumpir alguna solicitud de API u otra funcionalidad. Si bien es poco probable que eso suceda, hay una solución disponible.

1. Regrese a la pestaña Configuracióny haga clic en Variables.
2. Cree una nueva variable llamada BYPASS_PATH.
3. Ingrese la ruta que quiere ignorar. Por ejemplo, podría deshabilitar la validación en las rutas de inicio de sesión: '/login', '/logout', '/connect', '/signing'.