Campañas: únicas, recurrentes y por API

EsfuerzoSin códigoCanalEmail + WhatsApp + WebhookPlanGratis

Envía el mensaje correcto al público correcto en el momento justo: una sola vez, todos los lunes a las 9:00 o en el segundo en que alguien abandona el carrito. La campaña reúne el cuándo (programación), el cómo (email, WhatsApp o webhooks) y el a quién (segmentos).

#Lo que vas a lograr

• Un envío ahora o en una fecha y hora definidas, en la zona horaria que elijas.
• Envíos recurrentes todos los días, en un día del mes o en días de la semana, que recalculan el segmento en cada ejecución.
• Disparos por API para un contacto a la vez, al instante o con retraso, con cancelación antes del envío.
• Webhooks a tu CRM o sistema por cada contacto de la campaña, junto con el email o en lugar de él.
• Estadísticas en vivo: entregas, aperturas, clics, bajas, errores, enlaces más clicados y el historial de cada destinatario.

#Cómo funciona

1. 1Elige el tipo de programación: Único, Recurrente o Disparo por API
2. 2Define el canal y el mensaje: email, WhatsApp o webhooks
3. 3Activa y sigue las estadísticas

En cada envío, la BIP:

• recalcula los segmentos con los datos de ese momento;
• envía una vez por contacto, aunque esté en más de un segmento de la campaña;
• omite a quien se dio de baja del canal o de todas las comunicaciones;
• aplica la Ventana de Reingreso del Lead, que decide si quien ya recibió la campaña puede recibirla de nuevo;
• en BIP Lite, incluido el plan gratuito, revisa el saldo de envíos del mes antes de empezar. Si el saldo no alcanza para todos los contactos, el envío no empieza: nadie recibe una parte de la campaña.

Cada campaña usa un canal: Email o WhatsApp. Para hablar con el mismo público por los dos, crea una campaña para cada canal.

#Paso a paso

#1. Crea la campaña

1. En el menú, haz clic en Campañas. La lista muestra cada campaña con Tipo, Rendimiento, Estado y Actualizado, organizadas por grupo.
2. Haz clic en Nueva campaña. La BIP crea una campaña en Borrador, con el nombre [sin título] seguido de la fecha y la hora, y abre la pantalla de edición.

dash.bip.marketing/…/campaigns

Captura de pantalla próximamente

#2. Completa los detalles

En Detalles de la campaña:

1. Escribe el Nombre de la campaña y, al lado, elige un emoji para identificarla en la lista.
2. En Grupo, elige dónde aparece en la lista. Los grupos se crean en Ajustes → Grupos → Grupos de campañas.
3. En Descripción, anota el objetivo, para que tu equipo sepa de qué se trata.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#3. Elige cuándo enviar

En Tipo de Programación, elige una pestaña:

• Único: deja Fecha de inicio en blanco para enviar en cuanto actives, o elige la fecha, la Hora y la Zona horaria.
• Recurrente: elige la Frecuencia (Diario, Mensual o Personalizado), la Hora y la Zona horaria. Debajo, la BIP escribe la programación completa, como Todos los días a las 09:00.
• Disparo por API: elige el Modo de Disparo, Inmediato o Retraso. Tu sistema llama a la BIP por cada contacto.

Todas las opciones están en la Referencia, más abajo.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#4. Define el reingreso

En Ventana de Reingreso del Lead, decide si la misma persona puede recibir esta campaña más de una vez:

1. Con Permitir Reingreso del Lead desactivado (el valor predeterminado), cada contacto recibe la campaña una sola vez.
2. Activado, indica el Período de Espera (Días): el mínimo de días entre dos envíos a la misma persona. Con 0, no hay límite.

Para campañas recurrentes que deben llegar en cada ejecución, como un boletín semanal, activa el reingreso.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#5. Elige el canal y el mensaje

En Canal, haz clic en Email o WhatsApp.

Con Email:

1. En Nombre del remitente, escribe el nombre que aparece en la bandeja de entrada. Vacío, se usa el de la cuenta.
2. En Email de envío, quédate con Predeterminado de la cuenta o, si tienes un dominio verificado, elige el dominio y escribe la parte antes de la @.
3. En Plantilla de email, activa la plantilla de la campaña. La búsqueda encuentra plantillas por nombre.
4. En Webhooks, activa hasta 3 webhooks para recibir los datos de cada contacto en tu sistema.

Una campaña de email puede enviar solo webhooks: deja Plantilla de email sin seleccionar y activa al menos un webhook.

Con WhatsApp (planes de pago, con un número conectado), completa la sección Plantilla de WhatsApp: la Plantilla aprobada, el Número de teléfono de envío, el contenido del encabezado, si la plantilla lo tiene, y la Asignación de variables.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#6. Selecciona los segmentos

