WhatsApp 메시지 및 이미지 형식
WhatsApp 메시지 및 템플릿을 만들기 위한 메시지 구조, 구성요소, 미디어 자산에 대한 요구 사항은 다음과 같습니다.
Braze에는 두 가지 유형의 WhatsApp 메시지가 있습니다: 템플릿 메시지와 응답 메시지.
| 메시지 유형 | 사용 시점 | Meta 승인 |
|---|---|---|
| 템플릿 메시지 | 비즈니스에서 시작하는 아웃리치; 언제든지 발송 가능 | 필수; 템플릿은 발송 전에 Meta에 제출하여 승인을 받아야 합니다. |
| 응답 메시지 | 사용자가 시작한 메시지에 대한 답장; 24시간 대화 기간 내에서만 가능 | 필수 아님 |
템플릿 메시지는 Meta에 제출하여 승인을 받아야 하며, 최대 24시간이 소요될 수 있습니다. 승인 후에는 언제든지 발송할 수 있습니다. 응답 메시지(Meta 설명서에서는 “세션 메시지”라고 함)는 활성 대화 기간이 열려 있는 동안에만 발송할 수 있으며, 사용자의 마지막 인바운드 메시지로부터 24시간 이내에만 가능합니다.
템플릿 메시지
WhatsApp 템플릿 메시지는 비즈니스가 먼저 연락을 시작할 때 사용하는 사전 승인된 메시지 형식입니다. Braze에서는 Meta에 제출하기 전에 정의하는 구성 요소로 템플릿을 만듭니다. 모든 템플릿 메시지는 마케팅, 유틸리티, 인증 중 하나의 카테고리에 속합니다.
마케팅 템플릿
마케팅 템플릿은 Braze에서 가장 많이 사용하는 유형입니다. 최대 4개의 구성 요소로 이루어집니다.
| 구성 요소 | 필수 여부 | 참고 |
|---|---|---|
| 헤더 | 아니요 | 텍스트, 이미지, 비디오, 문서 또는 위치를 지원합니다. 파일 형식, 크기, 해상도 요구 사항은 미디어 사양을 참조하세요. |
| 본문 | 예 | 기본 메시지 콘텐츠 |
| 푸터 | 아니요 | 본문 뒤에 표시되는 보조 텍스트 |
| 버튼 | 아니요 | 최대 10개의 버튼 포함 가능(모든 버튼 유형 지원) |
글자 수
| 구성 요소 | 최대 글자 수 |
|---|---|
| 본문 | 1,024자 |
| 푸터 | 60자 |
| 버튼 레이블(URL, 전화, 빠른 답장) | 25자 |
| 전화번호(전화 버튼 내) | 20자 |
| 오퍼 코드(Copy offer code 버튼) | 15자 |
| 템플릿 이름 | 512자(소문자, 영숫자, 밑줄만 사용 가능) |
버튼 유형
| 버튼 유형 | 동작 | 참고 |
|---|---|---|
| 빠른 답장 | 버튼 레이블 텍스트를 대화에 답장으로 전송합니다. | |
| URL | 사용자의 기본 브라우저에서 URL을 엽니다. URL 끝에 변수 1개를 추가할 수 있습니다(최대 2,000자). | 특수 문자(예: &, %, <, >)가 포함된 URL은 메시지 전송 실패를 일으킬 수 있습니다. url_param_escape 또는 url_escape Liquid 필터를 사용해 특수 문자가 포함된 URL을 올바르게 인코딩하세요. |
| 전화번호 | 지정한 전화번호로 전화를 겁니다. | |
| 쿠폰 코드 복사 | 쿠폰 코드를 사용자의 클립보드에 복사합니다. | 항상 Meta 승인이 필요합니다. |
파라미터 형식
템플릿 변수에는 이름이 지정된 파라미터(예: {{first_name}}) 또는 위치 기반 파라미터(예: {{1}})를 사용할 수 있습니다. Braze에서는 변수를 Liquid 또는 일반 텍스트로 대체할 수 있습니다. Liquid 변수에는 항상 기본값을 포함하세요. 변수 값이 누락된 메시지는 전송되지 않습니다.
기간 한정 오퍼 템플릿
기간 한정 오퍼 템플릿은 시간에 민감한 프로모션 오퍼를 표시하며, 오퍼 만료가 가까워지면 선택적으로 카운트다운을 보여줍니다. 시즌 세일이나 사용자 속성에 맞춰 개인화된 오퍼처럼 기간이 정해진 프로모션에 이 레이아웃을 사용하세요.
| 구성 요소 | 필수 여부 | 참고 |
|---|---|---|
| 헤더 | 아니요 | None을 선택하거나 미디어(이미지 또는 비디오)를 추가합니다. 파일 형식, 크기, 해상도 요구 사항은 미디어 사양을 참조하세요. |
| 오퍼 세부 정보 | 예 | 오퍼 제목, 오퍼 코드, 선택적 만료 시간 |
| 본문 | 예 | 기본 메시지 콘텐츠입니다. Liquid를 지원합니다. |
| 푸터 | 아니요 | 본문 뒤에 표시되는 보조 텍스트입니다. |
| 버튼 | 예 | Copy offer code 버튼이 자동으로 포함됩니다. Visit website 버튼을 1개 추가할 수 있으며, 이 템플릿 유형에서는 다른 버튼 유형을 지원하지 않습니다. |
오퍼 세부 정보
| 필드 | 필수 여부 | 참고 |
|---|---|---|
| 제목 | 예 | 오퍼를 설명하는 짧은 문구입니다. 최대 16자입니다. |
| 코드 | 예 | 수신자가 복사할 오퍼 코드입니다. 이 값은 Copy offer code 버튼에 자동으로 입력됩니다. 최대 20자입니다(영숫자, 공백 없음). |
| 만료 | 아니요 | 고정된 날짜와 시간(예: 여름 세일 종료일)을 설정하거나 사용자 속성(예: 각 사용자의 생일)을 기반으로 개인화할 수 있습니다. |
만료를 설정하면 수신자는 오퍼 종료가 가까워질수록 업데이트되는 카운트다운을 메시지에서 확인할 수 있습니다. 예를 들어 메시지는 처음에 종료일을 표시하다가 종료일이 가까워지면 “5일 남음”과 같은 문구로 바뀔 수 있습니다. 만료를 설정하지 않으면 오퍼는 카운트다운 없이 표시됩니다. 만료 시간이 이미 지난 경우(예: 만료일이 2026년 11월 1일인데 전송 시간이 2026년 11월 15일인 경우) Braze는 메시지가 전송되지 않도록 차단합니다.
버튼 유형
| 버튼 유형 | 참고 |
|---|---|
| 오퍼 코드 복사 | 자동으로 포함됩니다. 버튼 텍스트는 “Copy offer code”이며 편집할 수 없습니다. |
| 웹사이트 방문 | 추가할 수 있는 유일한 다른 버튼입니다. 최대 1개입니다. |
미디어 카드 캐러셀 템플릿
캐러셀 템플릿은 메시지 본문 뒤에 가로로 스크롤할 수 있는 2~10개의 제품 카드를 표시하며, 각 카드에는 고유한 미디어 에셋과 버튼이 있습니다. 마케팅 템플릿 메시지에서만 사용할 수 있습니다.
최상위 메시지
| 구성 요소 | 필수 여부 | 최대 속성 | 참고 |
|---|---|---|---|
| 본문 텍스트 | 예 | 1,024자 | 변수 지원 |
| 카드 | 예 | 2~10개 카드 | 카드 수는 템플릿 생성 시 고정됩니다. 승인된 캐러셀 템플릿은 생성 시 정의한 정확한 카드 수로만 전송할 수 있습니다. |
카드별 사양
| 구성 요소 | 필수 여부 | 참고 |
|---|---|---|
| 헤더(이미지 또는 비디오) | 예 | 모든 카드는 동일한 형식(모두 이미지 또는 모두 비디오)을 사용해야 합니다. 구성 요소 구조도 동일해야 하므로 본문 텍스트나 버튼이 있는 카드와 없는 카드를 섞을 수 없습니다. 카드 헤더 에셋은 사용자의 기기에 따라 와이드 비율로 자동 잘립니다. |
| 본문 텍스트 | 아니요 | 카드 중 하나라도 본문 텍스트를 포함하면 모든 카드에 본문 텍스트가 있어야 합니다. |
| 버튼 | 아니요 | 카드당 최대 2개의 버튼 |
카드별 글자 수
| 구성 요소 | 최대 글자 수 | 참고 |
|---|---|---|
| 카드 본문 텍스트 | 160자 | |
| 버튼 레이블 | 25자 | |
| 전화번호(전화 버튼 내) | 20자 | |
| URL(URL 버튼 내) | 2,000자, 끝에 변수 1개 추가 가능 | URL 버튼은 WhatsApp 외부의 사용자 기본 브라우저에서 열립니다. 그 시점부터는 주문 또는 전환 웹훅이 트리거되지 않습니다. |
응답 메시지
응답 메시지(Meta에서는 ‘세션 메시지’라고도 함)는 24시간 대화 창 내에서만 보낼 수 있습니다. 이 창은 사용자가 비즈니스에 메시지를 보내면 열리고 다시 시작됩니다.
Braze Campaign 또는 Canvas 편집기에서 직접 작성한 응답 메시지는 Meta 승인이 필요하지 않습니다.
Braze는 7가지 응답 메시지 레이아웃을 지원합니다.
| 메시지 레이아웃 | 설명 |
|---|---|
| 텍스트 | 일반 메시지 본문 텍스트 |
| 미디어 | 이미지, 비디오, 오디오 또는 문서 첨부 파일이 포함된 메시지 |
| 빠른 답장 | 탭할 수 있는 답장 버튼이 최대 3개 포함된 메시지 |
| 클릭 유도 문구(CTA) 버튼 | URL 버튼 또는 전화번호 버튼이 포함된 메시지 |
| 목록 메시지 | 선택 가능한 옵션을 구조화된 스크롤 목록으로 보여주는 메시지 |
| 플로우 메시지 | 사용자에게 WhatsApp에서 양식이나 인터랙티브 작업을 완료하도록 요청하고, 그 결과를 Braze로 반환하는 메시지 |
| Meta 제품 메시지 | 연결된 Meta 카탈로그의 단일 제품, 여러 제품 또는 전체 카탈로그를 강조하는 메시지 |
목록 메시지 구성 요소
| 구성 요소 | 최대 속성 |
|---|---|
| 본문 텍스트 | 4,096자 |
| 버튼 레이블(목록 열기용) | 20자 |
| 섹션 수 | 최대 10개 |
| 섹션당 행 수 | 최대 10개 |
| 섹션 제목 | 24자 |
| 행 제목 | 24자 |
| 행 설명 | 72자 |
빠른 답장 구성 요소
| 구성 요소 | 최대 속성 |
|---|---|
| 버튼 | 최대 3개 |
| 버튼 레이블 | 버튼당 20자 |
미디어 사양
다음 사양은 WhatsApp 템플릿 헤더, 응답 메시지 또는 독립형 미디어 메시지의 모든 미디어에 적용됩니다.

