# 추가 사용자를 초대하기

## 추가 사용자를 초대하기

최고관리자는 구성원 페이지에서 추가 사용자를 SMPLY에 초대할 수 있습니다. 초대된 사용자는 이메일을 통해 가입 링크를 받게 됩니다.

***

### 구성원 초대 방법

#### 1. 개별 구성원 초대

**단계 1: 구성원 추가 화면 열기**

1. 좌측 메뉴에서 **구성원**을 클릭합니다.
2. 우측 상단의 **구성원 추가** 버튼을 클릭합니다.

**단계 2: 기본 정보 입력**

구성원 추가 팝업에서 다음 정보를 입력합니다:

| 필드        | 설명          | 필수 여부 | 예시                 |
| --------- | ----------- | ----- | ------------------ |
| **이름**    | 구성원의 이름     | 필수    | 홍길동                |
| **이메일**   | 회사 이메일 주소   | 필수    | <hong@company.com> |
| **부서/직급** | 부서명 또는 직급   | 선택    | 개발팀 / 대리           |
| **전화번호**  | 연락 가능한 전화번호 | 선택    | 010-1234-5678      |

{% hint style="info" %}
**이메일 주소 확인** 초대 이메일이 발송되므로 정확한 이메일 주소를 입력해 주세요. 초대 완료 후에도 이메일 주소를 수정할 수 있습니다.
{% endhint %}

**단계 3: 역할 및 팀 지정**

**역할 선택**

1. **역할** 드롭다운을 클릭합니다.
2. 적절한 역할을 선택합니다:
   * **관리자**: 모든 기능 접근 가능
   * **일반**: 본인 데이터만 조회 가능
   * 또는 커스텀 역할 선택

**팀 지정**

1. **소속 팀** 필드를 클릭합니다.
2. 구성원이 소속될 팀을 선택합니다.
3. 여러 팀 선택 가능 (최대 3개)

{% hint style="warning" %}
**팀 제한** 구성원 1명은 최대 3**개 팀**에 소속될 수 있습니다.
{% endhint %}

**단계 4: 초대 이메일 발송**

1. **초대 이메일 발송** 체크박스를 체크합니다.
2. **저장** 버튼을 클릭합니다.

**초대 이메일 발송 옵션**:

* ✅ **체크함**: 구성원 추가와 동시에 초대 이메일 발송
* ⬜ **체크 안 함**: 구성원만 추가하고 나중에 초대 (상태: "추가됨")

{% hint style="info" %}
**권장 방식** 일반적으로 초대 이메일을 즉시 발송하는 것을 권장합니다. 나중에 초대하려면 구성원 목록에서 **초대 이메일 발송** 버튼을 클릭하세요.
{% endhint %}

***

#### 2. 여러 구성원 일괄 초대

대량의 구성원을 한번에 추가하고 초대할 수 있습니다.

**단계 1: 일괄 업로드 시작**

1. **구성원** 메뉴로 이동합니다.
2. **메뉴 더보기** (⋮) > **일괄 업로드**를 클릭합니다.

**단계 2: 템플릿 다운로드**

1. **엑셀 템플릿 다운로드** 버튼을 클릭합니다.
2. 다운로드된 Excel 파일을 엽니다.

**단계 3: 구성원 정보 입력**

템플릿의 각 열에 정보를 입력합니다:

| 열 이름      | 설명                     | 예시                 |
| --------- | ---------------------- | ------------------ |
| **이름**    | 구성원 이름                 | 홍길동                |
| **이메일**   | 회사 이메일 주소              | <hong@company.com> |
| **역할**    | 역할 이름 (정확히 입력)         | 관리자 또는 일반          |
| **팀**     | 팀 이름 (여러 개는 세미콜론으로 구분) | 개발팀;마케팅팀           |
| **부서/직급** | 부서 또는 직급               | 개발팀 / 대리           |
| **전화번호**  | 연락처                    | 010-1234-5678      |

**입력 예시**:

```
이름          이메일                   역할    팀           부서/직급
홍길동        hong@company.com        일반    개발팀       개발팀 / 대리
김철수        kim@company.com         관리자  개발팀;HR팀  개발팀 / 과장
이영희        lee@company.com         일반    마케팅팀     마케팅팀 / 사원
```

{% hint style="warning" %}
**주의사항**

* 역할 이름은 SMPLY에 등록된 역할과 정확히 일치해야 합니다.
* 팀 이름도 기존 팀과 정확히 일치해야 합니다.
* 이메일 주소가 중복되면 해당 행은 스킵됩니다.
  {% endhint %}

**단계 4: 파일 업로드**

1. 작성한 Excel 파일을 저장합니다.
2. **파일 업로드** 버튼을 클릭합니다.
3. 저장한 파일을 선택합니다.

