API de Puntuación A.I.

La API de Puntuación A.I. de ZeroBounce combina una amplia selección de datos con análisis estadísticos comprobados para calificar con granularidad el nivel de calidad de una dirección de correo electrónico. El software identifica patrones positivos y negativos de un correo y devuelve una puntuación en la que los usuarios pueden confiar al realizar su higiene de correo electrónico. La metodología de ZeroBounce A.I. se ajusta periódicamente a medida que evolucionan las tendencias de email.

Obtenga una visión detallada de la calidad de sus leads aprendiendo más sobre la actividad en línea de sus suscriptores. Con la información adicional, puede segmentar sus listas para servir mejor a sus clientes con mensajes dirigidos. Si desea segmentar aún más su lista de correos según el Quality Score, recomendamos también validar su archivo "válido".

Endpoint recomendado de gestión de archivos para A.I. Scoring

Uso recomendado del endpoint de gestión de archivos

¿Listo para usar nuestra API de puntuación de correos electrónicos en masa?

La API scoring sendfile le permite enviar un archivo para la puntuación masiva de correos electrónicos. El tipo de contenido debe ser multipart/form-data. Consulte el ejemplo en C# para más detalles.

POST /V2/SCORING/SENDFILE

URL de la API: https://bulkapi.zerobounce.net/v2/scoring/sendfile

A continuación verá una lista de los parámetros requeridos. Por favor reúna estos datos en el formato correcto antes de continuar.

• Su archivo debe tener formato .csv o .txt.
• Luego, necesitará su clave API única, que puede encontrar en su cuenta de ZeroBounce.

Si se especificó una return_url en el formulario Multipart Form Data durante la solicitud de envío del archivo, enviaremos los siguientes datos mediante POST a la URL cuando el proceso de validación se complete.

    {

        "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff",
        "file_name": "Your file name.csv",
        "upload_date": "2023-04-28T15:25:41Z" 
   
    }        
      

EJEMPLOS DE CÓDIGO PARA ENVIAR ARCHIVO

RESPUESTA DEL ENDPOINT

Aquí le proporcionamos ejemplos tanto de respuestas exitosas como de error para la API de puntuación masiva de correos electrónicos.

Respuesta exitosa

    {
        "success": true,
        "message": "File Accepted",
        "file_name": "Your file name.csv",
        "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff"
    }

Respuesta de error

    {
        "success": false,
        "message": [
            "Error messages"
        ]
    }

¿Tiene preguntas o necesita ayuda para comenzar con la API de puntuación masiva de correos electrónicos de ZeroBounce? Por favor comuníquese con nuestro equipo. Nuestros especialistas de Atención al Cliente están disponibles 24/7 para guiarlo y ayudar a aclarar posibles problemas.

La API de puntuación de correos electrónicos puede utilizarse tanto en masa como en tiempo real.

¿Te gustaría ver el estado de un archivo que enviaste mediante la API de puntuación de correos electrónicos de ZeroBounce? Puedes revisarlo en cualquier momento y ver detalles sobre tu uso de créditos y los datos procesados.

La API de estado de archivos de puntuación devuelve el estado de procesamiento del archivo que enviaste utilizando la API sendfile. Consulta el ejemplo en C# para más detalles.

GET /V2/SCORING/FILESTATUS

URL de la API: https://bulkapi.zerobounce.net/v2/scoring/filestatus

Si deseas llamar a la API desde tu navegador para probarla, todo lo que tienes que hacer es reemplazar la API KEY con tu clave API única y el FILE ID con el ID de archivo devuelto por scoring sendfile.

CÓDIGOS DE ESTADO DE ARCHIVO

RESPUESTA DEL ENDPOINT

A continuación proporcionamos ejemplos de respuestas exitosas y no exitosas al usar la API filestatus.

Este es un ejemplo de una respuesta exitosa:

    {
        "success": true,
        "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff",
        "file_name": "Your file name.csv",
        "upload_date": "2023-04-28T15:25:41Z",
        "file_status": "Complete",
        "complete_percentage": "100%",
        "return_url": "Your return URL if provided when calling sendfile API"
    }
    

Este es un ejemplo de una respuesta de error:

    {
        "success": false,
        "message": "Error messages"
    }
    

Usar la API de puntuación de correos electrónicos para validar aún más los correos catch-all te permite automatizar este proceso y ahorrar tiempo. ZeroBounce usará un crédito por cada dirección de correo electrónico que procese el sistema de puntuación.

¿Necesitas más ayuda con respecto al estado de archivos de la API de puntuación? Ponte en contacto con nuestro equipo de soporte; siempre estamos disponibles para responder tus preguntas y guiarte.

¿Ha utilizado nuestra API de calificación de correo electrónico y le gustaría obtener sus resultados?

La API de calificación getfile le permite obtener los resultados de calificación de su correo electrónico para el archivo que envió utilizando la API de calificación sendfile.

GET /V2/SCORING/GETFILE

