연락처 — 전화번호·이메일주소·웹·SNS
상태: 공통 표준 — 2026-10-10 KST 사용자 결정
적용 대상: company-wide — 사람·조직·사업자의 전화번호, 이메일주소, 웹사이트, 메신저·SNS 주소와 담당자 묶음
정본 분류: 공통 규칙은 공통 입력 정보를 따릅니다. 이 쪽은 연락처 필드의 정본입니다.
전화번호
| 필드 | autocomplete (국내 형식 → 국제 형식) | 코드 / DB | 한국어 라벨 | 영어 라벨 |
|---|---|---|---|---|
| 전화번호 (종류 무관) | tel-national → tel | tel | 전화번호 | Phone number |
| 휴대전화번호 | mobile tel-national → mobile tel | mobileTel / mobile_tel | 휴대전화번호 | Mobile phone number |
| 자택전화번호 | home tel-national → home tel | homeTel / home_tel | 자택전화번호 | Home phone number |
| 직장전화번호 | work tel-national → work tel | workTel / work_tel | 직장전화번호 | Work phone number |
| 팩스번호 | fax tel-national → fax tel | faxTel / fax_tel | 팩스번호 | Fax number |
| 내선번호 | work tel-extension | workTelExtension / work_tel_extension | 내선번호 | Extension number |
| 대표전화번호 (조직) | 항상 off | mainTel / main_tel | 대표전화번호 | Main phone number |
- 연락처 종류는 앞에 붙는 말입니다.
home·work·mobile·fax·pager는 혼자 쓰는 필드가 아니라tel·email앞에 붙습니다. 그래서 팩스번호는fax tel이고 이름은faxTel입니다. - 「전화번호」는 종류를 가리지 않습니다. 휴대전화·유선전화·인터넷전화(070)를 모두 받습니다.
- 「휴대전화번호」는 휴대전화만 받습니다. 본인인증과 문자 수신에 쓰는 번호입니다.
- 휴대전화번호만 받는다는 제한은 필요하면 라벨 옆 ⓘ로 알립니다.
- 같은 번호를
tel과mobileTel에 함께 둘 수 있습니다.
- 유선전화만 받는 칸이 꼭 필요하면 제품이 정합니다. 070을 받는다면 그 칸을 「유선전화」라고 부르지 않습니다.
- 대표전화번호는 항상
autocomplete="off"입니다. 표준에 조직 대표번호 토큰이 없습니다.work tel을 쓰면 입력하는 사람의 직장 번호가 채워질 수 있습니다. 실제로 사람의 직장 번호라면 필드가workTel입니다.
기본 필드와 선택 필드
| 구분 | 필드 | 화면 |
|---|---|---|
| 기본 | 휴대전화번호(mobileTel) · 전화번호(tel) · 이메일주소(email) | 입력·상세 화면에 처음부터 둡니다 |
| 선택 | 자택전화번호(homeTel) · 직장전화번호(workTel) · 팩스번호(faxTel) · 대표전화번호(mainTel) · 내선번호(workTelExtension) · 직장이메일주소(workEmail) | 기본 화면에 두지 않습니다. 사용자가 [추가]를 눌러야 칸이 생기고, 값이 있는 칸만 보입니다 |
- 「일반전화」라고 부르던 칸은 「전화번호」(
tel)입니다(사용자 결정 2026-10-10 KST). - 조직·사업자도 기본 연락 번호는 「전화번호」(
tel)입니다. 대표번호를 따로 구분해야 할 때만 「대표전화번호」를 추가합니다.
저장과 표시
- 저장은 국제 표준 형식(E.164, 예:
+821012345678)입니다. 표준tel(국가번호 포함 전체 번호)과 같은 뜻입니다. - 나라가 정해진 화면은 국내 형식 한 칸(
tel-national)으로 받습니다. 저장할 때는 그 번호가 속한 나라를 기준으로 E.164로 바꿉니다. 주소의 나라를 그대로 가정하거나 앞자리 0을 일괄로 지우지 않습니다. - 글로벌 화면은 국제 형식 한 칸(
tel)을 받거나, 국가번호(tel-country-code)와 번호(tel-national)로 나눠 받습니다. - 표시는 국내 번호면
010-1234-5678, 국제 표기면+82 10-1234-5678입니다. - 내선번호는 E.164에 넣지 않고 따로 둡니다.
이메일·웹·메신저·SNS
| 필드 | autocomplete | 코드 / DB | 한국어 라벨 | 영어 라벨 |
|---|---|---|---|---|
| 이메일주소 | email | email | 이메일주소 | Email address |
| 직장이메일주소 | work email | workEmail / work_email | 직장이메일주소 | Work email address |
| 웹사이트주소 | url | url | 웹사이트주소 | Website URL |
| 메신저주소 | impp | impp | 메신저주소 | Messaging address |
| SNS 프로필 | — | socialProfiles (목록: service·url) | SNS | Social profile |
- 이메일주소는 입력 그대로 저장합니다(앞뒤 공백만 제거). 같은 주소인지 비교할 때 도메인(
@뒤)만 대소문자를 무시하고@앞은 그대로 비교합니다. 메일 표준(RFC 5321)은@앞의 대소문자를 구분할 수 있기 때문입니다. impp는 메신저·프레즌스 접속 주소(URI)에만 씁니다. SNS 프로필 주소를impp에 넣지 않습니다.- SNS 프로필은 vCard
SOCIALPROFILE(RFC 9554)과 같은 개념입니다. 목록으로 둡니다.
확인
- 휴대전화번호와 이메일주소의 확인은 공통 입력 정보의 「확인 기록」을 따릅니다.
- 기록은
mobileTelVerifiedAt·mobileTelVerifiedBy,emailVerifiedAt·emailVerifiedBy입니다. - 값이 바뀌면 확인을 해제합니다.
- 기록은
담당자 묶음
담당자는 사람 한 명의 연락 정보 묶음입니다. 정본은 목록 contacts입니다.
| 필드 | 코드 / DB | 한국어 라벨 | 영어 라벨 |
|---|---|---|---|
| 담당 구분 | contactType / contact_type | 담당 구분: 주담당(primary) · 부담당(secondary) · 청구(billing) 등 | Contact type |
| 순서 | priority | 순서 | Priority |
| 이름 | name | 이름 | Full name |
| 부서 | departmentName / department_name | 부서 | Department |
| 직함 | organizationTitle / organization_title | 직함 | Job title |
| 휴대전화번호 | mobileTel / mobile_tel | 휴대전화번호 | Mobile phone number |
| 전화번호 | tel | 전화번호 | Phone number |
| 팩스번호 | faxTel / fax_tel | 팩스번호 | Fax number |
| 이메일주소 | email | 이메일주소 | Email address |
| 비고 | note | 비고 | Note |
- 담당 구분은 schema.org
ContactPoint의contactType과 같은 개념입니다. 「역할」이라고 부르지 않습니다. 「역할」은 접근 역할 체계의 접근 역할에만 씁니다. - 주담당·부담당처럼 구분이 정해진 담당자 한두 명만 두는 화면은 API에서 중첩 객체로 냅니다(예:
primaryContact: { name, departmentName, mobileTel, tel, faxTel, email, note },secondaryContact: { … }). - 담당자는 사람 당사자를 가리키지 않아도 됩니다. 사람 레코드가 있으면
partyId를 함께 둡니다.