# Campañas de correo

> Cómo el equipo prepara y envía un comunicado por correo a la comunidad: bloques, público, prueba, cuota de envíos, baja, medición de aperturas y clics, y los correos que siempre llegan.

**Campañas** es el área de la comunidad donde el equipo escribe un comunicado, elige quién lo recibe y lo envía por correo. Está en **Administración**, junto a Miembros y Monetización (`/campaigns`); no es un módulo de espacio.

Toda campaña lleva el **nombre de la comunidad** como remitente, el **correo de contacto del propietario** para las respuestas, un enlace para que la persona **se dé de baja** y el aviso de que Memberfy mide aperturas y clics.

## Para qué sirve

| Comunidad | Campaña |
|---|---|
| Escuela | El aviso de que se abrieron las matrículas del nuevo grupo |
| Asociación | El resumen del congreso, para todos los socios |
| Coworking | Un recado solo para el grupo de residentes |
| Mentoría | La novedad para quien tiene la etiqueta *Grupo de marzo* |

## Cómo funciona

### Quién hace qué

| Quién | Qué hace |
|---|---|
| Propietario y administrador | Todo: crean el borrador, revisan el público, envían la prueba y **envían la campaña** |
| Moderador y financiero | Ven el área y las campañas, crean y editan borradores, revisan el público y se envían pruebas. **No envían** |
| Miembro | No ve el área |

El área aparece en **Administración** para todo el equipo. Quien abre **Nueva campaña** sin poder enviar lee *"Solo el owner y los admins envían campañas. Puedes escribir el borrador y enviarte pruebas."*

### La campaña

| Campo | Para qué |
|---|---|
| **Nombre de la campaña** | Solo lo ve el equipo; sirve para encontrar la campaña después |
| **Asunto** | El asunto del correo. `{{nome}}` se convierte en el nombre de cada persona |
| **Texto de vista previa (opcional)** | La frase que aparece junto al asunto en la bandeja de entrada |
| **Contenido** | Los bloques, en el orden en que salen en el correo |
| **Público** | Quién lo recibe |

Los bloques son tres:

| Bloque | Qué lleva |
|---|---|
| **Texto** | El mensaje, con formato. `{{nome}}` también funciona aquí (sin nombre, sale *"amigo(a)"*) |
| **Botón** | **Texto del botón** y **Enlace del botón**, que empieza por `https://` |
| **Imagen** | **Dirección de la imagen** (empieza por `https://`) y **Descripción de la imagen**, para quien no ve la figura. La imagen viene de un enlace: no hay subida de archivos |

Los bloques suben y bajan con los botones **Subir bloque** y **Bajar bloque**. Solo el borrador se edita: una campaña ya enviada no cambia y no se elimina.

### El público

En **Público**, elige **Todas las personas** o **Elegir el público**: **Grupos**, **Etiquetas** y **Personas**, combinados en unión. Quien está en más de un criterio lo recibe **una sola vez**.

La **Vista previa del público** (tras guardar el borrador) muestra cuántas personas lo recibirán y cuántas **quedan fuera**, con el motivo: se dieron de baja, tienen un correo que no recibe mensajes (rebote permanente) o marcaron correos como spam. También muestra un ejemplo de quién lo recibe, con el correo parcialmente oculto.

- **Solo entran miembros de la comunidad**; los perfiles eliminados quedan fuera.
- Un envío va a **como máximo 20.000 personas**. Por encima, reduce el público.
- **Quien se dio de baja no vuelve a un público**: si el equipo intenta incluirla a mano, la elección se rechaza. Solo la propia persona puede reactivarse.

### Cuota de envíos

Para proteger la reputación de los correos de la comunidad, cada comunidad tiene una **cuota de envíos**: **2 por día** y **14 por semana**; el mes es la **suma de las semanas**. Cada **envío** a un público cuenta como uno, sea cual sea el tamaño del público. Día, semana y mes siguen la zona horaria de la comunidad.

- **La prueba no cuenta.**
- La cuota aparece en las ventanas de enviar y de programar (*"Cuota que queda después de este envío"*) y, en la lista de campañas, en una línea discreta (*"Envíos restantes: 2 hoy, 14 esta semana, 60 este mes."*).
- Los envíos programados, repetidos y automáticos **también cuentan**, uno por envío, cuando salen.
- Si el envío superara algún límite, se **rechaza antes de empezar**, diciendo qué límite y cuándo se libera. No se envía nada a medias.
- Solo el SuperAdmin de Memberfy cambia la cuota de una comunidad; owner y admin no la editan.

