Skip to content

Objeto de correo electrónico

El objeto email te permite modificar o crear correos electrónicos a través de nuestros puntos finales de mensajería.

Objeto de correo electrónico

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "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" and "url",
    "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",
}
  • Identificador de la aplicación
    • Cualquier app_id vá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 la aplicación específica en su perfil o no.
  • Para más información y mejores prácticas sobre preencabezados, consulta Estilo de correo electrónico.

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.

Se puede recuperar un email_template_id de 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:

Sección del identificador de API de una plantilla de correo electrónico HTML.

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 de archivos adjuntos de correo electrónico

  1. Ve a Configuración > Contenido conectado y haz clic en Añadir credencial para añadir tus credenciales de autenticación.
  2. Introduce un nombre y añade un nombre de usuario y una contraseña.
  3. En el objeto de correo electrónico del punto de conexión /messages/send, incluye una propiedad basic_auth_credential que especifique el nombre de la credencial en los detalles del archivo adjunto. Consulta el siguiente ejemplo con el nombre de credencial company_basic_auth_credential_name:
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": "Basis 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 de la url de un archivo adjunto:

  • Almacenamiento en caché: Braze puede reutilizar un archivo obtenido recientemente durante aproximadamente 24 horas. Si necesitas que cada envío recoja una nueva versión del archivo de inmediato, usa una URL distinta por versión (por ejemplo, una ruta o parámetro de consulta que cambie cuando el archivo cambie).
  • Tiempos de espera: Los servidores deben responder rápidamente. Si la URL del archivo adjunto es lenta o no responde, el envío del mensaje puede fallar; procura que las respuestas se produzcan en un plazo de aproximadamente dos minutos.
  • Seguridad: No incluyas información de identificación personal (PII) ni datos confidenciales en las URL de los archivos 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 de 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.
New Stuff!