Documentación

Primeros pasos

BgLetter es un Channel: una herramienta con la que envías correos a través de tu propio buzón (bring-your-own-SMTP). El envío pasa por tu servidor de correo, tú sigues siendo el remitente y la reputación de remitente sigue siendo tuya: no aportamos infraestructura de envío ni cobramos por correo.

Tu lista de destinatarios se queda contigo: los destinatarios provienen de un archivo CSV, en cada envío. No hay gestión de contactos: ni listas guardadas, ni segmentos, ni formularios de suscripción. Y los datos que necesita un envío se eliminan como muy tarde a los 30 días (consulta Conservación y eliminación).

Listo en cuatro pasos

1. Crea una cuenta. Regístrate gratis en /register.
2. Conecta tu propio buzón. Introduce las credenciales de tu servidor de correo (consulta «Conectar SMTP»).
3. Crea el contenido. Redacta tu correo en el creador de bloques o en el editor de código.
4. Sube la lista de destinatarios y envía. Carga el archivo CSV de este envío y envíalo de inmediato o prográmalo.

El servicio se dirige exclusivamente a empresas y otros usuarios profesionales o institucionales, no a consumidores.

Conectar SMTP

En Cuentas de remitente añades una o varias cuentas de envío. BgLetter incluye ajustes predefinidos de proveedor preconfigurados que rellenan el host, el puerto y el cifrado (p. ej. Gmail/Google Workspace, Microsoft 365, Brevo, SendGrid, Mailgun, Postmark). En algunos proveedores (p. ej. Amazon SES y all-inkl/KAS) introduces el host tú mismo, ya que varía según la región o el paquete.

Ajustes habituales

Host:           smtp.tudominio.com
Puerto:         587   (STARTTLS)  o  465 (SSL/TLS)
Usuario:        envio@tudominio.com
Contraseña:     ••••••••  (se recomienda contraseña de aplicación)
Remitente:      "Tu Nombre" <newsletter@tudominio.com>

Tras guardar, puedes lanzar una conexión de prueba. BgLetter informa de si el inicio de sesión y el cifrado funcionan.

Entregabilidad (SPF / DKIM / DMARC)

Que tus correos lleguen depende sobre todo de tu configuración DNS. Tres registros son fundamentales:

En resumen: SPF autoriza servidores, DKIM demuestra la autenticidad y DMARC indica a los destinatarios qué hacer ante falsificaciones. Los tres juntos aumentan notablemente la tasa de entrega.

Destinatarios y envío

Los destinatarios provienen de un archivo CSV, en cada envío. Subes el archivo en el editor, asignas las columnas y envías. No hay listas guardadas, ni segmentos, ni formularios de suscripción: tu lista de destinatarios se queda contigo y el archivo original permanece en tu equipo.

Estructura del archivo CSV

La primera fila es la fila de encabezado con los nombres de las columnas. Como separador se usan habitualmente la coma y el punto y coma; guarda el archivo en UTF-8 para conservar las tildes y la eñe.

Email;Nombre;Factura;Idioma;Pais
anna@example.com;Anna Berger;R-2041;de;DE
paul@example.org;Paul Vetter;R-2042;fr;FR

Las columnas pueden llamarse como quieras: tras la carga, eliges en el editor qué columna contiene la dirección de correo, cuál el nombre y cuál el idioma o el país. Hay un archivo de ejemplo en el editor, en «¿Cómo debe ser el CSV?».

Duplicados y lista de supresión

• Los duplicados se unifican automáticamente: si la misma dirección aparece varias veces en el archivo, solo se le escribe una vez; vale la primera fila con sus valores de personalización. La comparación no distingue mayúsculas de minúsculas.
• Las filas incompletas, sin dirección o con una dirección claramente inválida, se descartan antes del envío.
• La lista de supresión siempre se aplica. Las direcciones de tu lista de bajas se omiten automáticamente en cada envío; no necesitas depurar el archivo CSV antes.

Envío