### Aperturas y clics

Memberfy siempre mide **aperturas** y **clics** en los enlaces; no se puede desactivar. Los números son **sumas**, sin el nombre de nadie, y aparecen en **Envíos**: **Destinatarios**, **Entregados**, **Aperturas**, **Clics**, **Rebotes** y **Quejas**. La apertura es una **estimación**: algunas apps de correo abren los mensajes por su cuenta. El pie del correo avisa a la persona de que existe la medición.

### Baja

Todo correo de campaña trae un enlace **Darme de baja** (y el botón de cancelar suscripción que muestran los proveedores de correo). La página *"Gestiona los correos que recibes"* deja a la persona elegir, **por comunidad**:

| Elección | Qué cambia |
|---|---|
| **Dejar de recibir comunicados** | Sale de las campañas. Sigue recibiendo los avisos de la comunidad (recordatorio de evento, certificado…) |
| **Dejar de recibir todos los correos** | Deja de recibir también los avisos de la comunidad. Los correos de la lista de abajo siguen llegando |

La baja vale para la **dirección de correo en esa comunidad**; en otra comunidad la persona sigue recibiendo. Un clic en el botón del proveedor vale como *comunicados*. La persona puede volver con el enlace **Cambié de opinión, quiero volver a recibir** o, con sesión iniciada, con la tarjeta **Correos de esta comunidad** en **Mi cuenta**, que ofrece **Recibir todo**, **Bloquear comunicados** y **Bloquear todos los correos**.

La pestaña **Bajas** muestra al equipo quién pidió no recibir, con el correo parcialmente oculto, el alcance (*Sin comunicados* o *Sin ningún correo*) y el origen (*Enlace del correo*, *Un clic en el correo* o *Preferencia en el perfil*).

### Correos que siempre llegan

Incluso con *todos los correos* bloqueados, la persona sigue recibiendo: recuperación y cambio de contraseña, aviso de inicio de sesión, códigos de acceso y verificación, recibos de compra y de renovación y avisos legales. La tarjeta de **Mi cuenta** lo recuerda.

## Paso a paso

### Crear, probar y enviar

1. En **Administración**, abre **Campañas** y pulsa **Nueva campaña**.
2. Rellena **Nombre de la campaña** y **Asunto** (y, si quieres, el **Texto de vista previa**).
3. En **Contenido**, añade los bloques (**Añadir texto**, **Añadir botón**, **Añadir imagen**) y escribe.
4. En **Público**, elige **Todas las personas** o **Elegir el público**.
5. Pulsa **Guardar borrador** y revisa la **Vista previa del público**.
6. Pulsa **Enviarme una prueba**: el correo llega solo a tu dirección, con **[Prueba]** en el asunto, y no gasta cuota. Hay un límite de pruebas por hora.
7. *Rol: propietario o administrador.* Pulsa **Enviar ahora**. El diálogo *"¿Enviar esta campaña ahora?"* muestra cuántas personas reciben, cuántas quedaron fuera y la cuota que queda. Marca *"Confirmo que estas personas son miembros de mi comunidad y aceptan recibir comunicados."* y confirma con **Enviar ahora**.

El envío **no se puede retirar**. Los correos salen por lotes, así que una comunidad grande tarda un tiempo en entregarlo todo; los números de **Envíos** se actualizan a medida que llegan. Los correos de campaña no retrasan los de seguridad ni los de compra.

### Eliminar un borrador

Abre el borrador y usa **Eliminar borrador**. Las campañas ya enviadas no se eliminan.

## Programar, repetir y seguir los envíos

*Rol para programar, pausar, reanudar y cancelar: propietario o administrador.* En lugar de **Enviar ahora**, **Programar envío** abre la ventana *"Programar el envío"*, con el **Tipo de envío**:

| Tipo | Cuándo sale |
|---|---|
| **Una vez** | En la fecha y la hora elegidas |
| **Todos los días** | Todos los días, a la hora elegida |
| **Días de la semana** | En los días de la semana elegidos, a la hora elegida |