En Segmentos, activa uno o más segmentos. La búsqueda encuentra segmentos por nombre. Quien está en más de uno la recibe una sola vez.

Las campañas Disparo por API no tienen esta sección: el contacto llega en la llamada a la API.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#7. Prueba con un contacto real

1. Haz clic en Guardar → Guardar borrador. La prueba usa la versión guardada.
2. Haz clic en Probar campaña.
3. Escribe el email, el teléfono, el ID o el rastreador de un contacto que ya está en la BIP, de preferencia tú mismo.
4. Haz clic en Enviar prueba.

La prueba envía de verdad: el email, el mensaje de WhatsApp y los webhooks salen para ese contacto, igual que saldrán para todos. La BIP abre las Estadísticas de la campaña, donde la prueba aparece con el prefijo [test]. Las pruebas no consumen envíos de tu saldo.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#8. Activa

1. Haz clic en Guardar y elige la opción de tu tipo de programación:
   • Guardar y enviar (Único sin fecha);
   • Guardar y programar (Único con fecha);
   • Guardar y Activar (Recurrente y Disparo por API).
2. Revisa la ventana de confirmación y haz clic en Enviar campaña ahora, Programar campaña, Activar Campaña Recurrente o Activar Disparo por API. Para volver y revisar, haz clic en Revisar de nuevo.
3. La BIP abre las Estadísticas de la campaña.

dash.bip.marketing/…/campaigns/…

Captura de pantalla próximamente

#Referencia

#Tipos de programación

En la lista de campañas, la columna Tipo muestra Único, Programado (Único con fecha), Recurrente o Disparo por API.

#Único

#Recurrente

La programación aparece escrita debajo de las opciones: Todos los días a las 09:00, Fines de semana a las 10:00, Lunes, Miércoles y Viernes a las 18:30 o día 1º de cada mes a las 09:00.

En cada ejecución, la BIP recalcula los segmentos. Quien entró al segmento desde la última ejecución ya la recibe; quien salió, no. La Ventana de Reingreso del Lead decide si quien ya la recibió la recibe de nuevo.

#Disparo por API

• La clave de API necesita el alcance campaigns:trigger, enviada en el encabezado x-bip-api-key o en el parámetro ?api-key=.
• En lead, envía el email, el teléfono, el ID o el rastreador de un contacto que ya existe. O envía un objeto con los datos del contacto: la BIP crea o actualiza el contacto y dispara en la misma llamada. Para eso, la clave también necesita el alcance leads:write.
• En el modo Retraso, /api/campaigns/cancel cancela el envío pendiente de ese contacto. Un envío cancelado no sale y no cuenta en tu saldo.
• La campaña solo acepta disparos con estado Activo.

#Ventana de Reingreso del Lead

Con 0, la BIP avisa que la misma persona puede recibirla varias veces el mismo día. En una campaña recurrente, usa un período menor que el intervalo entre ejecuciones: para una campaña semanal, 6 días. En las estadísticas, quien la ventana retuvo aparece como Rechazada, con el motivo El lead ya ha recibido esta campaña o El lead está dentro de la ventana de reingreso.

#Canal Email

La campaña de email necesita una Plantilla de email, al menos un webhook, o las dos cosas.

#Canal WhatsApp

La pestaña WhatsApp está disponible después de conectar un número (planes de pago). En la sección Plantilla de WhatsApp:

#Segmentos

• Puedes activar varios segmentos. Cada contacto recibe una vez por envío.
• Solo aparecen en la lista los segmentos guardados; los que están en Borrador, no.
• Las campañas Disparo por API no usan segmentos.

#Estado

#Acciones

Las campañas Programado, Activo, En cola, Enviando y Completado quedan bloqueadas para edición. Para repetir una campaña completada, usa Duplicar.

#Saldo de envíos

En BIP Lite, incluido el plan gratuito, la BIP suma los contactos de los segmentos antes de cada envío y revisa el saldo del mes. Si no hay saldo para todos, la campaña no empieza y ningún contacto la recibe. Ajusta el volumen en Ajustes → Facturación o usa un segmento más pequeño, y activa de nuevo. En el Disparo por API, cada disparo que sale usa un envío del saldo.

#Listo para copiar

#Programaciones

Para "Bienvenida a los recién llegados", usa un segmento como Fecha de creación → Es igual a → Relativo -1 Días: quien entró a la BIP ayer. Así cada ejecución diaria cuenta solo los contactos del día anterior y no se vuelve a reservar saldo para quienes ya entraron en ejecuciones pasadas. Consulta otras reglas en Segmentos.