이미지
이 사양은 템플릿 헤더, 응답 미디어 메시지 및 이미지 메시지에 적용됩니다.
| 속성 | 사양 | 참고 |
|---|---|---|
| 지원 형식 | JPEG, PNG | Meta는 이미지 메시지에 대해 JPEG와 PNG만 공식적으로 지원합니다. WebP는 스티커에만 지원되며 일반 이미지 메시지에는 지원되지 않습니다. |
| 최대 파일 크기 | 5 MB | |
| 색상 모드 | 8비트, RGB 또는 RGBA | |
| 캡션(이미지 메시지만 해당) | 선택 사항; 최대 1,024자 | |
| 권장 크기 | 1,125 × 600 px | 기기 간 일관된 렌더링과 Meta 요구 사항 준수를 위해 1,125×600 px(1.91:1) 크기의 JPEG 또는 PNG 이미지를 사용하는 것이 좋습니다. |
| 권장 종횡비 | 1.91:1(와이드) | 정사각형(1:1) 및 와이드(16:9) 형식도 허용되지만, 사용자의 기기에 따라 이미지가 잘리거나 확대될 수 있습니다. 캐러셀 카드의 경우, 헤더 이미지는 WhatsApp에 의해 자동으로 와이드 비율로 잘립니다. 단, 본문 텍스트가 없는 경우에는 정사각형으로 렌더링됩니다. |
비디오
다음 사양은 템플릿 헤더, 응답 미디어 메시지, 비디오 메시지 및 캐러셀 카드 헤더에 적용됩니다.
| 속성 | 사양 |
|---|---|
| 지원 형식 | MP4, 3GPP |
| 파일 크기 | 최대 16 MB |
| 비디오 코덱 | H.264만 지원 |
| 오디오 코덱 | AAC만 지원 |
| 오디오 스트림 | 단일 오디오 스트림 또는 오디오 스트림 없음 |
| 캡션(비디오 메시지만 해당) | 선택 사항; 최대 1,024자 |
| 권장 종횡비 | 1.91:1(와이드) |

