도움말 센터

도움말 센터

작업 단위의 답변 —— 무엇을 어떤 순서로 설정하는지, 어떤 실패가 조용히 일어나는지. 플랫폼 동작의 근거는 가이드에서 한 층 더 깊게 다룹니다.

Whaleal Cart

Shopify 앱 설치, 복구 이메일 편집, 발송 시점 조정, 그리고 발동하지 않은 복구의 문제 해결.

Whaleal Cart 도움말 센터

설정 절차, 템플릿, 플랜, 문제 해결, 자주 묻는 질문을 한 페이지에 모았습니다.

Cart 도움말 센터 열기 →

시작하기

빈 계정에서 실제로 나간 메시지까지 — 그리고 맞는 요금제까지.

5 분

시작하기

제공업체를 연결하고, 키를 만들고, 첫 메시지를 보내보세요. 놓치면 조용히 비용이 새는 기본값 두 개도 함께 확인하세요.

이 문서 읽기 →
4 분

요금제, 할당량, 청구

각 요금제에 포함된 것, '채널'을 세는 방식, 그리고 SMS 요금이 우리 청구서에 절대 오르지 않는 이유.

이 문서 읽기 →

채널과 연결

자신의 제공업체 계정은 그대로 유지됩니다. 실제로 무엇을 뜻하는지와 여러 계정 간 경로 지정 방법.

5 분

자신의 제공업체 계정 연결하기

자체 계정 방식을 쓰면 계약, 발신 평판, 청구서가 CPaaS 제공업체에 남습니다. 연결 방법과 연결 뒤 달라지는 점을 설명합니다.

이 문서 읽기 →
3 분

발신 번호와 선택 방식

대부분 발신 주소를 지정하지 않으며 보통 그게 맞습니다. 언제 덮어써야 하는지 알려드립니다.

이 문서 읽기 →
5 분

우선순위와 가중치로 제공업체 간 경로 지정

키를 둘 이상의 제공업체에 바인딩하면 플랫폼이 라우팅 계층이 됩니다. 평소에는 부하를 나누고, 문제가 생기면 페일오버합니다.

이 문서 읽기 →
4 분

의지하기 전에 연결을 검증하세요

내장 확인은 입력한 필드만 검증합니다. 연결이 실제로 동작함을 증명하는 테스트는 따로 있습니다.

이 문서 읽기 →

API와 배송

프로그래밍 방식 발송, 키, 상태, 수신증, 속도 제한, 메시지 로그.

3 분

API 키 생성, 바인딩, 교체

키는 어느 테넌트가 호출했고 어느 채널을 쓸 수 있는지 증명합니다. 전체 값은 한 번만 보여지며, 바인딩이 없는 키는 아무것도 보낼 수 없습니다.

이 문서 읽기 →
6 분

API로 메시지 보내기

한 엔드포인트는 비동기로 수락합니다. 성공 코드는 플랫폼이 메시지를 인수했다는 뜻이지, 단말기가 받았다는 뜻은 아닙니다.

이 문서 읽기 →
4 분

각 메시지 상태의 의미

상태는 네 가지이고, 그중 하나는 나머지와 같은 묶음에 들어가면 안 됩니다. 「차단」을 실패로 읽으면 엉뚱한 곳을 찾게 됩니다.

이 문서 읽기 →
5 분

배송 수신증 받기

플랫폼은 직접 설정한 URL로 직접 만든 토큰을 실어 POST합니다. 이벤트를 잃을지 여부는 구현 세부사항 두 개가 가릅니다.

이 문서 읽기 →
4 분

속도 제한과 월간 사용량

카운터는 두 개이며 서로 같은 숫자가 아니고, 청구서처럼 보이는 쪽은 하나뿐입니다.

이 문서 읽기 →
4 분

로그에서 메시지 찾기

로그는 누구의 본문도 저장하지 않고 '이 메시지에 무슨 일이 있었나'에 답합니다.

이 문서 읽기 →
4 분

발송을 멈추지 않고 API 키 교체하기

발송이 끊기는 순간이 없도록 네 단계로 키를 교체하세요. 키가 유출됐다면 무엇부터 해야 하는지도 함께.

이 문서 읽기 →

대규모 발송

목록, 배치, 예약 발송 — 제공업체 한도를 지켜주는 속도 제어와 함께.

5 분

대량 발송과 예약 발송

목록에 한 번 보내거나 나중에 보내되, 제공업체 한도를 지켜주는 배치별 속도 제어를 적용하세요.

이 문서 읽기 →
3 분

연락처와 목록

메시지를 보낼 사람을 한곳에 모으고, 한 번에 가져오고, 중복 없이 묶어보세요.

이 문서 읽기 →
5 분

발송 비용 미리 계산하기

세그먼트 × 수신자 × 발신자 유형, 이게 공식의 전부입니다. 청구서가 오기 전에 계산하는 법.

이 문서 읽기 →

수신 거부와 데이터

수신자가 STOP이라고 답한 뒤 일어나는 일과, 플랫폼이 메시지에 대해 보관하는 것.

6 분

수신 거부와 차단

STOP, HELP, START는 서로 다른 세 갈래입니다. 수신증 엔드포인트만 설정하는 것이 전체 흐름을 조용히 망가뜨리는 실수입니다.

이 문서 읽기 →
3 분

무엇을 얼마나 오래 보관하는가

플랫폼은 메시지 본문이 아니라 메타데이터를 보관합니다. 여러분의 기록에 이것이 정확히 무엇을 뜻하는지 정리했습니다.

이 문서 읽기 →
4 분

수신자 관련 데이터 요청에 답하기

플랫폼이 메시지에 대해 갖는 것, 의도적으로 갖지 않는 것, 그리고 데이터 주체와의 관계가 실제로 어디에 있는지.

이 문서 읽기 →

문제 해결

모든 응답이 성공인데도 메시지가 도착하지 않는 경우 진단하기.

5 분

메시지가 수락되었지만 도착하지 않습니다

모든 호출이 성공을 반환합니다. 순서대로 따라가세요. 첫 네 가지 확인은 통신사와 전혀 무관합니다.

이 문서 읽기 →
5 분

오류 코드와 함께 실패하는 메시지

실패 상태에는 늘 이유가 함께 옵니다. 첫 질문은 어느 계층이 기록했는지, 플랫폼인지 제공업체인지입니다.

이 문서 읽기 →
3 분

수신자가 같은 메시지를 두 번 받았습니다

대부분 클라이언트 타임아웃 뒤 재전송입니다. 확인하는 방법과 다시 생기지 않게 하는 방법을 정리했습니다.

이 문서 읽기 →
5 분

제공업체가 트래픽 수신을 멈췄습니다

계정 수준 실패와 잘못된 경로를 구분하고, 페일오버가 흡수할 수 있는 것과 없는 것.

이 문서 읽기 →
범위. 여기 있는 대부분의 문서는 SMS 채널을 처음부터 끝까지 다룹니다. 이메일과 WhatsApp도 같은 방식으로 연결합니다 —— 자체 프로바이더 계정을 연결하고 콘솔에서 보냅니다. 프로바이더는 SMS가 6개, 이메일이 4개, WhatsApp이 3개입니다. 예약 발송과 대량 발송은 SMS 채널에서만 가능하며, 아직 목록에 없는 프로바이더는 연결로 제공되지 않고 콘솔에서 요청으로 등록됩니다.

해결되지 않을 때

메시지가 수락됐는데 어디로 갔는지 알 수 없다면 먼저 문제 해결 문서를 보세요 —— 통신 사업자에 문의하기 전에 계층별로 원인을 좁혀 줍니다.