발송
전화번호 및 국가 감지
전화번호를 E.164 형식으로 작성해요: 플러스 기호, 국가 코드, 그리고 국내 번호(지역 번호 제외)를 포함해요. 총 7~15자리 숫자로 구성돼요. +14155550123, +447400123456, +4915123456789 모두 E.164 형식이에요.
번호 정제
- 공백, 점, 대시, 슬래시, 괄호는 제거돼요:
+44 (0)7400-123 456는 (0) 때문에 유효하지 않지만,+44 7400-123 456는 유효해요. - 앞에 있는
00은+로 바뀌어요:004915123456789는+4915123456789로 읽혀요. - 숫자 앞에 플러스가 없으면 국제 번호로 인식해요:
14155550123은+14155550123이 돼요. 전화번호는 국가 코드와 함께 저장하세요. - 아직 +로 시작하지 않고 7~15자리 숫자가 아닌 번호는
invalid_number로 분류돼요. - 하나의 요청에서 같은 번호가 두 번 있으면 한 번만 보내져요. 두 번째 복사본은
duplicate로 따로 설정돼요.
국가 감지
각 번호는 해당 국가에 따라 가격이 책정되며, 가장 긴 일치하는 국가 코드를 기준으로 판단해요. 일부 국가 코드는 공유되며, API는 접두사를 통해 해당 국가를 구분해요.
| 국가 코드 | 분할 방식 |
|---|---|
| +1 | 지역 코드별로 가격이 달라요. 캐나다 코드는 캐나다로 가격이 책정되고, 카리브해 코드(도미니카 공화국의 809, 829, 849, 자메이카의 876과 658, 푸에르토리코의 787과 939 등)는 각 섬으로 가격이 책정돼요. 그 외의 모든 +1 번호는 미국으로 가격이 책정돼요. |
| +44 | 건지 (7781, 7839, 7911), 저지 (7509, 7700, 7797, 7829, 7937), 맨 섬 (7524, 7624, 7924)의 모바일 접두사는 해당 섬의 가격으로 책정돼요. 나머지는 영국 가격으로 적용돼요. |
| +7 | +7 6과 +7 7은 카자흐스탄 가격으로, 나머지는 러시아 가격으로 적용돼요. |
| +262 | +262 639와 +262 269는 마요트 요금으로 적용되고, 나머지는 레위니옹 요금으로 적용돼요. |
| +39 | 이탈리아(바티칸 시국 포함). |
매칭된 국가는 각 메시지의 country 필드에 있어요. 그래서 번호가 어떻게 가격이 책정되었는지 확인할 수 있어요.