# Campañas: únicas, recurrentes y por API

> En Campañas → Nueva campaña, elige el Tipo de Programación (Único, Recurrente o Disparo por API), un canal (Email, con hasta 3 webhooks, o WhatsApp), los segmentos y la Ventana de Reingreso del Lead. Prueba con un contacto real, activa y sigue procesados, entregados, aperturas, clics, bajas y errores.

Fonte: https://wiki.bip.marketing/es-es/campanas · Atualizado: 2026-10-08

<UseCaseMeta effort="nocode" channel="email,whatsapp,webhook" plan="free" />

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).

<Checklist items="Una cuenta en la BIP (sirve el plan gratuito)|Un segmento guardado, para campañas Único y Recurrente|Una plantilla de email lista, o una plantilla de WhatsApp aprobada y un número conectado (planes de pago)|Para Disparo por API: una clave de API con el alcance campaigns:trigger" />

## 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

<Steps items="Elige el tipo de programación: Único, Recurrente o Disparo por API|Define el canal y el mensaje: email, WhatsApp o webhooks|Activa 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.

<Shot src="/img/campanhas/1-es-es.png" alt="Lista de campañas con el botón Nueva campaña" url="dash.bip.marketing/…/campaigns" />

### 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.

<Shot src="/img/campanhas/2-es-es.png" alt="Detalles de la campaña con nombre, emoji, grupo y descripción" url="dash.bip.marketing/…/campaigns/…" />

### 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.

<Shot src="/img/campanhas/3-es-es.png" alt="Tipo de Programación con las pestañas Único, Recurrente y Disparo por API" url="dash.bip.marketing/…/campaigns/…" />

### 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.

<Shot src="/img/campanhas/4-es-es.png" alt="Ventana de Reingreso del Lead con Permitir Reingreso del Lead activado y el Período de Espera en días" url="dash.bip.marketing/…/campaigns/…" />

### 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**.

<Shot src="/img/campanhas/5-es-es.png" alt="Canal Email con remitente, plantilla de email y webhooks" url="dash.bip.marketing/…/campaigns/…" />

### 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.

<Shot src="/img/campanhas/6-es-es.png" alt="Sección Segmentos con dos segmentos activados" url="dash.bip.marketing/…/campaigns/…" />

### 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.

<Shot src="/img/campanhas/7-es-es.png" alt="Ventana Probar campaña con el campo del contacto y el botón Enviar prueba" url="dash.bip.marketing/…/campaigns/…" />

### 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**.

<Callout type="warning">
Una campaña **Único** enviada ahora sale para todos los destinatarios al instante y no se puede deshacer. Pruébala antes.
</Callout>

<Shot src="/img/campanhas/8-es-es.png" alt="Ventana de confirmación ¿Listo para lanzar tu campaña?" url="dash.bip.marketing/…/campaigns/…" />

## Referencia

### Tipos de programación

| Tipo | Opciones | Cuándo sale |
| --- | --- | --- |
| **Único** | **Fecha de inicio** (en blanco = de inmediato), **Hora** y **Zona horaria** | Una vez, al activar o en la fecha definida |
| **Recurrente** | **Frecuencia**, días, **Hora** y **Zona horaria** | En cada fecha de la programación, hasta que la pauses |
| **Disparo por API** | **Modo de Disparo**: **Inmediato** o **Retraso**, con **Retraso (Segundos)** | Para un contacto a la vez, cuando tu sistema llama a la API |

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

### Único

| Opción | Qué hace |
| --- | --- |
| **Fecha de inicio** | La fecha del envío. En blanco, la campaña sale en cuanto la actives. La fecha tiene que estar en el futuro |
| **Hora** | Hora y minuto, de 5 en 5 minutos. Aparece después de elegir la fecha y empieza en 09:00 |
| **Zona horaria** | La zona de la hora elegida. Viene con la zona de la cuenta; para Brasilia, **BRT (Sao Paulo) (-03:00)** |