**단계 5: 검증 및 업로드**

1. 시스템이 파일을 검증합니다.
2. 오류가 있으면 오류 목록이 표시됩니다.
3. 오류를 수정하고 다시 업로드합니다.
4. 검증 통과 후 **업로드** 버튼을 클릭합니다.

**단계 6: 초대 이메일 발송**

업로드 완료 후:

1. **일괄 초대 발송** 버튼이 나타납니다.
2. 버튼을 클릭하여 모든 구성원에게 초대 이메일을 발송합니다.

***

### 초대 이메일 흐름

#### 초대 이메일 내용

구성원은 다음 내용의 이메일을 받게 됩니다:

```
제목: [SMPLY] {회사명}에서 초대하였습니다

안녕하세요, {구성원 이름}님

{회사명}에서 SMPLY에 초대하였습니다.
아래 버튼을 클릭하여 가입을 완료해 주세요.

[가입하기] 버튼

초대 링크는 7일간 유효합니다.
```

#### 구성원의 가입 절차

1. **이메일 확인**: 구성원이 초대 이메일을 확인합니다.
2. **링크 클릭**: "가입하기" 버튼을 클릭합니다.
3. **비밀번호 설정**: 가입 페이지에서 비밀번호를 설정합니다.
4. **가입 완료**: 자동으로 SMPLY에 로그인됩니다.

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

***

### 초대 상태 확인 및 관리

#### 구성원 상태

초대 후 구성원은 다음 상태 중 하나를 가집니다:

| 상태      | 의미                    | 다음 단계                |
| ------- | --------------------- | -------------------- |
| **추가됨** | 구성원은 추가했으나 초대 이메일 미발송 | 초대 이메일 발송            |
| **초대됨** | 초대 이메일 발송 완료, 가입 대기 중 | 구성원이 가입 완료하면 활성으로 변경 |
| **활성**  | 가입 완료, 정상 사용 가능       | -                    |

#### 초대 재발송

구성원이 초대 이메일을 받지 못했거나 기간이 만료된 경우:

1. **구성원** 목록에서 "초대됨" 상태 구성원을 찾습니다.
2. 해당 구성원의 **메뉴 더보기** (⋮)를 클릭합니다.
3. **초대 재발송**을 선택합니다.
4. 확인 메시지에서 **발송**을 클릭합니다.

{% hint style="info" %}
**재발송 횟수 제한 없음** 초대 이메일은 필요한 만큼 여러 번 재발송할 수 있습니다.
{% endhint %}

***

### 문제 해결

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

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

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

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

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

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

* 회사 IT 부서에 SMPLY 이메일 도메인 차단 여부 확인 요청
* 차단 해제 도메인: `@sherpas.team`, `@smply.one`

**4단계: 재발송**

1. 위 사항 확인 후 초대를 재발송합니다.
2. 여전히 문제가 있으면 채널톡으로 문의해 주세요.

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

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

**해결 방법**:

1. **구성원** 메뉴에서 해당 이메일로 검색합니다.
2. 필터에서 **비활성** 상태도 포함하여 검색합니다.
3. 이미 등록된 구성원이 있다면:
   * **재활성화**: 비활성 구성원을 재활성화합니다.
   * **다른 이메일 사용**: 새 구성원은 다른 이메일로 초대합니다.

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

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

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

1. **설정** > **회사 설정**으로 이동합니다.
2. **도메인** 탭을 선택합니다.
3. 등록된 도메인 목록을 확인합니다.

**해결 방법**:

* 회사 도메인의 이메일 주소를 사용하세요.
* 외부 협력자를 추가해야 하는 경우, 관리자에게 해당 도메인을 추가하도록 요청하세요.

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

#### Q: 초대 링크가 만료됐어요

**원인**: 초대 링크는 발송 후 **7일간 유효**합니다.

**해결 방법**:

1. 초대를 재발송합니다.
2. 구성원에게 7일 이내에 가입하도록 안내합니다.

#### Q: 여러 명 초대했는데 일부만 초대됐어요

**가능한 원인**:

* 이메일 주소 중복 (이미 등록된 이메일)
* 허용되지 않은 도메인
* 역할 또는 팀 이름 오타

**해결 방법**:

1. 일괄 업로드 결과 화면에서 오류 목록을 확인합니다.
2. 오류가 있는 행을 수정합니다.
3. 다시 업로드하거나 개별로 추가합니다.

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

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

**기본 한도**: 구성원 **1,000명**

**해결 방법**:

1. **구성원** 메뉴에서 비활성 상태의 구성원을 확인합니다.
2. 불필요한 비활성 구성원을 정리합니다.
3. 한도 증가가 필요하면 채널톡으로 문의하세요.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smply.one/member/invite.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.