• Vista previa para escritorio y móvil, con datos de ejemplo de la primera fila de tu archivo CSV.
• Personalización mediante marcadores como {{NAME}}, {{EMAIL}} y tus propias columnas.
• El enlace de baja se inserta automáticamente: es obligatorio y bueno para la reputación.
• El envío se realiza de forma regulada a través de tu propio buzón, para respetar sus límites de envío.

En Modo de envío eliges una de tres velocidades: Entrega segura (máxima fiabilidad, recomendado), Velocidad media (equilibrado) o Velocidad rápida (solo para buzones con límites de envío generosos). BgLetter distribuye el envío automáticamente para que los correos a un mismo proveedor no se sigan demasiado de cerca - no hacen falta ajustes de intervalo manuales, y los envíos con fallos temporales se reintentan automáticamente hasta dos veces. Envías de inmediato o de forma programada a una hora elegida.

En el envío inmediato sigues el progreso en directo y puedes pausar, reanudar o cancelar el envío en curso. El seguimiento de aperturas y clics está siempre activo.

Bajas / lista de supresión

La gestión de bajas es tu lista de supresión central: cada dirección aquí incluida se omite de forma fiable en todos los envíos, incluso si sigue estando en tu archivo CSV. Cuando un destinatario hace clic en el enlace de baja —también mediante baja con un clic (list-unsubscribe) desde su bandeja de entrada— aparece aquí de inmediato.

A partir del plan Pro, una entrada de menú propia Bajas abre la página; también puedes acceder directamente por la dirección /app/unsubscribes.

• Añadir: introduce direcciones manualmente (una por línea), con un motivo de la lista: Manual, Reclamación, No entregable (rebote) u Otro.
• Importar: carga listas de supresión existentes como archivo CSV o de texto.
• Exportar: descarga la lista completa como CSV (correo, motivo, fecha).

La lista de supresión es el único conjunto de datos que se conserva de forma permanente. Es una exigencia legal: solo así una baja sigue teniendo efecto más allá de un envío concreto, aunque la misma dirección vuelva a aparecer en un archivo CSV meses después.

Conservación y eliminación

BgLetter guarda lo mínimo posible y durante el menor tiempo posible. Para cada envío rige un plazo fijo: como muy tarde 30 días después del envío, los datos asociados se eliminan automáticamente. Ocurre sin que tengas que hacer nada y no se puede prolongar.

Qué se elimina a los 30 días

• Las direcciones de los destinatarios del archivo CSV cargado.
• Los datos de personalización: nombres y todas las demás columnas de tu archivo.
• El contenido del mensaje del envío (texto, HTML, bloques, traducciones).
• Los eventos de seguimiento: aperturas y clics individuales, con su hora y su vínculo al destinatario.

Qué se conserva

• La línea de asunto y la fecha y hora del envío.
• Cifras anónimas: número de destinatarios, enviados, fallidos, tasa de entrega, así como aperturas y clics como totales, sin vínculo con personas concretas.
• La lista de bajas (lista de supresión). Se conserva de forma permanente, porque de lo contrario una baja dejaría de tener efecto a los 30 días.

Borradores y plantillas

También los borradores sin modificar se eliminan 30 días después del último cambio. Por eso, el contenido que quieras conservar y reutilizar debe ir en una plantilla: las plantillas no dependen de ningún envío y permanecen hasta que tú las elimines.

Menos datos guardados significa menos que pueda perderse. El plazo no es una limitación, sino la razón por la que tu lista de destinatarios nunca queda almacenada de forma permanente en nuestros sistemas.

Mensajes (transaccionales)

Desde la sección Mensajes envías correos transaccionales individuales - como facturas, recordatorios de pago, recibos de pago, recordatorios de cita, confirmaciones de pedido o notificaciones - a un único destinatario a través de tu propia cuenta de remitente. Los mensajes están disponibles en todos los planes (incluido Free).

Para pagos, el editor de bloques incluye dos bloques: el botón de pago (un enlace de pago como plantilla - PayPal.Me, PayPal Checkout, Stripe Payment Link o cualquier URL propia; variables como {{AMOUNT}} o {{INVOICE_NUMBER}} se insertan por destinatario al enviar, importes en formato con punto como 12.50) y el código QR SEPA (Girocode): los destinatarios lo escanean con su app bancaria y reciben una transferencia prerrellenada con IBAN, importe y concepto - sin ningún proveedor de pagos. Ambos bloques ya están preparados en las plantillas «Factura» y «Recordatorio de pago» y solo se envían cuando están configurados (URL o IBAN).