Meta에는 특정 인코딩 또는 컨테이너 설정으로 인해 일부 MP4 동영상이 Android 기기에서 재생되지 않을 수 있는 알려진 문제가 있습니다. 영구적인 수정이 제공될 때까지, MP4 파일을 다시 포맷하면 대부분의 발송자에게 문제가 해결됩니다. 올바른 전달 가능성을 확인하려면 모든 동영상을 Android 기기에서 테스트하세요.
CloudConvert와 같은 웹 도구를 사용하여 MP4 파일을 다시 포맷할 수 있습니다. MP4 파일을 도구에 업로드하고 다시 MP4로 변환한 다음 변환된 파일을 다운로드하세요.
Android 호환성
B-프레임으로 인코딩된 H.264 “High” 프로필은 Android WhatsApp 클라이언트에서 지원되지 않습니다. 가장 폭넓은 호환성을 위해 B-프레임이 없는 H.264 “Main” 프로필 또는 “Baseline” 프로필을 사용하세요. ffmpeg로 다시 인코딩하는 경우 -movflags faststart 플래그를 사용하여 moov 박스를 mdat 박스 앞에 배치하세요.
오디오
다음 사양은 응답 미디어 메시지와 오디오 메시지에 적용되며, 오디오 유형(음성 메시지 또는 기본 오디오 메시지)에 따라 달라집니다.
음성 메시지
음성 메시지는 녹음된 음성 메모처럼 작동하며, 재생 컨트롤과 음성 텍스트 변환을 지원합니다.
| 속성정보 | 사양 |
|---|---|
| 필수 형식 | OGG만 지원 |
| 필수 코덱 | OPUS만 지원(모노 입력) |
| 파일 크기 | 최대 16 MB |
| 재생 아이콘 | 파일 크기가 512 KB 이하인 경우에만 이 아이콘이 표시되며, 더 큰 파일에는 다운로드 아이콘이 표시됩니다 |
| 음성 텍스트 변환 | 사용자가 WhatsApp 음성 텍스트 변환을 활성화한 경우 자동으로 표시됩니다 |
기본 오디오 메시지
다음 사양은 일반적인 오디오 파일 공유(음악 클립, 오디오 광고, 사운드 파일)에 적용됩니다.
| 형식 | 확장자 | 최대 파일 크기 | 참고 |
|---|---|---|---|
| AAC | .aac | 16 MB | |
| AMR | .amr | 16 MB | |
| MP3 | .mp3 | 16 MB | |
| MP4 Audio | .m4a | 16 MB | |
| OGG (OPUS 코덱) | .ogg | 16 MB | OGG 파일은 OPUS 코덱을 사용해야 합니다. OPUS가 없는 기본 audio/ogg는 지원되지 않습니다.기본 오디오 메시지로 전송된 OGG/OPUS 파일에는 음악 아이콘 대신 마이크 아이콘(음성 메시지와 동일)이 표시됩니다. |
고려 사항