Enlace de la API: https://bulkapi.zerobounce.net/v2/scoring/getfile

MUESTRAS DE CÓDIGO GET FILE

RESPUESTA DEL PUNTO FINAL

A continuación, proporcionamos ejemplos de respuestas exitosasa y no exitosas para el uso de la API getfile.

Este es un ejemplo de respuesta exitosa:

      //N/A
    

La API getfile de puntuación devuelve el archivo de resultados de puntuación. El tipo de contenido devuelto es "application/octet-stream". Puede obtener el nombre del archivo de response.Content.Headers.ContentDisposition.FileName. Si está llamando a la API directamente desde el navegador, puede guardar o abrir el archivo de resultados desde el navegador.

Este es un ejemplo de respuesta de error:

    {
      "success": false,
      "message": "Error messages"
    }

El sistema ZeroBounce Score es una de las herramientas más eficientes para determinar la validez de las direcciones de correo electrónico atrapatodo. La mayoría de nuestros clientes obtendrán un cierto número de estados "atrapatodo" en sus resultados de validación de correos electrónicos. Este tipo de correos electrónicos son imposibles de validar de la forma clásica. Es por eso que desarrollamos nuestro ZeroBounce Score: para ofrecerle una herramienta adicional que proporciona más información sobre la validez de sus correos electrónicos atrapatodo.

ZeroBounce Score le permite determinar cuáles de los correos electrónicos atrapatodo que se encuentran en su lista son válidos, para que pueda conservarlos y eliminar el resto.

Si tiene alguna duda sobre cómo obtener los resultados de ZeroBounce Score, envíenos un mensaje. Nuestro equipo de atención al cliente está disponible 24/7 para guiarle y responder a todas sus preguntas.

¿Está intentando eliminar un archivo que envió a través de la API de calificación de correo electrónicoⓘ de ZeroBounce? Una vez que haya recopilado sus resultados, puede eliminar el archivo en cualquier momento..

La API de calificación deletefile elimina los archivos que se enviaron utilizando la API de calificación sendfile. Antes de comenzar, tenga en cuenta que el archivo solo se puede eliminar cuando su estado es Completado.

GET /V2/SCORING/DELETEFILE

Enlace de la API: https://bulkapi.zerobounce.net/v2/scoring/deletefile

Para eliminar el archivo de API de calificación de correo electrónico, necesitará:

• su clave de la API que podrá encontrar en su cuenta
• el ID de archivo que usó cuando llamó a la API de calificación sendfile

EJEMPLOS DEL CÓDIGO DE ELIMINACIÓN DE ARCHIVO

API para Calificación usando IA: Eliminar archivo

RESPUESTA DEL PUNTO FINAL

A continuación, proporcionamos ejemplos de respuestas exitosas y no exitosas para el uso de la API deletefile.

Este es un ejemplo de respuesta exitosa:

  {
      "success": true,
      "message": "File Deleted",
      "file_name": "test2",
      "file_id": "b222a0fd-90d5-416c-8f1a-9cc3851fc823"
  }
      

Este es un ejemplo de respuesta no exitosade fallo:

  {
      "success": false,
      "message": "File cannot be found."
  }
  

La API de calificación de correo electrónicoⓘ de ZeroBounce le permite investigar todos los correos electrónicos atrapatodocatch-all en tiempo real, en el punto de entrada. La API automatiza el proceso de calificación, le ahorra tiempo y agrega la información a su base de datos de correo electrónico casi al instante.

Si necesita ayuda para eliminar su archivo de calificación de correo electrónicoⓘ, comuníquese con nuestro equipo de atención al cliente. Estamos disponibles loslas 24/7, los 365 días del año, para responder cualquier pregunta y guiarle a través dbrindarle orientación en el proceso.

Esta característica permite a los clientes obtener una puntuación para una dirección de email única en tiempo real.

- GET /V2/SCORING

URL API POR DEFECTO: https://api.zerobounce.net/v2/scoring

URL API EEUU*: https://api-us.zerobounce.net/v2/scoring

URL API UE: https://api-eu.zerobounce.net/v2/scoring

A continuación se encuentra la lista de parámetros requeridos. Por favor, formatee sus datos en este formato antes de proceder.

A continuación se muestran ejemplos de respuestas exitosas y no exitosas para usar la API de puntuación.

Este es un ejemplo de una respuesta exitosa:

    {
        "email": "mark@gmail.com",
        "score": 10
    }
  

Estos son ejemplos de respuestas no exitosas:

    {
        "error": "Missing parameter: api_key",
    }
  

    {
        "error": "Missing parameter: email",
    }
  

    {
        "error": "Invalid API key or your account ran out of credits",
    }
  

Mensaje de error para una sintaxis de email inválida:

    {
        "error": "Please provide a valid email address",
    }

¿Necesita más ayuda con la API de Puntuación de Email? Por favor contacte a nuestro equipo de soporte al cliente - siempre estamos disponibles 24/7 para responder cualquier pregunta y guiarle.