추적
메시지 상태 및 전송 결과
| status | 의미 | 최종 | 청구됨 |
|---|---|---|---|
| scheduled | send_at 시간을 기다리는 중이에요. | No | 예, 취소하면 환불돼요 |
| queued | 수락되었으며 다음 큐 패스(2초마다)를 기다리는 중이에요. | No | Yes |
| sent | 네트워크로 전달됐어요. 전송 결과를 기다리는 중이에요. | No | Yes |
| delivered | 휴대폰에서 전송 확인을 했어요. | Yes | Yes |
| failed | 전송할 수 없어요; 오류 메시지에 이유가 나와요. | Yes | 아니요, 환불되었어요 |
| canceled | 예약된 배치가 취소되었어요. | Yes | 아니요, 환불되었어요 |
메시지 오류 코드
| error.code | 의미 |
|---|---|
| network_error | 메시지를 네트워크로 전달할 수 없었어요. 해당 금액이 잔액으로 환불되었어요. |
| undeliverable | 통신망에서 단말기에 연결할 수 없다고 보고했어요. |
| canceled | 예약된 배치가 시작되기 전에 취소되었어요. |
환불
메시지가 실패하면, 전체 금액이 동일한 과정에서 잔액으로 돌아가요. 이는 원장에 배치 이름이 적힌 환불 항목으로 기록돼요. 배치 필드 refunded는 누적 총액을 보여줘요.
웹훅 또는 폴링
웹훅은 빠른 경로예요: 각 최종 상태가 설정되면 엔드포인트를 한 번 호출해요. 소량의 경우나 다시 확인하려면 GET /v1/messages/{id}나 GET /v1/batches/{id}를 폴링하세요. 요청 한도는 둘 다 사용할 수 있도록 여유를 두고 있어요.