Leads de anuncios — con la API

Publicas un anuncio, la gente se registra pidiendo información, y quieres que cada persona reciba tu respuesta en el momento en que se registró — no cuando te acuerdes de mandar el siguiente correo.

Esta guía arma ese flujo con tres piezas que ya existen: una lista, su formulario público y una secuencia que se dispara sola.

¿Prefieres hacerlo desde el panel?

Esta página usa la API. Si no vas a programar, Leads de anuncios — desde el panel hace lo mismo con clics.

Por qué no es una campaña

Una campaña congela sus destinatarios al arrancar: toma la foto de la lista en ese instante y le manda a esa gente. Quien se registre después no la recibe, por más que entre a la misma lista.

Eso está bien para un boletín, donde todos leen lo mismo el mismo día. Para leads no sirve: tus registros llegan de a uno a lo largo de semanas, y cada persona necesita su respuesta al momento.

Lo que sirve es una secuencia: defines los pasos una vez y cada contacto los recorre desde su fecha de entrada. Quien se registra hoy a las 3 de la tarde recibe el paso 1 hoy; quien entre mañana lo recibe mañana.

Paso 1 — La lista

Crea la lista donde van a caer los registros:

POST /v1/bulk/lists
{ "name": "Interesados — anuncio agosto" }

Una lista por campaña publicitaria, no una sola para todo. Cuando quieras saber qué anuncio te trajo mejores clientes, la respuesta va a estar en la separación que hagas hoy.

El doble opt-in te va a costar leads

Si activas confirmación en esta lista, quien se registre no entra hasta que abra su correo y confirme. En un flujo de anuncios pagados eso te tira una parte de los registros: gente que sí te dejó sus datos, pero nunca abrió la confirmación. Tú pagaste por ese clic igual.

Para un formulario donde la persona pidió que la contactaras, el consentimiento es explícito y queda registrado, así que puedes dejarlo apagado. Actívalo si tu formulario está abierto en una página donde cualquiera puede escribir el correo de otro.

Paso 2 — El formulario público

Activa el formulario de alta de esa lista:

PUT /v1/bulk/lists/{id}/signup-form
{ "tags": ["anuncio-agosto"], "redirect_url": "https://tu-sitio.com/gracias" }

La respuesta trae lo que necesitas:

Campo	Para qué sirve
url	Página hospedada por nosotros. Es la que pones como destino del anuncio.
snippet	HTML listo para pegar en tu propio sitio, si prefieres tu diseño.
doble_optin	Te dice si esta lista exige confirmación (ver el aviso de arriba).

Las tags se le ponen a todo el que entre por ahí. Úsalas para saber de qué anuncio vino cada quien.

redirect_url es a dónde mandas a la persona después de registrarse. Si lo dejas vacío ve a nuestra página de gracias, que funciona pero no es tuya — si tienes una página propia de agradecimiento, mejor.

Si el token se filtra

PUT con regenerate: true cambia el token del formulario. Eso revoca el que ya tengas pegado en tu sitio, así que hay que volver a publicar el nuevo. Es la salida cuando alguien empieza a abusar del formulario.

Paso 3 — La secuencia que se dispara sola

Crea la secuencia y ponle el disparador list_join apuntando a tu lista:

POST /v1/bulk/sequences
{
  "name": "Seguimiento anuncio agosto",
  "trigger_type": "list_join",
  "trigger_value": "<id-de-tu-lista>"
}

Agrega los pasos. offset_seconds es el tiempo desde que la persona se registró:

POST /v1/bulk/sequences/{id}/steps
{ "position": 1, "offset_seconds": 0, "subject": "La información que pediste", "html": "..." }

POST /v1/bulk/sequences/{id}/steps
{ "position": 2, "offset_seconds": 172800, "subject": "Algunos trabajos que hicimos", "html": "..." }

POST /v1/bulk/sequences/{id}/steps
{ "position": 3, "offset_seconds": 432000, "subject": "¿Agendamos una llamada?", "html": "..." }

Y actívala — en draft no envía nada:

PATCH /v1/bulk/sequences/{id}
{ "status": "active" }

Listo. A partir de ahí, cada persona que se registre entra sola a la secuencia y recibe los tres correos en su propio calendario. No tienes que tocar nada por cada lead.

Qué poner en cada paso

• Día 0 — lo que el anuncio prometió. Es el correo que más se abre, porque la persona acaba de dejarte sus datos y te está esperando. No lo desperdicies en una bienvenida genérica: manda la información que pidió.
• Día 2 — pruebas. Trabajos que hiciste, casos, resultados. Aquí es donde se decide si eres una opción seria.
• Día 5 — la invitación concreta a hablar. Un enlace para agendar, no un “quedamos a tus órdenes”.

Tres pasos alcanzan para empezar. Agregar más después es fácil; recuperar a un lead que se enfrió, no.

Tres cosas que conviene saber antes

El disparador no se activa al importar un CSV. Sólo con altas individuales: el formulario, la confirmación, o dar de alta un contacto por API. Es a propósito — importar 5.000 contactos a una lista con secuencia mandaría 5.000 correos de bienvenida a gente que lleva años contigo, y eso no se deshace. Si quieres alcanzar a los que ya estaban, existe la acción de inscribir la lista completa, donde ves a cuánta gente vas a llegar antes de confirmar.

Con doble opt-in, el disparador espera la confirmación. La persona entra a la secuencia cuando confirma, no cuando llena el formulario. Es lo correcto, pero significa que quien nunca confirma tampoco recibe tu seguimiento.

Suscribirse dos veces no manda todo dos veces. La inscripción es idempotente por (secuencia, correo), así que alguien que llena el formulario dos veces recibe una sola serie.

¿Y si prefieres que le hable una persona?

Nadie compra un servicio caro por una cadena de correos automatizada. Si tu venta la cierra alguien de tu equipo, lo que te sirve es enterarte del registro al instante: apunta un webhook al alta de contacto y avísale a tu equipo por donde sea que trabajen.

Lo más efectivo es hacer las dos cosas. La secuencia responde de inmediato, que es cuando la persona está interesada; el aviso interno le deja a tu equipo perseguir al lead sin esperar. Contestar tres días después de que alguien pidió información es lo mismo que no contestar.