이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.
이메일 오브젝트
이메일 객체
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,
}
- 앱 식별자
- 워크스페이스에 구성된 앱의 유효한
app_id는 해당 사용자의 프로필에 특정 앱이 있는지 여부에 관계없이 워크스페이스의 모든 사용자에게 작동합니다.
- 워크스페이스에 구성된 앱의 유효한
- 프리헤더에 대한 자세한 정보와 모범 사례는 이메일 스타일링을 참조하세요.

경고
Braze는 첨부 파일의 url에 Google Drive 링크를 사용하지 않는 것을 권장합니다. 이는 서버에서 파일을 가져오기 위한 호출을 차단하여 이메일 메시지가 전송되지 않을 수 있기 때문입니다.
유효한 첨부 파일 유형에는 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, 및 pkpass가 포함됩니다.
email_template_id는 HTML 편집기로 만든 이메일 템플릿 하단에서 확인할 수 있습니다. 다음은 이 ID가 어떻게 표시되는지 보여주는 예시입니다.

첨부 파일이 포함된 이메일 오브젝트 예시
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"
}]
}
}
}
이메일 파일 첨부를 위한 인증
첨부파일 URL에 로그인이 필요한 경우, 저장된 기본 인증 자격 증명을 사용하세요. 이는 /messages/send의 이메일 객체 내 첨부파일과 /campaigns/trigger/send의 최상위 attachments 배열에 적용됩니다.
- 설정 > 연결된 콘텐츠로 이동합니다.
- 자격 증명 추가를 선택합니다.
- 기본 인증을 선택합니다.
- 자격 증명 이름, 사용자 이름, 비밀번호를 입력합니다.
- 인증이 필요한 각 첨부파일에
basic_auth_credential속성정보를 포함하고, 해당 자격 증명 이름으로 설정합니다. 다음 예시에서는 이메일 객체에서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": "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" }
]
}
}
}
첨부파일 검색, 캐싱 및 성능
Braze가 첨부파일 url에서 파일을 가져올 때:
- 캐싱: Braze는 최근에 가져온 파일을 약 24시간 동안 재사용할 수 있습니다. 매 발송 시 파일의 새 버전을 즉시 가져와야 하는 경우, 버전별로 고유한 URL을 사용하세요(예: 파일이 변경될 때 함께 변경되는 경로 또는 쿼리).
- 타임아웃: 호스트는 빠르게 응답해야 합니다. 첨부파일 URL이 느리거나 응답하지 않으면 메시지 발송이 실패할 수 있습니다. 약 2분 이내에 응답하는 것을 목표로 하세요.
- 보안: 첨부파일 URL(쿼리 문자열 포함)에 개인 식별 정보(PII)나 비밀 정보를 포함하지 마세요. URL은 로그나 다운스트림 시스템에 노출될 수 있습니다.
- 방화벽: URL이 특정 네트워크에서만 접근 가능한 경우, 연결된 콘텐츠 IP 허용 목록에 따라 Braze의 트래픽을 허용하세요. 파일에 로그인이 필요한 경우 기본 인증 자격 증명을 사용하세요.
New Stuff!