La fecha y la hora valen en la **zona horaria de la comunidad**, y la hora local se mantiene cuando cambia el horario de verano. Una hora en el pasado se rechaza.

- **La cuota se gasta cuando el envío sale**, no al programar. Cada envío repetido gasta un envío. Si no hay cuota en ese momento, o si la hora pasó más de 12 horas antes de que el envío pudiera salir, el envío se **omite** y se registra, y el propietario recibe un correo (una vez por envío). Un envío único omitido vuelve a borrador.
- **En cada envío, el público y el contenido se leen de nuevo**: quien entró en la comunidad lo recibe, quien salió o se dio de baja no. Los bloques automáticos muestran solo lo nuevo desde el envío anterior (en el primero, los últimos 7 días).
- **Sin nada nuevo, no envía.** El envío se omite y se registra como *"Omitido: no había nada nuevo para enviar."* Texto, botón e imagen cuentan como contenido, así que una campaña solo de texto siempre envía.
- **Pausar** retiene lo que aún no salió y guarda la próxima fecha; **Reanudar** continúa solo con lo que faltaba; **Cancelar campaña** termina, y lo que ya salió queda enviado. Los estados son *Borrador*, *Programada*, *Enviando*, *Enviada*, *En pausa* y *Cancelada*.
- Una campaña que ya no es borrador no se edita: usa el panel **Envío** para reprogramar, pausar o cancelar.

### Seguir los envíos

En **Envíos**, cada envío muestra **Destinatarios**, **Entregados**, **Aperturas**, **Clics**, **Rebotes** y **Quejas** (y las bajas), y **Suma de todos los envíos** lo junta todo. **Son solo números**: ningún nombre ni correo de nadie. Un envío omitido muestra el motivo. **Ver cómo lo recibe la persona** abre el correo como saldría ahora, sin enviar ni gastar cuota.

## Bloques con el contenido de la comunidad

Además de **Texto**, **Botón** e **Imagen**, el correo acepta bloques que traen contenido de la propia comunidad:

| Grupo | Bloque | Qué muestra |
|---|---|---|
| **Contenido automático** | **Últimas publicaciones** | De 1 a 10 publicaciones, de un espacio o de todos los espacios abiertos |
| | **Próximos eventos** | De 1 a 10 eventos que empiezan en los próximos días (de 1 a 90) |
| | **Cursos nuevos** | Los cursos publicados desde el envío anterior |
| | **Clasificados nuevos** | Los anuncios nuevos desde el envío anterior |
| **Contenido fijo** | **Un curso**, **Un evento**, **Un producto** | Una tarjeta con enlace al elemento elegido (el producto lleva a la tienda) |

Cada bloque acepta un título de sección opcional. El contenido se lee **en el momento del envío**.

- **Solo entra lo que todas las personas del público pueden ver**: contenido aprobado y publicado, en espacios y secciones abiertos a todos los miembros (sin plan, grupo ni producto exigido, y no privados). **Ningún contenido de pago va en el correo.** Un elemento fijo que no todos ven se rechaza al guardar; si deja de ser visible después, sale del correo.
- El bloque **Imagen** acepta **Subir imagen** (JPEG, PNG o WebP, hasta 20 MB, reducida a 1200 px como máximo), **Cambiar imagen** y **Quitar imagen**; o la dirección pegada.
- Un envío sin ningún contenido se rechaza.

## Correos automáticos

En la pestaña **Automáticos**, el propietario y los administradores tienen el botón **Nueva campaña automática**, que crea una campaña programada para todos los días o para días de la semana. La pestaña muestra los modelos listos (como **Novedades de la semana**) y **Tus campañas recurrentes**. En **Campañas**, el envío predeterminado es el de **una vez**.

En la pestaña **Automáticos** hay correos listos que la plataforma mantiene. El primero es **Novedades de la semana**: un resumen semanal con **Últimas publicaciones**, **Cursos nuevos**, **Próximos eventos** y **Clasificados nuevos** (elige cuáles entran).

