Objeto de correo electrónico
El objeto
Objeto de correo electrónico
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"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 aplicación
- Cualquier
app_idválido de una aplicación configurada en tu espacio de trabajo funciona para todos los usuarios en tu espacio de trabajo, independientemente de si el usuario tiene la aplicación específica en su perfil o no.
- Cualquier
- Para obtener más información y buenas prácticas sobre 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 incluyen: 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.
Se puede 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 del aspecto de este ID:

Ejemplo de objeto de correo electrónico con archivo adjunto
1
2
3
4
5
6
7
8
9
10
11
12
{
"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 en correos electrónicos
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 en el objeto de correo electrónico de /messages/send y al array de nivel superior attachments en /campaigns/trigger/send.
- Ve a Configuración > Contenido conectado.
- Selecciona Agregar 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:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
"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 los archivos adjuntos
Cuando Braze obtiene un archivo de una url de adjunto:
- Almacenamiento en caché: Braze puede reutilizar un archivo obtenido recientemente durante aproximadamente 24 horas. Si necesitas que cada envío utilice una versión nueva del archivo de inmediato, usa una URL distinta por versión (por ejemplo, una ruta o consulta que cambie cuando el archivo cambie).
- Tiempos de espera: Los servidores deben responder rápidamente. Si la URL del adjunto es lenta o no responde, el envío del mensaje puede fallar; procura que las respuestas se produzcan en aproximadamente dos minutos.
- Seguridad: No incluyas información de identificación personal (PII) ni datos sensibles en las URL de los adjuntos (incluidas las cadenas de consulta), ya que las URL pueden aparecer en registros o sistemas posteriores.
- Firewalls: Si la URL solo es accesible desde redes específicas, permite el tráfico desde Braze de acuerdo con la lista de IP permitidas de contenido conectado. Usa credenciales de autenticación básica cuando el archivo requiera inicio de sesión.