### Recurrente

| Opción | Qué hace |
| --- | --- |
| **Frecuencia** → **Diario** | Todos los días, a la hora elegida |
| **Frecuencia** → **Mensual** | Una vez al mes, en el **Día del Mes** elegido (del 1º al 31º) |
| **Frecuencia** → **Personalizado** | En los **Días de la Semana** que marques. Pasa el mouse sobre cada letra para ver el nombre del día |
| **Hora** | Hora y minuto, de 5 en 5 minutos |
| **Zona horaria** | La zona de la programación. Viene con la zona de la cuenta |

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

| Opción | Qué hace |
| --- | --- |
| **Inmediato** | La campaña sale para el contacto en cuanto la BIP recibe la llamada |
| **Retraso** | La BIP espera el tiempo de **Retraso (Segundos)** antes de enviar. Si llega otra llamada para el mismo contacto, el tiempo vuelve a empezar de cero |
| **Integración vía API** | Panel con los comandos listos, ya con el ID de la campaña: `POST` y `GET` en `/api/campaigns/trigger` y, en el modo **Retraso**, en `/api/campaigns/cancel` |

- 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

| Configuración | Quién la recibe |
| --- | --- |
| **Permitir Reingreso del Lead** desactivado | Cada contacto recibe la campaña una sola vez. En una campaña recurrente, cada ejecución incluye solo a quien todavía no la recibió |
| Activado, **Período de Espera (Días)** = `0` | Sin límite: el contacto la recibe cada vez que esté en el público o se dispare |
| Activado, **Período de Espera (Días)** = _N_ | El contacto la recibe de nuevo solo _N_ días después del envío anterior |

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

| Opción | Qué hace |
| --- | --- |
| **Nombre del remitente** | El nombre que aparece en la bandeja de entrada. Vacío, se usa el de la cuenta |
| **Email de envío** | **Predeterminado de la cuenta** o una dirección en un dominio verificado en **Ajustes** → **Dominios de Email** |
| **Plantilla de email** | El contenido del email. Una sola plantilla por campaña |
| **Webhooks** | Hasta 3 webhooks disparados por cada contacto de la campaña |

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**:

| Opción | Qué hace |
| --- | --- |
| **Plantilla** | Una plantilla aprobada, de marketing o de utilidad |
| **Número de teléfono** | El número que envía. **Usar el número de teléfono predeterminado de la cuenta** usa el número marcado como predeterminado |
| **Imagen del encabezado** / **URL del contenido del encabezado** | Aparece cuando la plantilla tiene contenido multimedia en el encabezado. Vacío, se usa el de la propia plantilla |
| **Asignación de variables** | Vincula cada variable de la plantilla a un dato del contacto. Todas las variables necesitan un valor |

### 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

| Estado | Qué significa |
| --- | --- |
| **Borrador** | En edición. No sale nada |
| **Programado** | Único con fecha definida, a la espera de la hora |
| **Activo** | Recurrente a la espera de la próxima ejecución, o Disparo por API listo para recibir llamadas |
| **En cola** | A la espera de procesamiento |
| **Enviando** | El envío está en curso |
| **Completado** | El envío Único terminó |
| **Pausada** | Detenida por ti. Se puede editar y activar de nuevo |

### Acciones

| Acción | Qué hace |
| --- | --- |
| **Guardar borrador** | Guarda los cambios sin activar |
| **Guardar y enviar** / **Guardar y programar** / **Guardar y Activar** | Guarda y activa, después de la confirmación |
| **Probar campaña** | Envía la campaña guardada a un contacto de la BIP |
| **Estadísticas de la campaña** | Abre los números de la campaña |
| **Pausar Campaña para Editar** | Aparece en campañas **Activo** y **Programado**. Pausa los envíos y habilita la edición. Para reanudar, guarda y activa de nuevo |
| **Duplicar** (en la lista) | Crea una copia en **Borrador**, con _(Clon)_ al final del nombre y la misma configuración, salvo la **Fecha de inicio**, que vuelve en blanco |
| Papelera (en la lista) | Elimina campañas **Borrador**, **Pausada** o **Completado** |

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