- **Viene apagado, en toda comunidad.** Ninguna comunidad manda correo masivo por su cuenta. Todo el equipo ve la pestaña; solo el propietario y los administradores lo encienden y ajustan.
- Para **Activar**, la ventana pide confirmar que enviará correo en volumen, el día y la hora elegidos, **sin que pulses nada**. Puedes apagarlo cuando quieras.
- Ajustables: día, hora, asunto, introducción y bloques. **Restaurar predeterminado** lo devuelve todo y lo apaga.
- **Semana sin nada nuevo, no envía.** La introducción sola no lo dispara.
- Respeta las bajas, solo trae contenido que todos ven, cuenta en la cuota y aparece en la lista y en los informes como cualquier campaña. No se envía, programa, edita ni elimina desde las pantallas comunes.

## Protección de la reputación de envío

- **Cuota:** los envíos programados, repetidos y automáticos **también cuentan**, uno por envío, cuando salen.
- **Primeros envíos:** mientras la comunidad no haya completado ningún envío, el público se limita a **500 personas**; por encima, el envío se rechaza antes de gastar cuota.
- **Pausa automática:** si un envío ya pasó de 50 correos y más del **5 %** volvieron como dirección que no recibe (rebote permanente) o más del **0,3 %** fueron quejas de spam, la campaña **se pausa sola** (y la repetición también), lo que falta no sale y los propietarios reciben un correo, una vez. Reanudar es decisión del propietario o del administrador.

## Lo que todavía no existe

Todavía no existe: un editor visual de arrastrar y soltar, la segmentación por comportamiento (por ejemplo, quien no abrió el último correo), las pruebas A/B, importar contactos de fuera de la comunidad y el envío por SMS o WhatsApp.

## Ejemplos

**Aviso a un grupo.** El equipo crea *"Clase inaugural"*, elige el grupo *Grupo de marzo*, envía la prueba, comprueba que 38 personas reciben y 2 quedan fuera (de baja) y el propietario envía.

**Comunicado a todos.** Un recado corto, con un botón a la comunidad, para **Todas las personas**. Si es el tercer envío del día, Memberfy lo rechaza antes de empezar y dice cuándo se libera la cuota.

## Errores frecuentes y cómo resolverlos

| Situación | Qué hacer |
|---|---|
| *Ponle un nombre a la campaña.* / *Escribe el asunto.* | Rellena los campos y guarda |
| *Cada botón necesita texto y un enlace que empiece por https://.* | Revisa el botón |
| *Elige al menos un grupo, etiqueta o persona, o envía a todas las personas.* | Define el público |
| *El público supera las 20.000 personas…* | Reduce el público o divide en campañas |
| Límite diario, semanal o mensual alcanzado | El mensaje dice cuál y cuándo se libera; espera o habla con Memberfy |
| Se rechaza a una persona elegida a mano | Se dio de baja: solo ella puede volver a recibir |
| No aparece el botón **Enviar ahora** | Solo propietario y administrador envían |

## Preguntas frecuentes

**¿La persona puede responderme?**
Sí: las respuestas van al correo de contacto del propietario.

**¿Puedo ver quién lo abrió?**
No. Los números son sumas, sin el nombre de nadie, y las aperturas son una estimación.

**Si alguien se da de baja, ¿pierdo el contacto?**
Solo por correo de campaña. Los avisos de la comunidad continúan, salvo que la persona los bloquee todos, y los correos de seguridad y de compra siempre llegan.

**¿La cuota es por correo enviado?**
No: es por **envío**. Un envío a 5 personas y otro a 5.000 gastan uno cada uno.

## En la API

`GET` y `POST /api/campaigns`, `GET`, `PUT` y `DELETE /api/campaigns/{id}` (solo borrador), `POST /api/campaigns/{id}/audience-preview`, `POST /api/campaigns/{id}/test`, `POST /api/campaigns/{id}/send` (cuerpo `consent: true`, responde `202`), `GET /api/campaigns/quota`, `GET /api/campaigns/opt-outs` y `GET` y `PUT /api/me/email-preferences`. La baja pública está en `/api/public/unsubscribe/{token}`. La referencia de cada ruta entra en la página [Referencia de la API](/api/referencia) cuando las campañas estén disponibles.

## Relacionados

- [Correos de la plataforma](/notificacoes/emails-da-plataforma)
- [Grupos y organigrama](/membros/grupos-e-organograma)
- [Etiquetas](/membros/tags)