• Plantillas para los casos más habituales (factura, recordatorio de pago, recibo, recordatorio de cita, confirmación de pedido, notificación).
• Adjuntos: hasta 10 archivos con un total máx. de 10 MB (p. ej. una factura en PDF).
• Personalización mediante {{NAME}} y {{EMAIL}}.
• Seguimiento de aperturas opcional por mensaje.

Editor y creador de bloques

Los boletines se redactan en el editor, que ofrece dos modos: el creador de bloques (bloques mediante arrastrar y soltar, con formato en línea: selecciona el texto y cambia su tamaño, color, negrita, etc. directamente) y el editor de código para tu propio HTML. El creador de bloques genera un código de correo que se muestra de forma fiable en Outlook, Gmail y Apple Mail.

Bloques disponibles

• Texto, botón e imagen para el contenido.
• Columnas (2, 3 o 4), separador y espaciado para el diseño.
• Redes sociales y un bloque HTML para tus propios fragmentos.

Traducción con IA

En el editor traduces el asunto y el contenido a hasta 36 idiomas con un clic. Eliges el idioma de origen, el tratamiento (formal o informal) y los idiomas de destino deseados. Los marcadores como {{NAME}} se conservan.

Para el envío multilingüe, cada destinatario recibe la variante de idioma adecuada: si tu archivo CSV incluye una columna de idioma (p. ej. «Idioma») o de país (p. ej. «País»), se envía automáticamente la traducción correcta por destinatario; de lo contrario, la versión de origen.

No necesitas traducir de antemano: cada idioma detectado entre tus destinatarios se traduce automáticamente al inicio del envío (estado «Traduciendo»); la entrega solo comienza cuando todas las versiones están listas.

Cómo funciona la asignación de idioma: la columna puede tener cualquier nombre; tras la carga eliges qué columna contiene el idioma. Se reconocen: códigos de idioma (de, deu, ger), locales (de-DE, en-US), nombres de idioma (Deutsch, German) y nombres y códigos de país (Deutschland, Germany, DE, AT). Los valores vacíos o desconocidos reciben la versión original. La columna sigue disponible como marcador.

Seguimiento

BgLetter registra aperturas y clics por envío. En el análisis ves la tasa de apertura y de clics y los enlaces más clicados.

Los eventos individuales están vinculados a un destinatario solo mientras exista el envío: como muy tarde 30 días después del envío se eliminan. Después solo quedan los totales anónimos (consulta Conservación y eliminación).

Envíos e informes

En Campañas y estadísticas encuentras todos los envíos con fecha, asunto, estado, número de destinatarios, enviados, fallidos y la tasa de entrega (enviados ÷ total de destinatarios). Los más recientes aparecen arriba. Con el icono del ojo abres el informe.

El informe muestra arriba las cifras clave, incluidas aperturas y clics, además de una barra de «Progreso del envío». La tarjeta Reacciones de los destinatarios indica las aperturas y los clics como únicos y totales y calcula la tasa de clics (CTR) a partir de los clics únicos por apertura única. Una tabla enumera los enlaces más clicados con clics y clics únicos.

• Tabla de destinatarios: por destinatario, el correo, el proveedor de correo, el nombre, el estado y, en caso de error, el mensaje de error SMTP exacto, además de la hora de envío. Esta tabla está disponible durante 30 días.
• Filtros: Todos, Enviados, Fallidos, Pendientes.
• Exportación CSV: «Exportar como tabla (CSV)» descarga todos los destinatarios, independientemente del filtro activo. Expórtalo a tiempo, mientras los datos sigan disponibles.

En la vista general no hay eliminación manual, y tampoco hace falta: a los 30 días BgLetter retira por sí mismo los datos de los destinatarios, el contenido y los eventos de seguimiento. El asunto y las cifras anónimas se conservan como historial.

