Esta guía explica cómo configurar secuencias de campañas y controlar todo el flujo de trabajo de prospección mediante la API de Snov.io.
- Obtener la configuración de la cuenta
- Administrar cuentas de correo electrónico remitentes
- Crear y administrar campañas
- Agregar y actualizar contenido de correo electrónico
- Administrar destinatarios
La API de campañas es una de las categorías de API disponibles para automatizar tu trabajo en Snov.io.
Úsala para crear y ejecutar campañas de prospección multicanal directamente desde tu código, sin tener que configurar todo manualmente en tu cuenta de Snov.io.
Qué puedes hacer con la API de campañas:
1) Ejecutar campañas automáticamente. Crea, edita e inicia campañas mediante solicitudes a la API.
2) Obtener webhooks en tiempo real. Realiza un seguimiento de las respuestas, las solicitudes de conexión aceptadas, las respuestas de InMail, las respuestas automáticas y otras acciones de los prospectos a medida que ocurren.
3) Sincronizar los datos de actividad con tus herramientas. Envía los datos de actividad de las campañas y de los destinatarios directamente a tu CRM, paneles o plataformas de analítica.
Antes de empezar a usar la API de campañas
Preparar la configuración de la cuenta
- Conecta al menos una cuenta de correo electrónico remitente. Calienta tus cuentas remitentes mediante Calentamiento de correo electrónico en la aplicación o la API de calentamiento de correo electrónico antes de iniciar las campañas.
- Crea al menos un horario de envío en Horarios de campañas.
- Crea o importa al menos una lista de no contacto en Listas de no contacto, o agrégala mediante el método de la API.
Preparar la lista de prospectos
recipient_list_id durante la creación de la campaña. Después de iniciar la campaña, sigue agregando nuevos leads a la misma lista mediante la API para inscribirlos automáticamente en la secuencia.Encontrar nuevos prospectos
Si necesitas encontrar leads, utiliza la API de búsqueda de correos electrónicos para encontrar prospectos y contactos de empresas.
Verificar direcciones de correo electrónico existentes
Verifica las direcciones de correo electrónico de tu CRM, registros de eventos o bases de datos de terceros antes de iniciar la prospección mediante la API de verificación de correos electrónicos. Reduce las tasas de rebote y mejora la capacidad de entrega.
Organizar los prospectos en una lista
Crea una lista para tus prospectos y agrégalos mediante los métodos de la API para listas de prospectos. Utiliza el list_id al crear campañas.
Métodos de la API de campañas
Estos son los métodos de la API organizados según cada etapa del flujo de trabajo:
Obtener la configuración de la cuenta
Estos métodos te permiten recuperar la configuración de envío que ya has agregado a tu cuenta. Necesitarás los ID de cada uno de los siguientes elementos de configuración para utilizar el método de la API que crea campañas.
Obtener tus cuentas de correo electrónico remitentes
Obtén el ID de la cuenta remitente y confirma los límites diarios antes de asignar la cuenta a una campaña.
Devuelve todas las cuentas de correo electrónico conectadas junto con los nombres de los remitentes, direcciones de correo electrónico, límites diarios e información del proveedor.
Comprobar el estado SMTP/IMAP de una cuenta remitente
Verifica que la conexión de la cuenta esté activa y no presente errores antes de utilizarla en una campaña.
Parámetro obligatorio:
email — la dirección de correo electrónico de la cuenta remitente que deseas comprobar.
Obtener tus listas de no contacto
Recupera las listas de no contacto creadas en tu cuenta.
Obtén el ID de la lista de no contacto que asignarás a una campaña para excluir automáticamente a determinados contactos de la secuencia.
Obtener los horarios de tus campañas
Obtén el ID del horario que utilizarás en una campaña.
Devuelve todos los horarios creados en tu cuenta, incluida la zona horaria, los días activos y las franjas horarias de envío.
Administrar cuentas de correo electrónico remitentes
Estos métodos te permiten conectar, configurar y calentar cuentas de correo electrónico.
Agregar una nueva cuenta de correo electrónico
Conecta una cuenta de correo electrónico mediante la configuración SMTP e IMAP para poder asignarla como remitente en tus campañas.
Parámetros obligatorios:
Las credenciales SMTP de la cuenta y la configuración del servidor.
sender_name, email_from, password, smtp.host, smtp.port, smtp.encryption
Parámetros opcionales
- Configuración IMAP: para hacer seguimiento de las respuestas a los correos enviados desde esta cuenta remitente.
- Intervalo entre correos electrónicos: si no se especifica, la cuenta utilizará el intervalo predeterminado de 600 segundos entre correos.
- Límite diario de envíos: si no se especifica, la cuenta utilizará el límite SMTP predeterminado de 50 correos electrónicos por día.
Actualizar una cuenta de correo electrónico
Actualiza la configuración de una cuenta remitente existente (por ejemplo, los límites diarios de envío o el nombre para mostrar) sin necesidad de volver a conectarla. Solo se actualizarán los campos que incluyas en la solicitud; el resto permanecerá sin cambios.
Parámetros obligatorios:
account_id — el ID de la cuenta remitente que deseas actualizar.
Iniciar el calentamiento
Parámetros obligatorios:
sender_account_id — ID de la cuenta de correo electrónico que se va a calentar.
per_day — objetivo diario de envío; número de correos electrónicos enviados al día durante el calentamiento. Para el calentamiento inicial, recomendamos establecer un límite de 40 correos electrónicos al día. Según tu plan, este límite puede ser de hasta 1000 correos electrónicos.
strategy — elige la estrategia de calentamiento: progressive, para aumentar gradualmente el volumen diario de envío en cuentas nuevas o inactivas (se recomienda pasar de 2 a 40 correos electrónicos), o steady, para mantener la reputación del remitente con un volumen diario fijo.
email_content — puedes calentar tu propia plantilla de correo electrónico para mejorar su capacidad de entrega o utilizar contenido generado por IA.
Crear y administrar campañas
Estos métodos te permiten configurar campañas con toda su configuración: pasos de la secuencia (correo electrónico y LinkedIn), horario, seguimiento, cuentas remitentes, lista de destinatarios y ajustes de envío.
Crear una nueva campaña
Crea una campaña y obtén el ID de la campaña que utilizarás en todas las llamadas posteriores a la API.
Crea un borrador de campaña con la configuración básica necesaria para su lanzamiento.
Parámetros obligatorios:
Nombre de la campaña, horario de envío y al menos una cuenta remitente.
name, schedule_id, sender_account_ids
Obtener información de una campaña
Consulta la configuración y el estado actuales de una campaña antes de actualizarla o ponerla en marcha.
Recupera todos los detalles de una campaña específica: estado, cuentas remitentes, configuración de envío, destinatarios y pasos de la secuencia.
Parámetros obligatorios:
campaign_id — el ID de la campaña en la URL de la solicitud.
Actualizar una campaña
Actualiza la configuración de una campaña antes de iniciarla o mientras está en pausa. Solo se modificarán los ajustes que incluyas en el cuerpo de la solicitud.
Parámetros obligatorios:
campaign_id — el ID de la campaña en la URL de la solicitud, además de los campos que desees actualizar.
Cambiar el estado de una campaña
Controla el ciclo de vida de la campaña: inicia la prospección, ponla en pausa o ciérrala cuando haya finalizado. Este método actualiza la campaña a un nuevo estado: activa, en pausa, reanudada, completada o archivada.
Parámetros obligatorios:
campaign_id — el ID de la campaña en la URL de la solicitud; action — el estado al que deseas cambiar.
Estados admitidos: Iniciar, Pausar, Reanudar, Completar y Archivar.
Eliminar una campaña
Elimina permanentemente la campaña de tu cuenta.
Parámetros obligatorios:
campaign_id — el ID de la campaña en la URL de la solicitud.
Agregar y actualizar el contenido de los correos electrónicos
Estos métodos te permiten administrar el contenido (asunto y cuerpo del mensaje) de cada paso de correo electrónico dentro de la secuencia de una campaña.
Crear el contenido de un paso de correo electrónico
Agrega el asunto y el cuerpo del correo electrónico.
Agrega un bloque de contenido al paso de correo electrónico especificado dentro de la secuencia.
Parámetros obligatorios:
campaign_id, step_id — ID de la campaña e ID del paso en la URL.
subject, body — asunto y cuerpo del correo electrónico.
Obtener el contenido de un paso de correo electrónico
Revisa el contenido actual del correo electrónico antes de realizar modificaciones.
Devuelve un bloque de contenido específico para un paso de correo electrónico.
Parámetros obligatorios:
campaign_id, step_id, content_id — ID de la campaña, ID del paso e ID del bloque de contenido en la URL.
Actualizar el contenido de un paso de correo electrónico
Edita el asunto o el cuerpo de un paso de correo electrónico sin reemplazar todo el bloque de contenido.
Parámetros obligatorios:
campaign_id, step_id, content_id — ID de la campaña, ID del paso e ID del bloque de contenido en la URL, además de los campos de contenido que desees actualizar.
Eliminar el contenido de un paso de correo electrónico
Elimina un bloque de contenido de un paso de correo electrónico.
Parámetros obligatorios:
campaign_id, step_id, content_id — ID de la campaña, ID del paso e ID del bloque de contenido en la URL.
Administrar destinatarios
Estos métodos te permiten controlar el estado de tus prospectos dentro de una campaña.
Cambiar el estado de un destinatario
Detén o ajusta manualmente la prospección de un prospecto específico; por ejemplo, si respondió a través de otro canal o si debe excluirse a mitad de la secuencia. Este método actualiza el estado de un destinatario específico dentro de una campaña.
Parámetros obligatorios:
campaign_id — el ID de la campaña en la URL; email, status — el correo electrónico del prospecto y el nuevo estado que se aplicará.
Comprobar el estado de un destinatario
Verifica el estado actual de prospección de un destinatario antes de cambiar su estado o agregarlo a una campaña. Este método comprueba si las direcciones de correo electrónico especificadas están incluidas como destinatarios en una campaña determinada.
Parámetros obligatorios:
campaign_id, recipient_id — el ID de la campaña y el ID del destinatario en la URL.
Próximos pasos con la API
Estas guías cubren los pasos restantes del flujo de trabajo de las campañas: configurar notificaciones de eventos en tiempo real y obtener datos de rendimiento.
Configurar webhooks
Suscríbete a los eventos de las campañas y recibe notificaciones en tiempo real en la URL de tu endpoint. Para consultar la lista completa de eventos compatibles, métodos y detalles de las cargas útiles, consulta la guía de Webhooks.
Obtener analítica e informes de campañas
Recupera datos de interacción de destinatarios individuales y métricas agregadas del rendimiento de las campañas. Para consultar la lista completa de métodos de generación de informes, parámetros y ejemplos de respuesta, consulta la guía de la API de analítica de campañas.
Lo lamentamos 😢
Cómo podemos mejorarlo?