> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SendGrid 설정

> Email 전달을 위해 SendGrid를 OneSignal과 통합합니다.

# 요구 사항

* [SendGrid 계정](https://www.sendgrid.com)
* [OneSignal 계정](https://onesignal.com)

# 설정

## 1. SendGrid 발신자 인증

SendGrid가 `via sendgrid.net`이 아닌 사용자의 도메인을 통해 Email을 보내고 사용자가 클릭하는 링크가 사용자의 도메인에서 온 것으로 표시되도록 SendGrid의 "Domain Authentication"을 사용하는 것이 좋습니다.

**권장 사항**: SendGrid의 [도메인 인증 설정 방법](https://docs.sendgrid.com/ui/account-and-settings/how-to-set-up-domain-authentication) 가이드를 따르세요.

SendGrid는 도메인이 없는 경우 [Single Sender Verification](https://docs.sendgrid.com/ui/sending-email/sender-verification)도 제공합니다.

## 2. DNS 레코드 설치

**Domain Authentication**을 선택한 경우 DNS 레코드가 확인되었는지 확인하세요.

<Frame caption="SendGrid DNS 확인 상태">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3ceb5db-Screen_Shot_2021-10-20_at_1.18.12_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=9cbb18e747d85c69d73e272e3c2e23d5" width="1402" height="872" data-path="images/docs/3ceb5db-Screen_Shot_2021-10-20_at_1.18.12_PM.png" />
</Frame>

SPF, DKIM 및 MX 레코드는 SendGrid의 설정 마법사를 통해 자동으로 구성되어야 합니다.

<Frame caption="SendGrid 도메인 인증 설정">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/41879e3-esp-sendgrid-domain-3.jpg?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=deaeacb61d563fb01079199a4a1373be" width="2500" height="1600" data-path="images/docs/41879e3-esp-sendgrid-domain-3.jpg" />
</Frame>

## 3. API 키 생성

SendGrid 대시보드에서 [Settings -> API Keys](https://app.sendgrid.com/settings/api_keys)로 이동하고 'Create API Key'를 클릭합니다.

<Frame caption="SendGrid API 키 생성 화면">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/f794466-esp-sendgrid-apikey.jpg?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=58f82278dd1461db66aedf9123723b50" width="2500" height="1270" data-path="images/docs/f794466-esp-sendgrid-apikey.jpg" />
</Frame>

API 키 이름을 `OneSignal API Key`와 같이 지정하고 권한을 **Full Access**로 설정해야 합니다. 준비가 되면 'Create & View'를 클릭합니다.

<Frame caption="SendGrid API 키 권한 설정">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/afe1836-esp-sendgrid-apikey-2.jpg?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=c2647bf1992dc79b00974c453a8ffb00" width="2500" height="1350" data-path="images/docs/afe1836-esp-sendgrid-apikey-2.jpg" />
</Frame>

다음으로 API 키를 클릭하여 클립보드에 복사합니다.

<Frame caption="SendGrid API 키 복사">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b8a9822-esp-sendgrid-apikey-3.jpg?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=df6331d166120cd300fac9d50bb04f82" width="2500" height="990" data-path="images/docs/b8a9822-esp-sendgrid-apikey-3.jpg" />
</Frame>

### 허용할 수 있는 최소 API 제한은 무엇인가요?

허용해야 하는 최소 액세스는 다음과 같습니다:

<Frame caption="최소 API 권한 요구 사항">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2d82f50-Screen_Shot_2021-12-09_at_1.25.57_PM.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=d8857161192778c6714357b2d5e95ac3" width="986" height="1722" data-path="images/docs/2d82f50-Screen_Shot_2021-12-09_at_1.25.57_PM.png" />
</Frame>

<Warning>
  SendGrid의 허용 목록 기능을 사용하는 경우 이 목록에 OneSignal을 추가해야 합니다.

  아래 FAQ [OneSignal의 IP를 허용 목록에 추가하는 방법은 무엇인가요?](./sendgrid-setup#how-do-i-whitelist-onesignals-ips)를 참조하세요.
</Warning>

## 4. SendGrid 구독 추적 비활성화

OneSignal은 보내는 모든 Email에 대해 자체 기본 구독 취소 링크를 자동으로 추가합니다.

SendGrid가 텍스트 및 HTML Email 하단에 자체 구독 취소 링크를 자동으로 추가하지 않도록 SendGrid에서 **Subscription Tracking**을 비활성화합니다.

<Frame caption="SendGrid 구독 추적 설정">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1b863e8-Sendgrid_Tracking_Settings.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=c483fc9706a46d3ab6cc4d00ee90802f" width="1235" height="647" data-path="images/docs/1b863e8-Sendgrid_Tracking_Settings.png" />
</Frame>

## 5. Email 메시징 활성화

OneSignal에서 **Settings > Platforms > Email**로 이동하고 **Activate**를 클릭하여 Email 설정을 구성합니다.

공급자로 **SendGrid**를 선택합니다.

<Frame caption="Email 설정에서 SendGrid 선택">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a42b5c0-Screenshot_2023-09-27_at_4.38.36_PM.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=af1b1a422edf6fc979eeb9b4c3cfc42e" width="1880" height="1026" data-path="images/docs/a42b5c0-Screenshot_2023-09-27_at_4.38.36_PM.png" />
</Frame>

제공된 필드에 SendGrid API 키를 붙여넣습니다.

<Frame caption="API 키 입력 위치">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/0431d6a-Screenshot_2023-09-27_at_4.39.12_PM.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=bbb78dfd7e2c9deaf6699292dd55dab8" width="1862" height="644" data-path="images/docs/0431d6a-Screenshot_2023-09-27_at_4.39.12_PM.png" />
</Frame>

### 전달 기본값

Email을 보낼 기본 **이름** 및 **Email 주소**를 추가합니다(나중에 변경할 수 있음).

완료되면 Done을 누릅니다.

<Frame caption="Email 구성 성공 배너">
  <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4b63e41-Screenshot_2023-09-27_at_4.41.02_PM.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=7fa2706b1fa954740752c6b1557552cc" width="1874" height="884" data-path="images/docs/4b63e41-Screenshot_2023-09-27_at_4.41.02_PM.png" />
</Frame>

## 6. 구독자 추가

준비된 Email 목록이 있는 경우 **Upload CSV**를 선택하거나 나중에 다시 수행할 수 있습니다.

웹사이트가 있고 사용자에게 Email을 제공하도록 요청하려는 경우 **Add Web Prompt**를 선택하여 OneSignal의 [Email Web Prompt](./permission-requests)를 사용합니다.

<Frame caption="Email 구독자 설정 옵션">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/6ba703e-Screenshot_2023-09-27_at_4.39.54_PM.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=1073f5704e2367527d67cab6980789d2" width="1874" height="1174" data-path="images/docs/6ba703e-Screenshot_2023-09-27_at_4.39.54_PM.png" />
</Frame>

## 7. 테스트

**Messages > Email**로 이동하여 **New Email**을 선택합니다.

`Subject`를 추가하고 편집 환경을 선택한 다음(Drag & Drop Editor가 좋은 시작입니다) **Send Test Email**을 클릭합니다.

<Frame caption="Email 테스트 인터페이스">
  <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/10d1976-Screenshot_2023-09-27_at_4.49.08_PM.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=5bd931f0ccb9ad064110678ce5e0e183" width="2206" height="692" data-path="images/docs/10d1976-Screenshot_2023-09-27_at_4.49.08_PM.png" />
</Frame>

Email을 입력하고 **Send Test Email**을 누릅니다. 곧 받은 편지함에 Email이 도착할 것입니다!

<Info>
  문제가 발생하면 [Email FAQ](./email-troubleshooting)를 참조하세요.

  문제가 해결되지 않으면 `support@onesignal.com`에 문의하세요.

  더 빠른 지원을 위해 다음을 제공하세요:

  * OneSignal App Id
  * 문제의 세부 정보, 로그 및/또는 스크린샷
  * 재현 단계
</Info>

# 권장 사항

## 사용자 식별

**통합을 사용하는 경우 필수.** **여러 채널(push, email, sms)에서 메시징하는 경우 권장.**

OneSignal은 subscription\_id라는 고유 ID 아래에 구독 수준 레코드를 생성합니다. 단일 사용자는 앱과 상호 작용하는 데 사용하는 장치, Email 주소 및 전화번호 수에 따라 여러 subscription\_id 레코드를 가질 수 있습니다.

앱에 사용자를 추적하는 자체 로그인 시스템이 있는 경우 언제든지 `login`을 호출하여 모든 채널을 단일 사용자에게 연결할 수 있습니다. 자세한 내용은 [Aliases & External ID](./users)를 참조하세요.

## 새 Email 수집

**Email 및 SMS 메시징을 사용하는 경우 권장.**

새 Email 주소를 OneSignal에 전달하는 몇 가지 방법이 있습니다:

* OneSignal의 Frontend SDK를 사용하여 새 Email을 캡처합니다. [Email SDK Methods](./mobile-sdk-reference#email)를 참조하세요.
* 서버에서 Email을 추가하려면 [Create user](/reference/create-user) 또는 [Create subscription](/reference/create-subscription) API를 사용합니다.
* CSV를 통해 Email을 가져오려면 [Import Email Addresses](./import)를 참조하세요.

## 데이터 태그 추가

**선택 사항**

태그는 사용자 이벤트 및 속성을 추적하는 데 사용되는 문자열 데이터의 사용자 지정 `key : value` 쌍입니다. 더 복잡한 [세그먼테이션](./segmentation) 및 [메시지 개인화](./message-personalization)를 위해 태그를 설정해야 합니다.

자세한 내용은 [Tags](./add-user-data-tags)를 참조하세요.

<Check>
  다음 단계는 [Email Tutorials](./email-messaging)를 참조하세요.
</Check>

# Email 내보내기

1. **연락처 목록 탐색**: `Marketing > Contacts`로 이동합니다.

2. <Frame caption="Contacts 페이지로 이동">
     <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7c49df1-step-1-50.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=eb80902228ae5d891426577e09211c6a" width="224" height="1167" data-path="images/docs/7c49df1-step-1-50.png" />
   </Frame>

3. **목록 식별**: 내보낼 목록을 찾습니다.

4. **내보내기 선택**: **Action** 목록 헤더 아래의 컨텍스트 메뉴를 엽니다.

<Frame caption="내보낼 연락처 목록 선택">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d900c5a-step-3-50.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=4ef417459779b56fe9211305f082782e" width="1261" height="679" data-path="images/docs/d900c5a-step-3-50.png" />
</Frame>

4. **내보내기 시작**: **Export**를 클릭합니다. 그러면 `Contact > Active Exports`로 이동합니다.
5. **파일 다운로드**: **Status**가 'Ready for Download'로 표시될 때까지 기다린 다음 **Download CSV**를 클릭합니다.

<Frame caption="내보낸 CSV 다운로드">
  <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2d1c12f-step-5-50.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=3f8102ca85b5dde7c55e10cb12643ce6" width="1261" height="630" data-path="images/docs/2d1c12f-step-5-50.png" />
</Frame>

6. **파일 검색**: 파일이 다운로드 디렉터리에 저장됩니다.

# API 키 얻기

1. Sendgrid 대시보드로 이동하고 왼쪽 사이드바에서 **Settings**을 엽니다.

<Frame caption="Settings > API Keys로 이동">
  <img src="https://mintcdn.com/onesignal/4HyuQPBpu-4xjmQC/images/docs/cf3fe33-step-1-50.png?fit=max&auto=format&n=4HyuQPBpu-4xjmQC&q=85&s=0a162a955d877a4b66623bbe835cfcb7" width="1616" height="1365" data-path="images/docs/cf3fe33-step-1-50.png" />
</Frame>

2. **API Keys**를 선택합니다.

<Frame caption="Create API Key 버튼 클릭">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/c3045de-step-2-50.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=2421e360c654dcf620110214bdceb187" width="1616" height="1365" data-path="images/docs/c3045de-step-2-50.png" />
</Frame>

3. 키 이름을 지정합니다. 선택적으로 특정 권한에 대해 *Restricted Access*를 선택합니다.

<Frame caption="키 이름 지정 및 권한 설정">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8770efc-step-3-50.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=f2c9125755ab5db955af0a8dd6d1edfc" width="1616" height="1365" data-path="images/docs/8770efc-step-3-50.png" />
</Frame>

*Restricted Access*를 사용하는 경우 Marketing에 대해 **Full Access** 권한을 부여해야 합니다.

<Frame caption="Marketing에 Full Access 부여">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/83d80f8-step-4-50.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=33a46fe982c60987c70cd4dfa9e0d07e" width="1616" height="1365" data-path="images/docs/83d80f8-step-4-50.png" />
</Frame>

4. **Create & View**를 클릭합니다.

<Frame caption="Create & View 버튼 클릭">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/f92f0c4-step-5-50.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=75a7a005e4040d66c4badf0d68260942" width="1616" height="1365" data-path="images/docs/f92f0c4-step-5-50.png" />
</Frame>

5. API 키를 복사합니다.

<Frame caption="API 키 복사">
  <img src="https://mintcdn.com/onesignal/MUgio66t0sYhGEvj/images/docs/64034da-step-6-50.png?fit=max&auto=format&n=MUgio66t0sYhGEvj&q=85&s=73edf11c5792ca71d42301ac225594f6" width="1616" height="1365" data-path="images/docs/64034da-step-6-50.png" />
</Frame>

# 자주 묻는 질문

## SendGrid에 이미 활성 Webhook이 있는 경우 OneSignal을 설정하려면 어떻게 해야 하나요?

설정을 간소화하고 Email 전달 통계에 액세스할 수 있도록 OneSignal은 SendGrid를 사용하여 Webhook을 자동으로 구성합니다. 안타깝게도 SendGrid는 지정된 계정에 대해 단일 Webhook만 지원합니다. OneSignal은 Email 분석을 위해 Webhook이 필요하며 이는 이전에 설정한 Webhook(예: 분석 통합용)와 충돌할 수 있습니다.

현재 설정한 Webhook이 필요한 경우 요청을 `https://onesignal.com/email/hooks/sendgrid`로 전달할 수 있습니다. 최상의 결과를 얻으려면 30초의 시간 초과를 설정하세요.

이전에 설정한 Webhook이 필요하지 않은 경우 변경해야 합니다. SendGrid에서 **Settings > Mail Settings**로 이동하고 'Event Webhook'을 클릭합니다. HTTP Post URL은 `https://onesignal.com/email/hooks/sendgrid`여야 하며 다음과 같은 최소 설정이 있어야 합니다:

<Frame caption="SendGrid Webhook 구성 설정">
  <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/989f714-Screen_Shot_2021-10-20_at_2.05.47_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=fccfdce1d4e2ae9139c8a00bd1605bf2" width="2526" height="1522" data-path="images/docs/989f714-Screen_Shot_2021-10-20_at_2.05.47_PM.png" />
</Frame>

## OneSignal의 IP를 허용 목록에 추가하는 방법은 무엇인가요?

자세한 내용은 [REST API Overview](/reference/rest-api-overview)의 요구 사항을 참조하세요.

<Frame caption="OneSignal IP 허용 목록 요구 사항">
  <img src="https://mintcdn.com/onesignal/56ctKxZSV4m5VEkn/images/docs/b7550d9-Screen_Shot_2022-05-27_at_5.32.06_PM.png?fit=max&auto=format&n=56ctKxZSV4m5VEkn&q=85&s=d107970e875efcb9418aea08ea412106" width="1626" height="1314" data-path="images/docs/b7550d9-Screen_Shot_2022-05-27_at_5.32.06_PM.png" />
</Frame>

***