CRMAI Docs스토리
Stories를 사용하면 CRMAI 대시보드에서 짧은 상태 업데이트(텍스트 또는 이미지)를 만들어 활성화된 채널 연결로 바로 게시할 수 있으며, 게시 상태도 한 페이지에서 확인할 수 있습니다.
사전 준비 사항
기능 접근 권한: Stories를 사용하려면 워크스페이스에 해당 기능 접근 권한이 있어야 합니다. 페이지에 기능 잠금 안내가 표시된다면, 워크스페이스 관리자에게 문의하거나 Billing에서 요금제와 기능 한도를 확인하세요.
활성화된 연결: Story를 만들기 전에 최소 하나의 채널 연결이 활성화되어 있어야 합니다. 사용 가능한 연결은 채널 선택 항목에 표시됩니다.
접속 경로
CRMAI에 로그인해 올바른 워크스페이스를 선택합니다.
사이드바의 Messages 메뉴를 열고 → Stories를 선택합니다.
페이지 주소: /{locale}/dashboard/stories
[SCREENSHOT PLACEHOLDER: Story 만들기 버튼, 상태 필터, 채널 필터, 그리드 보기가 있는 Stories 페이지] 권장 파일명: stories-overview.png
Stories 페이지 기능
기능 | 설명 |
|---|---|
Story 만들기 | 새 Story를 만들고 게시하는 양식을 엽니다. |
새로고침 | 최신 Story 목록을 다시 불러옵니다. |
상태 필터 | 게시 상태 기준으로 Story를 필터링합니다. |
채널 필터 | 특정 연결에서 발행된 Story만 필터링합니다. |
그리드/테이블 보기 | 세로형 미리보기 카드와 간결한 테이블 보기를 전환합니다. |
페이지네이션 | 표시 중인 목록보다 Story 개수가 많을 때 페이지를 이동합니다. |
Story 카드나 행을 클릭하면 Story 상세정보가 열립니다.
Story 만들기
Story 만들기를 클릭합니다.
채널 선택 — 워크스페이스에서 사용 가능한 WhatsApp, Telegram 또는 다른 연결을 선택합니다. 기본 연결이 있으면 자동으로 선택됩니다. 여기에는 Connections 페이지에서 이미 설정된 연결만 표시됩니다.
수신 대상을 선택합니다:
옵션
동작
전체 연락처(공개 상태)
기본값 — 해당 채널의 조건을 충족하는 모든 연락처에게 Story가 전달됩니다.
특정 연락처 선택
선택한 연락처에게만 Story가 전달됩니다. 연락처 타겟팅을 지원하는 WhatsApp 연결에서 사용 가능합니다.
선택한 연락처 제외 전체
선택한 연락처를 제외한, 조건을 충족하는 모든 연락처에게 Story가 전달됩니다. 연락처 타겟팅을 지원하는 WhatsApp 연결에서 사용 가능합니다.
연락처 기반 모드에서는 이름/번호로 검색해 필요한 연락처를 체크하고, 필요하면 전체 선택/선택 해제를 사용합니다. 최소 하나 이상의 연락처가 선택되어 있는지 확인하세요. 그룹 연락처와 유효한 식별자가 없는 신원 정보는 수신 대상으로 표시되지 않습니다. 선택한 연결이 연락처 타겟팅을 지원하지 않으면, 연락처 기반 옵션 두 가지가 자동으로 비활성화되고 대상은 전체 연락처로 되돌아갑니다.
콘텐츠 형식을 선택합니다:
텍스트 Story — 텍스트 Story 내용 필드에 입력합니다. 최대 4,096자까지 가능하며 비워둘 수 없습니다.
이미지 Story — JPEG/JPG 파일을 최대 8MB까지 업로드합니다. 이미지 캡션은 선택 사항이며 최대 2,200자까지 입력할 수 있습니다.
Telegram과 Instagram은 이미지 형식만 지원하므로, 두 채널 모두 텍스트 Story 옵션은 사용할 수 없습니다. JPEG/JPG가 아니거나 8MB를 초과하는 파일은 게시 전에 거부됩니다.
Telegram 전용 — Story 게시 기간을 설정합니다: 6시간 / 12시간 / 24시간(기본값) / 48시간. 이 설정은 Telegram 연결에서만 표시되며, 만료 시간은 Story 생성 후 상세정보에서도 확인할 수 있습니다.
Story 미리보기에서 결과를 확인한 뒤 Story 게시를 클릭합니다.
"Story가 접수되어 처리 중입니다"라는 알림은 요청이 대기열에 들어갔다는 뜻일 뿐, 아직 실제로 게시된 것은 아닙니다. 상태가 게시됨으로 바뀔 때까지 기다리세요.
[SCREENSHOT PLACEHOLDER: 채널 선택, 수신 대상, 콘텐츠 형식, Story 게시 버튼을 보여주는 Story 만들기 양식] 권장 파일명: stories-create-form.png
Story 상태
상태 | 의미 |
|---|---|
대기 중 | 생성되었지만 아직 처리가 시작되지 않은 상태입니다. |
처리 중 | 채널에서 발송/처리 중인 상태입니다. |
게시됨 | 게시가 성공적으로 완료된 상태입니다. |
활성 | 이 상태를 지원하는 채널에서 여전히 활성 상태입니다. |
실패 | 게시에 실패한 상태입니다 — Story 상세정보에서 오류 코드를 확인하세요. |
취소됨 | 처리가 취소된 상태입니다. |
삭제됨 | 삭제 작업을 통해 제거된 상태입니다. |
알 수 없음 | 채널의 응답으로부터 상태를 판단할 수 없는 상태입니다. |
Story 상세정보 및 삭제
Story 카드나 행을 클릭하면 Story 상세정보가 열리며, 다음 내용을 확인할 수 있습니다: 세로형 미리보기, 상태, Story ID(복사 가능), 채널 연결, 수신 대상, 게시/생성 시간, 만료 시간, 콘텐츠 형식, (실패한 경우) 오류 코드. 이미지 Story의 경우 미리보기 아래에 캡션이 표시됩니다. 텍스트 Story의 경우 미리보기 배경에 텍스트 내용이 표시됩니다.
삭제하려면: 카드의 삭제 작업을 사용하거나 상세정보 대화상자에서 Story 삭제를 클릭한 뒤 확인합니다. 삭제는 영구적입니다 — 확인하기 전에 ID나 내용이 맞는지 반드시 다시 확인하세요.
[SCREENSHOT PLACEHOLDER: 상태, 수신 대상, 게시 시간, 만료 시간을 보여주는 Story 상세정보 대화상자] 권장 파일명: stories-detail.png
문제 해결
문제 | 해결 방법 |
|---|---|
채널 선택에 연결이 표시되지 않음 | 선택한 워크스페이스에 대해 Connections 페이지에서 연결이 생성·활성화되어 있는지 확인한 뒤 새로고침을 클릭하세요. |
Stories 버튼/페이지가 잠겨 있음 | 접근 권한은 워크스페이스의 Broadcast 기능 capability로 제어됩니다 — 요금제, 한도, 설정을 관리자에게 확인해 달라고 요청하세요. |
이미지 파일이 거부됨 | 파일이 실제 JPEG/JPG 형식인지(단순히 확장자만 바꾼 것이 아닌지), 크기가 8MB 이하인지 확인하세요. |
오래된 Story가 처리 중 상태에 멈춰 있음 | 게시는 비동기로 처리됩니다 — 잠시 기다린 뒤 새로고침을 클릭하세요. Story 상세정보에서 오류 코드를 확인하세요. 그래도 바뀌지 않는다면, 고객지원에 문의하기 전에 Story ID, 연결, 생성 시간, 마지막 상태를 기록해 두세요. |
게시 실패 | 연결이 여전히 활성 상태인지 확인하고, 콘텐츠 형식과 수신 대상을 다시 점검한 뒤 Story 상세정보에서 오류 코드를 기록하세요. 원인을 파악하기 전에 바로 재전송하면 Story가 중복 생성될 수 있으니 피하세요. |
연락처 타겟팅을 선택할 수 없음 | 연락처 타겟팅은 이를 지원하는 WhatsApp 연결에서만 사용할 수 있습니다 — 전체 연락처를 사용하거나 지원되는 WhatsApp 연결로 전환하세요. |
권장 사용법
게시하기 전에 이미지와 캡션에 대한 승인을 받아두세요.
Story가 잘못된 계정에서 발송되지 않도록 채널 연결을 다시 확인하세요.
커뮤니케이션 목적에 맞게 수신 대상을 설정하세요.
상태가 게시됨이 될 때까지 지켜보세요.
기술 지원이 필요할 때를 대비해 Story ID와 오류 코드를 잘 보관해두세요.
개인정보, 토큰, 비밀번호, 불필요한 고객 정보를 Story 콘텐츠에 포함하지 마세요.
빠른 체크리스트
Messages → Stories → Story 만들기.
채널 연결과 수신 대상을 선택합니다.
텍스트 Story(4,096자 이내) 또는 이미지 Story(JPEG/JPG, 8MB 이내, 캡션 2,200자 이내)를 선택합니다.
Telegram 전용: 게시 기간을 설정합니다.
Story 게시를 클릭한 뒤, 상태가 게시됨이 될 때까지 확인합니다.
선택한 Story가 맞는지 확인한 뒤에만 삭제합니다.