> For the complete documentation index, see [llms.txt](https://docs.smply.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smply.one/member/invite.md).

# 추가 사용자를 초대하기

## 구성원 추가 및 초대

관리자는 **구성원** 페이지에서 새 구성원을 추가하고 초대 이메일을 보낼 수 있습니다. 추가된 구성원은 이메일로 받은 가입 링크를 눌러 비밀번호를 설정하면 가입이 완료됩니다. 한 명씩 추가하거나, 파일로 여러 명을 한 번에 등록할 수 있습니다.

***

### 1. 구성원 추가하기

**단계 1: 추가 화면 열기**

1. 좌측 메뉴에서 **구성원**으로 이동합니다.
2. 우측 상단의 **`구성원 추가하기`** 버튼을 클릭합니다.

{% hint style="info" %}
**Google Workspace를 연동한 경우 — 추가 방법을 먼저 선택합니다** 회사에 Google Workspace 연동이 있으면 버튼을 누를 때 *"구성원 추가 방법 선택"* 창이 먼저 뜹니다.

* **`Google Workspace 계정으로 추가`** — 연동된 Google Workspace에 계정을 만들고 동시에 구성원으로 추가합니다.
* **`직접 추가`** — 이메일과 이름을 직접 입력해 추가합니다(아래 단계 2).

Google Workspace 연동이 없으면 이 선택 창 없이 바로 직접 추가 화면이 열립니다.
{% endhint %}

**단계 2: 정보 입력 (직접 추가)**

추가 창에서 다음 항목을 입력합니다.

| 필드      | 설명                                                                                      | 필수         |
| ------- | --------------------------------------------------------------------------------------- | ---------- |
| **이메일** | 로컬 부분(예: `hong`)만 입력하고, 회사 도메인은 우측에서 지정합니다                                              | 필수         |
| **이름**  | 구성원의 이름                                                                                 | 필수         |
| **사번**  | 회사의 사원 번호(예: `20240115`). 결제 내역을 구성원에게 자동으로 귀속하고 인사데이터와 잇는 데 쓰입니다. 같은 회사 안에서 중복될 수 없습니다 | 선택         |
| **역할**  | 관리자 / 일반 또는 회사가 만든 커스텀 역할                                                               | 선택(기본: 일반) |

이메일 도메인은 회사에 등록된 도메인에 따라 다음 중 하나로 표시됩니다.

* 등록된 도메인이 **하나**면 `@회사도메인`이 고정 표시되고, 앞부분만 입력합니다.
* 등록된 도메인이 **여러 개**면 우측 드롭다운에서 도메인을 선택합니다.
* 회사 설정에서 **임의 도메인 허용**이 켜져 있으면 도메인도 직접 입력합니다.

{% hint style="info" %}
**역할 선택 기준**

* **관리자**: 모든 기능에 접근할 수 있습니다.
* **일반**: 본인에게 허용된 데이터만 조회합니다.
* 회사가 만든 커스텀 역할이 있으면 함께 선택할 수 있습니다.
  {% endhint %}

**단계 3: 초대 메일 여부 선택 후 추가**

1. 지금 바로 초대하려면 **초대 메일 보내기**에 체크합니다.
2. **`구성원 추가하기`**(또는 추가) 버튼을 누릅니다.

| 초대 메일 보내기 | 결과                    | 상태  |
| --------- | --------------------- | --- |
| 체크함       | 구성원 추가와 동시에 초대 이메일 발송 | 초대됨 |
| 체크 안 함    | 구성원만 추가, 초대는 나중에      | 추가됨 |

{% hint style="info" %}
**나중에 초대하기** 체크하지 않고 추가한 구성원(상태: 추가됨)은 나중에 목록에서 초대할 수 있습니다. 해당 행의 메뉴 더보기(⋮)에서 \*\*`초대 전송`\*\*을 누르면 됩니다.
{% endhint %}

***

### 2. 여러 구성원 한 번에 등록하기

파일을 올려 여러 구성원을 한 번에 추가합니다. 정해진 양식이 따로 없어도 되며, 올린 파일의 열을 SMPLY 항목에 맞춰 연결하는 방식입니다.

**단계 1: 일괄 등록 화면 열기**

1. **구성원** 페이지에서 우측 상단 **`구성원 추가하기`** 버튼 오른쪽의 펼침(▾)을 누릅니다.
2. \*\*`구성원 일괄 등록하기`\*\*를 선택합니다.

**단계 2: 파일 올리기**

이름·이메일 등이 정리된 Excel/CSV 파일을 선택해 올립니다. 첫 행에 항목 이름(헤더)이 있으면 다음 단계에서 자동으로 인식합니다.

**단계 3: 열 연결(매핑)**

올린 파일의 각 열을 SMPLY의 항목에 연결합니다. 시스템이 헤더를 보고 자동으로 추천하며, 다르면 직접 바꿉니다.

| 항목      | 설명         | 필수 |
| ------- | ---------- | -- |
| **이름**  | 구성원 이름     | 필수 |
| **이메일** | 구성원 이메일 주소 | 필수 |
| **부서**  | 소속 부서(조직)명 | 선택 |
| **그룹**  | 소속 그룹명     | 선택 |

{% hint style="info" %}
**일괄 등록에 들어가는 항목은 위 네 가지입니다** 역할·전화번호 같은 항목은 일괄 등록 대상이 아닙니다. 역할은 등록 후 목록에서 개별로 지정합니다.
{% endhint %}

**단계 4: 미리보기로 확인**

연결을 마치면 시스템이 데이터를 검증해 미리보기를 보여줍니다. 잘못된 행이 있으면 해당 위치에 오류가 표시됩니다. 매핑으로 돌아가 수정한 뒤 다시 확인할 수 있습니다.

**단계 5: 등록**

미리보기에 문제가 없으면 등록을 확정합니다. 등록된 구성원은 일단 **추가됨** 상태로 들어갑니다.

{% hint style="info" %}
**등록 후 초대 보내기** 일괄 등록한 구성원에게 초대 메일을 보내려면 목록에서 해당 구성원들을 선택한 뒤, 선택 항목 도구 모음의 **초대 전송**으로 한 번에 보냅니다(아래 4. 초대 상태 관리).
{% endhint %}

***

### 3. 초대 이메일과 가입 절차

#### 구성원이 받는 이메일

초대된 구성원은 회사명과 가입 버튼이 담긴 이메일을 받습니다. 버튼을 누르면 가입 페이지로 이동합니다.

#### 가입 절차

1. **이메일 확인**: 받은 초대 이메일을 엽니다.
2. **링크 클릭**: 가입 버튼을 누릅니다.
3. **비밀번호 설정**: 가입 페이지에서 비밀번호를 설정합니다.
4. **가입 완료**: 가입이 끝나면 구성원 상태가 **활성**으로 바뀝니다.

{% hint style="warning" %}
**초대받은 이메일로만 가입할 수 있습니다** 가입 시 반드시 초대받은 이메일 주소를 사용해야 합니다. 다른 이메일로는 가입할 수 없습니다.
{% endhint %}

{% hint style="info" %}
**가입을 완료하면 링크는 더 이상 동작하지 않습니다** 한 번 가입(수락)이 끝난 초대 링크는 만료 처리되어 다시 쓸 수 없습니다. 가입이 끝나지 않은 초대는 목록에서 언제든 다시 보낼 수 있습니다.
{% endhint %}

***

### 4. 초대 상태 관리

#### 구성원 상태

추가·초대 이후 구성원은 다음 상태 중 하나를 가집니다.

| 상태       | 의미                       | 다음 단계             |
| -------- | ------------------------ | ----------------- |
| **추가됨**  | 추가만 되고 초대 메일은 아직 안 보낸 상태 | 초대 전송             |
| **초대됨**  | 초대 메일 발송 완료, 가입 대기 중     | 구성원이 가입하면 활성으로 변경 |
| **활성**   | 가입 완료, 정상 사용 가능          | -                 |
| **비활성화** | 사용 중지된 구성원               | 필요 시 재활성화         |

#### 초대 보내기 / 다시 보내기

추가됨·초대됨 상태의 구성원에게 초대 메일을 보내거나 다시 보낼 수 있습니다. 첫 발송과 재발송 모두 같은 **초대 전송** 동작을 씁니다.

* **한 명씩**: 해당 구성원 행의 메뉴 더보기(⋮)에서 \*\*`초대 전송`\*\*을 누릅니다.
* **여러 명**: 목록에서 추가됨·초대됨 구성원을 선택한 뒤, 선택 항목 도구 모음에서 **초대 전송**을 누르고 *"초대 이메일 전송"* 확인 창에서 \*\*`전송하기`\*\*를 누릅니다.

{% hint style="info" %}
**재발송 횟수 제한 없음** 초대 이메일은 필요한 만큼 여러 번 보낼 수 있습니다. **초대 전송**은 추가됨·초대됨 행에만 보이며, 이미 가입한(활성) 구성원 행에는 나타나지 않습니다.
{% endhint %}

#### 보기 전환 (선택)

목록 상단의 토글로 **전체 / 부서별 / 그룹별** 보기를 전환할 수 있습니다. 초대 후 부서·그룹 단위로 구성원을 확인할 때 사용합니다.

***

### 5. 문제 해결

#### Q: 초대 이메일이 안 왔다고 해요

**1단계: 스팸 폴더 확인**

* Gmail: "스팸" 또는 "프로모션" 탭 확인
* Outlook: "정크 메일" 폴더 확인
* 네이버 메일: "스팸함" 확인

**2단계: 이메일 주소 확인**

1. **구성원** 목록에서 해당 구성원을 클릭합니다.
2. 이메일 주소가 정확한지 확인합니다.
3. 오타가 있으면 수정하고 다시 보냅니다.

**3단계: 회사 메일 서버 차단 확인**

* 회사 IT 부서에 SMPLY 발송 도메인 차단 여부를 확인 요청하세요.
* 차단 해제 대상 도메인: `@sherpas.team`, `@smply.one`

**4단계: 다시 보내기**

1. 위 사항을 확인한 뒤 해당 구성원 행의 메뉴 더보기(⋮)에서 \*\*`초대 전송`\*\*을 누릅니다.
2. 여전히 문제가 있으면 채널톡으로 문의해 주세요.

#### Q: "이미 사용 중인 이메일입니다" 안내가 나와요

**원인**: 해당 이메일로 이미 구성원이 등록되어 있습니다.

**해결 방법**:

1. **구성원** 목록에서 해당 이메일을 검색합니다.
2. 비활성화된 구성원일 수 있으니, **`구성원 추가하기`** 옆 펼침(▾)의 \*\*`비활성화된 구성원 관리하기`\*\*에서 확인합니다.
3. 이미 등록된 구성원이 있다면:
   * **재활성화**: 비활성 구성원을 재활성화합니다.
   * **다른 이메일 사용**: 새 구성원은 다른 이메일로 추가합니다.

#### Q: "허용되지 않은 도메인입니다" 안내가 나와요

**원인**: 회사에 등록된 도메인이 아닌 이메일로 추가하려고 했습니다.

**허용 도메인 확인**:

1. **설정** > **회사 설정**으로 이동합니다.
2. **도메인** 항목에서 등록된 도메인 목록을 확인합니다.

**해결 방법**:

* 회사 도메인의 이메일을 사용하세요.
* 외부 협력자를 추가해야 하면 관리자에게 해당 도메인 추가를 요청하세요.

{% hint style="warning" %}
**보안 정책** 일부 외부 도메인(예: gmail.com, naver.com)은 보안상 제한될 수 있습니다.
{% endhint %}

#### Q: 일괄 등록했는데 일부 행이 등록되지 않았어요

**가능한 원인**:

* 이메일 주소 중복(이미 등록된 이메일)
* 허용되지 않은 도메인
* 필수 항목(이름·이메일) 누락 또는 형식 오류

**해결 방법**:

1. 미리보기 화면에서 오류가 표시된 행을 확인합니다.
2. 매핑으로 돌아가 해당 부분을 수정하거나, 원본 파일을 고쳐 다시 올립니다.

#### Q: 구성원을 추가할 수 없어요 (한도 초과)

**원인**: 회사의 구성원 등록 한도에 도달했습니다.

**해결 방법**:

1. **`구성원 추가하기`** 옆 펼침(▾)의 \*\*`비활성화된 구성원 관리하기`\*\*에서 사용하지 않는 비활성 구성원을 정리합니다.
2. 한도 증가가 필요하면 채널톡으로 문의하세요.

#### Q: 이 외의 문제

채널톡으로 문의해 주세요.