Cómo calentar cuentas mediante la API de Snov.io

Esta guía muestra cómo calentar cuentas de remitente en Snov.io mediante la API de calentamiento de correo electrónico.

Usa la API de calentamiento de correo electrónico para automatizar el calentamiento de remitentes a gran escala. Crea y administra campañas de calentamiento, supervisa el progreso de la capacidad de entrega y mantén las cuentas de remitente calentándose de forma continua como parte de tu flujo de trabajo de prospección mediante solicitudes a la API.

Antes de empezar

Estos son los métodos de la API organizados por etapa del flujo de trabajo:

Crear una campaña de calentamiento

Calienta una cuenta de remitente antes de usarla en tus campañas de prospección. Este método inicia una nueva campaña de calentamiento con la configuración que especifiques.

Parámetros obligatorios:

Los parámetros obligatorios establecen la configuración básica del calentamiento: qué cuenta se calentará y cuántos correos electrónicos enviará por día.

• email_account_id — la cuenta de correo electrónico que deseas calentar.
• per_day — la cantidad de correos electrónicos de calentamiento que se enviarán cada día. Puedes configurar de 1 a 1000 correos electrónicos por día, según tu plan. Consulta los límites de calentamiento aquí.

Parámetros opcionales:

Los parámetros opcionales te permiten ajustar con mayor precisión la estrategia de calentamiento, el contenido de los correos electrónicos y los proveedores con los que se realizará el calentamiento.

También puedes mejorar el rendimiento con opciones avanzadas, como un grupo de remitentes premium (solo para dominios empresariales), dominios de seguimiento personalizados y un proxy dinámico.

• strategy — la velocidad con la que aumentará el volumen de envío: progressive (predeterminado) incrementa gradualmente el volumen diario, mientras que steady lo mantiene en una cantidad fija durante todo el proceso.
• from — el volumen diario inicial al usar la estrategia progressive. Elige un valor entre 1 y 5 y asegúrate de que no sea superior al objetivo definido en per_day.
• increase — cuánto aumentará el volumen diario cada día al usar la estrategia progressive. Elige un valor entre 1 y 5.
• email_content — el contenido que se enviará durante el calentamiento: autogenerated (predeterminado) permite que Snov.io lo genere con IA, mientras que specific te permite proporcionar tu propia plantilla.
• subject — el asunto personalizado del correo electrónico (de 1 a 200 caracteres). Es obligatorio si configuras email_content como specific.
• body — el cuerpo personalizado del correo electrónico (de 1 a 10 000 caracteres). Es obligatorio si configuras email_content como specific.
• reply_rate — el porcentaje de correos electrónicos de calentamiento entrantes que recibirán una respuesta. Elige un valor entre 10 y 45. El valor predeterminado es 30.
• campaign_deadline — la fecha en la que debe finalizar el calentamiento (AAAA-MM-DD). Omite este parámetro si no deseas establecer una fecha límite.
• providers — los proveedores de correo electrónico con los que se realizará el calentamiento. Elige entre gmail, microsoft u other.
• send_to_paid_domain — indica si también se enviarán correos electrónicos de calentamiento a dominios de pago. El valor predeterminado es false.
• enable_ctd — habilita un dominio de seguimiento personalizado para este calentamiento. El valor predeterminado es false.
• enable_proxy — habilita un proxy dinámico para este calentamiento. El valor predeterminado es false.
• schedule_id — el programa de envío que deseas asociar a este calentamiento.
• template_name — el nombre de la plantilla de correo electrónico guardada que deseas utilizar.

Obtener la lista de campañas de calentamiento

Obtén una vista general de todas las campañas de calentamiento de tus cuentas de remitente, con la opción de filtrar por estado o paginar los resultados.

Parámetros obligatorios:

Ninguno: este método devuelve todas tus campañas de calentamiento si no especificas ningún parámetro opcional.

Parámetros opcionales:

Los parámetros opcionales te permiten filtrar por el estado de la campaña y controlar la paginación, limitando los resultados a campañas activas, pausadas, completadas o fallidas, y eligiendo cuántos resultados mostrar por página.

• page — la página de resultados que se mostrará. Comienza en 1 (valor predeterminado).
• per_page — la cantidad de resultados que se mostrarán por página. Elige entre 20, 50 o 100. El valor predeterminado es 20.
• status — limita los resultados a un estado específico: active, paused, completed o error. Omite este parámetro para obtener todas las campañas de calentamiento.

Obtener información de una campaña de calentamiento

Revisa la configuración y el estado actuales de una campaña de calentamiento.

Este método devuelve todos los detalles de la campaña, incluida la configuración de la estrategia, los límites diarios, las estadísticas actuales de capacidad de entrega y la cuenta de correo electrónico conectada, para que puedas supervisar el progreso y verificar la configuración antes de realizar cambios.

Parámetros obligatorios:

id — la campaña de calentamiento que deseas consultar. Puedes obtener este valor de la respuesta del método Obtener la lista de campañas de calentamiento.

Actualizar una campaña de calentamiento

Ajusta la estrategia de calentamiento, los límites diarios, el estado o la configuración del contenido sin reiniciar la campaña.

Este método actualiza parcialmente una campaña de calentamiento existente: solo se modificarán los campos que envíes; el resto de la configuración permanecerá sin cambios.

Parámetros obligatorios:

id — la campaña de calentamiento que deseas actualizar. Puedes obtener este valor de la respuesta del método Obtener la lista de campañas de calentamiento.

Parámetros opcionales:

make_endless: true — elimina la fecha límite de la campaña para que el calentamiento continúe ejecutándose de forma indefinida. Esto reemplaza cualquier fecha límite que hayas configurado previamente.

Todos los demás parámetros opcionales funcionan de la misma manera que en el método Crear una campaña de calentamiento, por lo que puedes ajustar cualquier parte de la configuración del calentamiento.

Consulta Crear una campaña de calentamiento para ver la lista completa de parámetros.

Obtener estadísticas del calentamiento

Supervisa la evolución de la tasa de llegada a la bandeja de entrada e identifica los proveedores de correo electrónico en los que el calentamiento tiene un rendimiento inferior.

Este método devuelve estadísticas de capacidad de entrega diarias y por proveedor para una campaña de calentamiento.

Puedes consultar las estadísticas de un período predeterminado o especificar un intervalo de fechas personalizado, lo que resulta útil para hacer un seguimiento del progreso en distintas etapas o comparar el rendimiento entre diferentes períodos.

Parámetros obligatorios:

id — la campaña de calentamiento de la que deseas obtener estadísticas. Puedes obtener este valor de la respuesta del método Obtener la lista de campañas de calentamiento.

• period — un período predefinido: two_weeks o month. Es obligatorio si no proporcionas date_from / date_to.
• date_from — la fecha de inicio del intervalo personalizado (AAAA-MM-DD). Es obligatoria si no proporcionas period.
• date_to — la fecha de finalización del intervalo personalizado (AAAA-MM-DD). Debe ser igual o posterior a date_from y también igual o posterior a la fecha de inicio de la campaña. Es obligatoria si no proporcionas period.

Eliminar una campaña de calentamiento

Elimina una campaña de calentamiento que ya no necesites. Esta acción no se puede deshacer.

Este método elimina de forma permanente una campaña de calentamiento y sus estadísticas; ya no estarán disponibles mediante otros métodos de la API de calentamiento. Úsalo cuando hayas completado el calentamiento o ya no necesites realizar el seguimiento de una campaña.

Parámetros obligatorios:

id — la campaña de calentamiento que deseas eliminar. Puedes obtener este valor de la respuesta del método Obtener la lista de campañas de calentamiento.