#Nombre y descripción

🎂 Cumpleaños del día — Padaria Aurora
Felicitaciones con cupón para quienes cumplen años hoy. Recurrente diaria a las 09:00; cada persona la recibe una vez al año.

#Disparar por API

Cambia TU_CLAVE_DE_API por tu clave e ID_DE_LA_CAMPAÑA por el ID que aparece en el panel Integración vía API.

curl -X POST https://api.bip.marketing/api/campaigns/trigger \
  -H "Content-Type: application/json" \
  -H "x-bip-api-key: TU_CLAVE_DE_API" \
  -d '{"campaignId": "ID_DE_LA_CAMPAÑA", "lead": "marina.alves@exemplo.com"}'

curl -X POST https://api.bip.marketing/api/campaigns/trigger \
  -H "Content-Type: application/json" \
  -H "x-bip-api-key: TU_CLAVE_DE_API" \
  -d '{"campaignId": "ID_DE_LA_CAMPAÑA", "lead": {"name": "Marina Alves", "email": "marina.alves@exemplo.com", "phone": "+5541998765432", "tags": ["carrito"]}}'

curl "https://api.bip.marketing/api/campaigns/trigger?campaignId=ID_DE_LA_CAMPAÑA&lead=marina.alves@exemplo.com&api-key=TU_CLAVE_DE_API"

curl -X POST https://api.bip.marketing/api/campaigns/cancel \
  -H "Content-Type: application/json" \
  -H "x-bip-api-key: TU_CLAVE_DE_API" \
  -d '{"campaignId": "ID_DE_LA_CAMPAÑA", "lead": "marina.alves@exemplo.com"}'

Respuestas:

{"campaignId": "ID_DE_LA_CAMPAÑA", "leadId": "ID_DEL_CONTACTO", "mode": "delay"}

{"campaignId": "ID_DE_LA_CAMPAÑA", "cancelled": true, "leadId": "ID_DEL_CONTACTO"}

En la cancelación, "cancelled": false significa que no había un envío pendiente para ese contacto.

#Cómo medir

Abre Estadísticas de la campaña (arriba en la campaña o con el ícono de gráfico en la lista). El aviso En vivo indica que los números se actualizan en tiempo real, incluso durante el envío. Arriba, Editar Campaña vuelve a la edición y Probar campaña envía una nueva prueba.

En campañas de email:

En campañas de WhatsApp, los indicadores son Enviado, Entregado, Tasa de lectura, Tasa de respuesta, Tasa de respuesta sobre lectura, Bajas, Errores, Rechazada, Dado de baja y Retenido.

Debajo de los números, Interacciones del destinatario lista cada contacto con fecha, tipo y estado. Filtra por estado (por ejemplo Clicado, Abierto, Error o Rechazada), busca por nombre o email y haz clic en Ver Lead para abrir el perfil.

La BIP ignora las aperturas de los primeros 30 segundos después del envío (son vistas previas automáticas de algunos proveedores) y los clics de robots conocidos. Un clic también cuenta como apertura, aunque el cliente de correo haya bloqueado las imágenes.

#Preguntas frecuentes

#¿Puedo enviar email y WhatsApp en la misma campaña?

No. Cada campaña usa un canal. Crea la campaña de email, haz clic en Duplicar en la lista y cambia el Canal de la copia a WhatsApp.

#¿Cómo reenvío una campaña que ya se completó?

En la lista de campañas, haz clic en Duplicar. La copia vuelve como Borrador, con la misma configuración y la Fecha de inicio en blanco. Elige la nueva fecha antes de activar: sin fecha, la campaña sale en cuanto hagas clic en Guardar y enviar.

#¿La prueba consume envíos?

No. Probar campaña envía de verdad al contacto elegido, pero no descuenta de tu saldo. El contacto tiene que estar en la BIP y no puede haberse dado de baja del canal.

#Mi campaña recurrente solo envió la primera vez. ¿Por qué?

Con Permitir Reingreso del Lead desactivado, cada contacto recibe la campaña una sola vez, y las ejecuciones siguientes llegan solo a quienes entraron al segmento después. Para enviar en cada ejecución, pausa la campaña, activa el reingreso con un Período de Espera (Días) menor que el intervalo de la programación y actívala de nuevo.

#Ver también

• Segmentos: los 10 criterios para filtrar contactos
• Editor de email: bloques, variables y vista previa
• Plantillas de WhatsApp: crear, sincronizar y usar
• Webhooks: lleva cada envío a tu sistema
• API de la BIP: claves, contactos, eventos y disparos
• Planes y límites: envíos, capacidad y precios