- 오디오 메시지에는 캡션을 사용할 수 없습니다.
- 흔히 발생하는 오류는 MIME 유형 불일치입니다. 전송하기 전에 파일의 MIME 유형이 확장자와 일치하는지 확인하세요.
문서
다음 사양은 템플릿 헤더(문서 형식), 응답 미디어 메시지, 문서 메시지에 적용됩니다.
| 문서 유형 | 파일 유형 | 최대 파일 크기 |
|---|---|---|
| 100 MB | ||
| Microsoft Word | DOC, DOCX | 100 MB |
| Microsoft Excel | XLS, XLSX | 100 MB |
| Microsoft PowerPoint | PPT, PPTX | 100 MB |
| 일반 텍스트 | TXT | 100 MB |
고려 사항

- 캡션은 선택 사항이며 최대 1,024자까지 입력할 수 있습니다.
- 파일 이름은 선택 사항입니다. WhatsApp은 파일 확장자를 사용하여 대화에 표시할 문서 아이콘을 결정합니다.
- 공식적으로 지원되는 형식은 위에 나열된 형식뿐입니다. 다른 파일 유형도 전송될 수는 있지만 WhatsApp에서 올바르게 표시된다는 보장은 없습니다.
빠른 참조: WhatsApp 미디어 사양
| 미디어 유형 | 파일 유형 | 최대 파일 크기 | 캡션 사용 가능 여부 |
|---|---|---|---|
| 이미지 | JPEG, PNG | 5MB | 예(최대 1,024자) |
| 비디오 | MP4, 3GPP | 16MB | 예(최대 1,024자) |
| 오디오(음성) | OGG(OPUS) | 16MB | 아니요 |
| 오디오(기본) | AAC, AMR, MP3, M4A, OGG | 16MB | 아니요 |
| 문서 | PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT | 100MB | 예(최대 1,024자) |