# Correos predeterminados

> Cómo el propietario y el administrador cambian el texto de los correos que la plataforma envía en nombre de la comunidad (bienvenida, invitaciones, importación, solicitud de acceso aprobada, compra confirmada e inscripción en evento), con una versión por idioma, bloques fijos, variables permitidas, enlaces y lo que pasa cuando la versión de la comunidad no se puede usar.

Algunos correos los envía la plataforma sola, en nombre de la comunidad: la bienvenida a quien se registra, la invitación, el recibo de la compra. En **Correos predeterminados**, el propietario y el administrador cambian su texto por el de la comunidad, en el mismo editor de las [campañas de correo](/notificacoes/campanhas-de-email), sin cambiar cuándo ni a quién se envían.

**Dónde está:** **Administración › Campañas › Correos predeterminados**. Solo el propietario y el administrador ven la pestaña; el moderador y el financiero, no.

## Los correos que se pueden cambiar

Son seis familias, en tres grupos:

| Grupo | Correo | Quién lo recibe |
|---|---|---|
| **Entrada** | **Bienvenida al registro** | Quien se registra en la comunidad |
| **Entrada** | **Invitación (cuenta nueva)** e **Invitación (ya tiene cuenta)** | Quien es invitado |
| **Entrada** | **Importación (cuenta nueva)** e **Importación (ya tiene cuenta)** | Quien fue importado por planilla |
| **Entrada** | **Solicitud de acceso aprobada** | Quien pidió crear una comunidad y fue aprobado |
| **Compras** | **Compra confirmada** | El recibo de quien compró |
| **Eventos** | **Inscripción en evento** | La confirmación del **Voy**, con la entrada cuando hay check-in |

La lista muestra si cada uno está **Predeterminado** o **Personalizado** y en qué idiomas (*"Personalizado en: …"*). **Compra confirmada** e **Inscripción en evento** llevan la etiqueta **Se envía siempre**: no tienen enlace de baja y no aceptan bloques de difusión. Los demás respetan la categoría del correo en [Correos de esta comunidad](/notificacoes/emails-desta-comunidade) y traen el enlace para desactivarla.

## Cómo funciona

### Una versión por idioma

Cada correo predeterminado tiene una versión de la comunidad por idioma. Quien lee en un idioma sin versión de la comunidad recibe el correo predeterminado de la plataforma en ese idioma. **Usar la versión de la comunidad**, desactivado, hace salir el predeterminado en todos los idiomas, y las versiones se conservan.

**Restaurar predeterminado** borra la versión de la comunidad en el idioma abierto y pide confirmación: quien lee en ese idioma vuelve a recibir el predeterminado.

### Bloques fijos

Cada correo tiene **bloques fijos**, que completa la plataforma: el botón de crear la contraseña o de entrar, el botón de ir a la comunidad, el origen del contacto y el enlace *"no quiero participar"* en la importación, el resumen de la compra en el recibo, y la fecha, el lugar y la entrada con código QR en la inscripción en evento. En el editor aparecen como **Fijo**: se pueden mover de sitio, pero no quitar. Una versión sin un bloque fijo no se guarda.

El correo predeterminado acepta texto, botón, imagen y los bloques fijos; los bloques con el contenido de la comunidad (publicaciones, cursos, eventos, productos) no entran.

### Variables

Todos aceptan `{{nome}}`, `{{nome_completo}}`, `{{comunidade}}` y `{{membro_desde}}`, y cada uno tiene las suyas:

| Correo | Variables propias |
|---|---|
| Bienvenida al registro | `{{link_comunidade}}` |
| Invitación (cuenta nueva) | `{{convidado_por}}`, `{{validade_dias}}` |
| Invitación (ya tiene cuenta) | `{{convidado_por}}`, `{{link_login}}` |
| Importación (cuenta nueva) | `{{origem}}`, `{{validade_dias}}` |
| Importación (ya tiene cuenta) | `{{origem}}`, `{{link_login}}` |
| Compra confirmada | `{{produto}}`, `{{valor}}`, `{{metodo}}`, `{{link_acesso}}` |
| Inscripción en evento | `{{evento}}`, `{{data_hora}}`, `{{local}}`, `{{link_evento}}` |

Una variable que no es del correo se rechaza al guardar, y una variable no puede ir dentro de un enlace ni de la dirección de una imagen.

### Enlaces

Enlaces e imágenes solo con `https://`. En el recibo (**Compra confirmada**) y en la **Inscripción en evento**, los enlaces y botones solo pueden apuntar al dominio de la propia comunidad.

### Cuando no se usa la versión de la comunidad

Si la versión de la comunidad no se puede usar en el momento del envío (por ejemplo, el correo de la biblioteca vinculado a ella fue borrado), la persona recibe el correo predeterminado de la plataforma, y nada deja de llegar. Los propietarios reciben un aviso, *"el correo … salió con el predeterminado"*, con el motivo, como máximo una vez al día por cada correo.

### Envío y prueba

El correo predeterminado sale de la misma manera y a la misma hora que saldría el de la plataforma: no cuenta en la cuota de campañas. **Enviarme una prueba** envía la versión abierta solo a quien tiene la sesión iniciada.

## Paso a paso

1. En **Administración › Campañas**, abre **Correos predeterminados**.
2. Haz clic en el correo que quieres cambiar y elige el **Idioma**.
3. Escribe el asunto y el texto, con las variables de la lista y los bloques fijos donde quieras.
4. **Guardar**. Compruébalo con **Enviarme una prueba**.
5. Deja **Usar la versión de la comunidad** activado.

## Errores frecuentes y cómo resolverlos

| Mensaje | Por qué | Qué hacer |
|---|---|---|
| *Faltan los bloques fijos: … No pueden salir del correo.* | Se quitó un bloque fijo | Deshaz el cambio o usa **Restaurar predeterminado** |
| *La variable … no existe en este correo.* | Variable de otro correo | Usa solo las variables de la tabla |
| *Enlaces e imágenes solo con https://.* | Enlace o imagen con `http://` | Cámbialo por `https://` |
| *En el recibo y la entrada, enlaces y botones solo al dominio de la comunidad.* | Enlace a otro sitio en el recibo o en la inscripción en evento | Apunta a una página de la comunidad |
| *El correo predeterminado solo lleva texto, botón, imagen y los bloques fijos.* | Bloque de contenido de la comunidad | Quita el bloque |

## Por el asistente (MCP)

El propietario y el administrador leen, editan, activan, desactivan, restauran y prueban los correos predeterminados por el asistente; restaurar pide confirmación, y la prueba va solo a quien la pide. Consulta [Herramientas · Comunidad](/mcp/ferramentas-comunidade#biblioteca-de-correos-y-correos-predeterminados).

## En la API

`GET /api/email-overrides` lista los correos predeterminados; `GET` y `PATCH /api/email-overrides/{emailKey}` leen y activan o desactivan la versión de la comunidad; `GET`, `PUT` y `DELETE /api/email-overrides/{emailKey}/{language}` leen, guardan y restauran una versión; `POST …/preview` y `POST …/test` muestran y prueban. Solo propietario y administrador (`403` para los demás). Los bloques fijos son `{ "type": "systemSlot", "slot": "…" }`.

## Relacionados

- [Campañas de correo](/notificacoes/campanhas-de-email)
- [Correos de esta comunidad](/notificacoes/emails-desta-comunidade)
- [Correos de la plataforma](/notificacoes/emails-da-plataforma)
