Objeto de e-mail
O objeto
Objeto de e-mail
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 do app
- Qualquer
app_idválido de um app configurado no seu espaço de trabalho funciona para todos os usuários do espaço de trabalho, independentemente de o usuário ter o app específico em seu perfil ou não.
- Qualquer
- Para saber mais e conhecer as práticas recomendadas sobre pré-cabeçalhos, consulte Estilização de e-mail.

A Braze recomenda que você evite usar links do Google Drive para a url do seu anexo, pois isso pode bloquear as chamadas dos nossos servidores para obter o arquivo e resultar no não envio da mensagem de e-mail.
Tipos de anexo válidos incluem: 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 e pkpass.
Um email_template_id pode ser obtido na parte inferior de qualquer modelo de e-mail criado com o editor de HTML. A seguir, um exemplo de como esse ID aparece:

Exemplo de objeto de e-mail com anexo
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"
}]
}
}
}
Autenticação para anexos de arquivo em e-mail
Use uma credencial de autenticação básica armazenada quando a URL de um anexo exigir login. Isso se aplica a anexos no objeto de e-mail em /messages/send e ao array de nível superior attachments em /campaigns/trigger/send.
- Acesse Configurações > Conteúdo Conectado.
- Selecione Adicionar credencial.
- Selecione Autenticação básica.
- Insira um nome para a credencial, nome de usuário e senha.
- Inclua uma propriedade
basic_auth_credentialem cada anexo que exija autenticação e defina-a com o nome dessa credencial. O exemplo a seguir usa o nome de credencialcompany_basic_auth_credential_nameem um objeto de e-mail:
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" }
]
}
}
}
Recuperação, cache e desempenho de anexos
Quando a Braze busca um arquivo a partir de uma url de anexo:
- Cache: A Braze pode reutilizar um arquivo recuperado recentemente por até aproximadamente 24 horas. Se você precisa que cada envio utilize uma nova versão do arquivo imediatamente, use uma URL diferente por versão (por exemplo, um caminho ou parâmetro de consulta que mude quando o arquivo for alterado).
- Timeouts: Os hosts devem responder rapidamente. Se a URL do anexo for lenta ou travar, o envio da mensagem pode falhar — busque respostas em cerca de dois minutos.
- Segurança: Não inclua informações de identificação pessoal (IPI) ou dados sensíveis em URLs de anexos (incluindo query strings), pois as URLs podem aparecer em logs ou sistemas subsequentes.
- Firewalls: Se a URL for acessível apenas a partir de redes específicas, libere o tráfego da Braze conforme a lista de IPs permitidos do Connected Content. Use credenciais de autenticação básica quando o arquivo exigir login.