콘텐츠로 건너뛰기

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(와이드)

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 유형이 확장자와 일치하는지 확인하세요.

문서

다음 사양은 템플릿 헤더(문서 형식), 응답 미디어 메시지, 문서 메시지에 적용됩니다.

문서 유형 파일 유형 최대 파일 크기
PDF PDF 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자)
New Stuff!