| Campaña | Tipo de Programación | Frecuencia | Hora y zona | Ventana de Reingreso del Lead |
| --- | --- | --- | --- | --- |
| Cumpleaños del día | Recurrente | Diario | 09:00, BRT (Sao Paulo) (-03:00) | Activada, `300` días |
| Boletín semanal | Recurrente | Personalizado: Lunes | 09:00, BRT (Sao Paulo) (-03:00) | Activada, `6` días |
| Resumen del mes | Recurrente | Mensual: 1º | 10:00, BRT (Sao Paulo) (-03:00) | Activada, `25` días |
| Bienvenida a los recién llegados | Recurrente | Diario | 10:00, BRT (Sao Paulo) (-03:00) | Desactivada: cada contacto la recibe una vez |
| Promoción de la semana | Único | Fecha de inicio: la fecha de la promoción | 08:00, BRT (Sao Paulo) (-03:00) | Desactivada |
| Carrito abandonado | Disparo por API | Retraso: `3600` segundos | — | Activada, `1` día |

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](/es-es/segmentos).

### Nombre y descripción

<Copy label="Nombre y descripción de la campaña">
🎂 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.
</Copy>

### 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**.

<Copy label="Disparar para un contacto que ya existe (POST)" code>
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"}'
</Copy>

<Copy label="Crear o actualizar el contacto y disparar (POST)" code>
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"]}}'
</Copy>

<Copy label="Disparar con GET" code>
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"
</Copy>

<Copy label="Cancelar un envío con retraso (POST)" code>
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"}'
</Copy>

Respuestas:

<Copy label="Respuesta del disparo" code>
{"campaignId": "ID_DE_LA_CAMPAÑA", "leadId": "ID_DEL_CONTACTO", "mode": "delay"}
</Copy>

<Copy label="Respuesta de la cancelación" code>
{"campaignId": "ID_DE_LA_CAMPAÑA", "cancelled": true, "leadId": "ID_DEL_CONTACTO"}
</Copy>

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:

| Indicador | Qué muestra |
| --- | --- |
| **Procesado** | Contactos que la BIP procesó. En Único, muestra el avance sobre el total del envío. En Recurrente y Disparo por API, **Procesado (_N_ ejecuciones)** suma todas las ejecuciones |
| **Entregado** | Emails enviados sobre los procesados |
| **Tasa de apertura** | Aperturas únicas sobre los enviados |
| **Tasa de clics** | Clics únicos sobre los enviados |
| **Tasa de clic por apertura** | Clics sobre aperturas |
| **Bajas** | Quienes se dieron de baja por esta campaña. Con **Bajas (ant: _N_)**, _N_ es quien ya estaba dado de baja y no la recibió |
| **Errores** | Emails que no se pudieron enviar, como contactos sin email |
| **Entrega de Webhook** / **Errores de Webhook** | Webhooks entregados y con error, cuando la campaña tiene webhooks |
| **Desglose de Entregas** | Gráfico con la división entre enviados, aperturas, clics, bajas y errores |
| **Enlaces más clicados** | Los 10 enlaces con más clics |

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](/es-es/segmentos)
- [Editor de email: bloques, variables y vista previa](/es-es/editor-de-email)
- [Plantillas de WhatsApp: crear, sincronizar y usar](/es-es/plantillas-whatsapp)
- [Webhooks: lleva cada envío a tu sistema](/es-es/webhooks)
- [API de la BIP: claves, contactos, eventos y disparos](/es-es/api)
- [Planes y límites: envíos, capacidad y precios](/es-es/planes-y-limites)