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

A Braze recomenda que você evite usar links do Google Drive para o url dos seus anexos, 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 anexos 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 recuperado na parte inferior de qualquer modelo de e-mail criado com o editor de HTML. Veja a seguir um exemplo de como esse ID se parece:

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 arquivos de e-mail
- Navegue até Configurações > Conteúdo conectado e clique em Adicionar credencial para adicionar suas credenciais de autenticação.
- Insira um nome e adicione um nome de usuário e uma senha.
- No objeto de e-mail do endpoint
/messages/send, inclua uma propriedadebasic_auth_credentialespecificando o nome da credencial nos detalhes do anexo. Consulte o exemplo a seguir com o nome da credencialcompany_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" }
]
}
}
}
Recuperação, cache e desempenho de anexos
Quando a Braze busca um arquivo a partir de um 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 distinta 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 — procure obter respostas em cerca de dois minutos.
- Segurança: não inclua informações de identificação pessoal (IPI) ou dados sensíveis nas URLs de anexos (incluindo query strings), pois as URLs podem aparecer em registros ou sistemas downstream.
- Firewalls: se a URL só é acessível a partir de redes específicas, libere o tráfego da Braze conforme a lista de IPs permitidos do Conteúdo conectado. Use credenciais de autenticação básica quando o arquivo exigir login.