사용자 가이드
메시지·변수 가이드
고객마다 다른 내용을 자동으로 채우는 [변수], AI가 문구를 제안하는 {지시문}, 그리고 카카오 발송 규정을 정리했어요.
[대괄호] — 고객 데이터로 바뀌는 변수
본문에 [고객명]처럼 쓰면 보낼 때 각 고객의 실제 값으로 바뀌어요. 쓸 수 있는 변수는 다음과 같고, 값이 비어있는 고객에게는 대체값이 대신 나가요 (발송에서 빠지지 않아요):
| 변수 | 무엇으로 바뀌나 | 예시 | 값이 없으면 |
|---|---|---|---|
[고객명] | 고객 이름. 비어있으면 대체값으로 발송됩니다. | 김민준 | “고객님” |
[픽업일] | 마지막 픽업 완료일 (재구매 기준일). | 5월 10일 | “지난번” |
[상품군] | 조건 빌더에서 선택한 상품군 이름. | 심장사상충 예방약 | “구매하신 상품” |
[약국명] | 마지막 픽업이 일어난 약국. | 행복약국 강남점 | “가까운 약국” |
[경과일] | 픽업 후 경과 일수 — 발송일 기준 계산값. | 32 | “여러” |
이 표는 콘솔 변수 칩과 같은 목록에서 자동으로 나와요 — 변수가 추가되면 문서도 같이 갱신됩니다. 메시지 빌더에서 변수 칩의 ⓘ를 누르면 어느 데이터 컬럼에서 오는지도 볼 수 있어요.
{중괄호} — AI 문구 블록
문구가 떠오르지 않을 때 {재구매를 부드럽게 권하는 한 문장}처럼 지시문을 쓰면, 빌더가 후보 3개를 만들어 줘요. 흐름은:
- 본문에 {지시문}을 쓴다
- 아래 AI 패널에서 후보 생성을 누른다
- 마음에 드는 후보를 고르면 그 문구로 확정된다
중요: 발송 시점에 AI가 임의로 문구를 만드는 일은 없어요. 작성 단계에서 당신이 고른 문구 그대로만 나갑니다. {}가 확정되지 않은 채 남아있으면 저장 자체가 막혀요.
{{이중 중괄호}} — 값을 가공하는 고급 개인화 (Liquid)
단순 치환을 넘어 값을 가공하고 싶을 때 Liquid 문법을 써요. 변수 뒤에 |로 필터를 붙이고, 필터는 여러 개 이어 쓸 수 있어요.
| 필터 | 예시 | 결과 |
|---|---|---|
default | {{ 고객명 | default: '고객' }} | 값 없으면 “고객” |
number_with_delimiter | {{ 적립금 | number_with_delimiter }} | 5000 → 5,000 |
date | {{ 픽업일 | date: '%m월 %d일' }} | 05월 10일 |
truncate | {{ 상품군 | truncate: 5 }} | 긴 텍스트 자르기 |
[ ]와 {{ }}의 차이:
[고객명]은 그대로 값을 넣는 간단 치환, {{ 고객명 | ... }}은 값을 가공해요. 둘 다 같은 고객 데이터를 보고, 함께 써도 됩니다. 메시지 빌더 오른쪽 미리보기에서 결과를 바로 확인하세요.말풍선 유형 — 어떤 모양으로 보낼까
| 유형 | 언제 쓰나 | 제한 |
|---|---|---|
| 텍스트 | 글만 길게 — 가장 기본 | 1,300자 |
| 이미지 | 사진 1장 + 글 — 가장 많이 써요 | 720×720 권장 |
| 와이드 이미지 | 큰 사진으로 시선 끌기 | 글 76자 |
| 와이드 리스트 | 소식 3~4개를 한 번에 | 카드 3~4장 |
| 캐러셀 | 넘겨 보는 카드 | 2~6장, 같은 비율 |
| 상품/상품 캐러셀 | 가격·할인 표시 | 글 34자 |
| 동영상 | 카카오TV 영상 | 사전 업로드 필요 |
고객이 받는 모습
발송 규정 (자동으로 지켜져요)
- (광고) 표기 + 무료수신거부 080 — 브랜드 메시지에 자동 부착
- 발송창 08:00~20:50 — 밤에는 예약해도 나가지 않아요 (카카오 규정·법적 하한)
- 동의 명확한 고객만 — 거부·불명확·차단은 자동 제외 (사유 집계)
- 24시간 중복 제한 — 같은 고객에게 하루 두 번 가지 않아요
방해금지 시간대·발송 빈도 제한 (내가 조절)
고객이 메시지에 피로감을 느끼지 않도록, 운영 → 설정 → 발송 빈도·시간 정책에서 직접 조절할 수 있어요. 알림톡·브랜드 모든 채널에 적용돼요.
- 방해금지 시간대 — 예: 21:00~08:00에는 보내지 않음 (자정 넘김 처리)
- 발송 빈도 제한 — 고객 1명당 하루·주 최대 건수 (0 = 무제한)
- 지금 보낼 수 있나 — 알림톡·브랜드 각각 현재 발송 가능 여부 표시
발송창(08:00~20:50)은 법적 하한이라 고정이고, 방해금지·빈도 제한은 그 위에 추가로 적용돼요. 위 규칙들은 운영 → 시스템 흐름의 “카카오 발송” 칸에서 실제 검사 목록으로 확인할 수 있어요.