API REST (breve resumen)

Para integraciones, BgLetter ofrece una API REST. Las claves de API se generan en el área de desarrolladores de tu cuenta. La autenticación se realiza con un token bearer en la cabecera.

# Enviar un mensaje transaccional
curl -X POST https://bgletter.com/api/v1/messages \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "cliente@example.com", "subject": "Tu factura", "html": "<p>Hola …</p>" }'

La URL base es <tu-dominio>/api/v1; la autenticación se realiza con Authorization: Bearer bgl_… o X-Api-Key: bgl_…. Están disponibles endpoints para mensajes transaccionales (POST /api/v1/messages), para la lista de bajas y endpoints de lectura para la cuenta y los envíos. La especificación completa está en /api/v1/openapi.json.

• Idempotencia: una cabecera Idempotency-Key al enviar mensajes evita la entrega duplicada en los reintentos.
• Firma de webhook: cada entrega lleva X-BgLetter-Signature: sha256=… (HMAC-SHA256 sobre el cuerpo en bruto con tu clave whsec_) - verifícala antes de procesarla.
• Límite de peticiones: 120 peticiones/minuto por cuenta (los mensajes, además, 300/hora).

Además, dispones de webhooks para notificar a tu sistema en tiempo real sobre eventos (p. ej. baja, rebote). Encontrarás los endpoints y respuestas de ejemplo en el área de desarrolladores.

Facturación

BgLetter factura con un precio de plan mensual fijo, sin coste por correo. Los planes se diferencian en el volumen de envío mensual, el número de cuentas de remitente y otros límites.

• Plan Free gratuito para probar, sin necesidad de tarjeta de crédito.
• Sube de plan cuando quieras en la sección Facturación. Para pasar a un plan inferior, cancela la suscripción (pasa a Free al final del periodo).
• Todos los precios se entienden en euros; la facturación corre a cargo de Fontemia GmbH, Grammetstr. 14, CH-4410 Liestal.

Equipo y cuenta

En Administración invitas a los miembros del equipo y asignas roles: Propietario, Admin o Miembro. Solo el propietario y los admins ven la Administración; solo el propietario puede invitar, cambiar roles y eliminar miembros.

El número de plazas depende del plan - un segundo miembro del equipo es posible a partir del plan Pro. Cada miembro activa por sí mismo su autenticación de dos factores (2FA) en Ajustes.

Ajustes

En Ajustes gestionas tu cuenta en una sola página con cinco tarjetas. La contraseña y la autenticación de dos factores están disponibles para cualquier miembro; la dirección de facturación, el branding y Datos y privacidad están reservados al propietario.

• Cambiar contraseña: una nueva contraseña de al menos 8 caracteres. Cambiarla cierra automáticamente todas las demás sesiones.
• Autenticación de dos factores: se configura mediante un código QR; después se muestran 8 códigos de recuperación de un solo uso exactamente una vez (guárdalos bien: no se pueden volver a mostrar). Para desactivarla se necesita un código actual de tu app.
• Dirección de facturación: empresa, dirección y NIF/CIF; aparece en tus facturas (solo el propietario).
• Branding: color de marca, URL del logotipo, dirección postal y un pie de correo propio (detalles abajo).
• Datos y privacidad: «Exportar mis datos (JSON)» como archivo, además de la eliminación definitiva de la cuenta (en dos pasos, irreversible).

En Branding, el color de marca y la URL del logotipo solo afectan a las páginas públicas que ven tus destinatarios, como la página de baja, no a los correos enviados. En cambio, la dirección postal (remitente) se inserta en el pie de cada correo saliente; si la dejas vacía, falta la línea de dirección (obligación legal según el § 5 TMG en Alemania). Un pie de correo en HTML propio está disponible a partir del plan Business.

Solución de problemas

Las preguntas más frecuentes y su solución de un vistazo. La mayoría de los problemas de entregabilidad se resuelven en pocos minutos.

¿Hay una función en gris? Entonces no está incluida en tu plan: junto al botón se indica el plan necesario (p. ej. «Desde Pro»). Un upgrade en la sección Facturación la desbloquea.