Objeto de correo electrónico
El objeto
Objeto de correo electrónico
{
"app_id": (required, string), see App Identifier,
"subject": (optional, string),
"from": (required, valid email address in the format "Display Name <[email protected]>"),
"reply_to": (optional, valid email address in the format "[email protected]" - defaults to your workspace's default reply to if not set) - use "NO_REPLY_TO" to set reply-to address to null,
"bcc": (optional, one of the BCC addresses defined in your workspace's email settings) if provided and the BCC feature is enabled for your account, this address gets added to your outbound message as a BCC address,
"body": (required unless email_template_id is given, valid HTML),
"plaintext_body": (optional, valid plaintext, defaults to autogenerating plaintext from "body" when this is not set),
"preheader": (optional*, string) recommended length 50-100 characters,
"email_template_id": (optional, string) if provided, Braze uses the subject/body/should_inline_css values from the given email template UNLESS they are specified here, in which case Braze overrides the provided template,
"message_variation_id": (optional, string) used when providing a campaign_id to specify which message variation this message should be tracked under,
"extras": (optional, valid Key-Value Hash) extra hash - for SendGrid users, this is passed to SendGrid as Unique Arguments,
"headers": (optional, valid Key-Value Hash) hash of custom extensions headers (available for SparkPost, SendGrid, or Amazon SES),
"should_inline_css": (optional, boolean) whether to inline CSS on the body. If not provided, falls back to the default CSS inlining value for the workspace,
"attachments": (optional, array) array of JSON objects that define the files you need attached, defined by "file_name", "url", and optionally "basic_auth_credential",
"file_name": (required, string) the name of the file you want to attach to your email, excluding the extension (for example, ".pdf"). Attach files up to 2 MB. This is required if you use "attachments",
"url": (required, string) the corresponding URL of the file you want to attach to your email. The file name's extension is detected automatically from the URL defined, which should return the appropriate "Content-Type" as a response header. This is required if you use "attachments",
"basic_auth_credential": (optional, string) the name of the stored basic authentication credential to use when the attachment URL requires a login,
}
- Identificador de la aplicación
- Cualquier
app_idválido de una aplicación configurada en tu espacio de trabajo funciona para todos los usuarios de tu espacio de trabajo, independientemente de si el usuario tiene o no la aplicación específica en su perfil.
- Cualquier
- Para obtener más información y buenas prácticas sobre los preencabezados, consulta Estilo del correo electrónico.

Braze recomienda que evites usar enlaces de Google Drive para la url de tu archivo adjunto, ya que esto puede bloquear las llamadas de nuestros servidores para obtener el archivo y provocar que el mensaje de correo electrónico no se envíe.
Los tipos de archivos adjuntos válidos son: txt, csv, log, css, ics, jpg, jpe, jpeg, gif, png, bmp, psd, tif, tiff, svg, indd, ai, eps, doc, docx, rtf, odt, ott, pdf, pub, pages, mobi, epub, mp3, m4a, m4v, wma, ogg, flac, wav, aif, aifc, aiff, mp4, mov, avi, mkv, mpeg, mpg, wmv, xls, xlsx, ods, numbers, odp, ppt, pptx, pps, key, zip, vcf y pkpass.
Puedes obtener un email_template_id en la parte inferior de cualquier plantilla de correo electrónico creada con el editor HTML. A continuación se muestra un ejemplo de cómo es este ID:

Ejemplo de objeto de correo electrónico con archivo adjunto
{
"external_user_ids": ["YOUR_EXTERNAL_USER_ID"],
"messages":{
"email":{
"app_id":"YOUR_APP_ID",
"attachments":[{
"file_name":"YourFileName",
"url":"https://exampleurl.com/YourFileName.pdf"
}]
}
}
}
Autenticación para archivos adjuntos de correo electrónico
Usa una credencial de autenticación básica almacenada cuando la URL de un archivo adjunto requiera iniciar sesión. Esto se aplica a los archivos adjuntos del objeto de correo electrónico en /messages/send y a la matriz attachments de nivel superior en /campaigns/trigger/send.
- Ve a Configuración > Administración de credenciales.
- Selecciona Añadir credencial.
- Selecciona Autenticación básica.
- Introduce un nombre de credencial, un nombre de usuario y una contraseña.
- Incluye una propiedad
basic_auth_credentialen cada archivo adjunto que requiera autenticación y establécela con ese nombre de credencial. El siguiente ejemplo usa el nombre de credencialcompany_basic_auth_credential_nameen un objeto de correo electrónico:
{
"external_user_ids": ["recipient_user_id"],
"messages":{
"email":{
"app_id": "153e8a29-fd6d-4f77-ade7-1a4ca08d457a",
"subject": "Basic auth attachment test",
"from": "mail <[email protected]>",
"body": "my attachment test",
"attachments":[
{ "file_name":"checkout_receipt.pdf",
"url":"https://fileserver.company.com/user123-checkout_receipt.pdf",
"basic_auth_credential": "company_basic_auth_credential_name" }
]
}
}
}
Recuperación, almacenamiento en caché y rendimiento de archivos adjuntos
Cuando Braze obtiene un archivo desde la url de un archivo adjunto:
- Almacenamiento en caché: Braze puede reutilizar un archivo recuperado recientemente durante aproximadamente 24 horas. Si necesitas que cada envío use al instante una nueva versión del archivo, utiliza una URL distinta para cada versión. Por ejemplo, puedes usar una ruta o una consulta que cambie cuando cambie el archivo.
- Tiempos de espera: Los hosts deben responder rápido. Si la URL del archivo adjunto es lenta o se queda colgada, el envío del mensaje puede fallar. Intenta que las respuestas lleguen en unos dos minutos como máximo.
- Seguridad: No incluyas información personal identificable (PII) ni secretos en las URL de los archivos adjuntos (tampoco en las cadenas de consulta), porque las URL pueden aparecer en registros o en sistemas posteriores.
- Cortafuegos: Si solo se puede acceder a la URL desde redes específicas, permite el tráfico de Braze según la lista de IP permitidas de contenido conectado. Usa credenciales de autenticación básica cuando el archivo requiera iniciar sesión.