SendGrid

  # SendGrid 통합

## 개요

'sendgrid'는 Botpress 챗봇이 SendGrid API를 통해 이메일을 보낼 수 있는 통합 기능입니다.

## 구성

### 도메인 인증sendgrid

1. SendGrid 대시보드에 로그인합니다sendgrid
2. 왼쪽의 탐색 모음에서 "설정" 하위 메뉴를 열고 "발신자 인증"을 클릭합니다.
3. 화면 오른쪽 중앙에서 "시작하기" 버튼을 클릭합니다(첫 번째 도메인 인증만 해당).
   - (두 번째 이상의 도메인 인증) "도메인 인증" 섹션의 왼쪽 하단에서 "도메인 인증"을 클릭합니다.
4. 도메인 공급업체를 선택하고 공급업체가 목록에 없는 경우 "잘 모름"을 선택합니다(다른 호스트 옵션보다 쉽습니다).
   - SquareSpace 도메인으로도 테스트했습니다.
5. "도메인 출처" 필드에 도메인을 입력합니다(예:Botpress.com").
6. 도메인 공급업체의 포털에 DNS 레코드를 추가합니다(예: Cloudflare, GoDaddy, SquareSpace 등).
7. "이 레코드를 추가했습니다"를 확인하고 "확인"을 클릭한 후 SendGrid 확인이 완료될 때까지 기다립니다.
   - 도메인 공급업체에 'CNAME' DNS 레코드를 올바르게 추가했는데도 오류가 계속 표시되는 경우 호스트 키에서 도메인 접미사를 제거해 보세요. (예: "em1234botpress.com" > "em1234")
8. 이제 도메인으로 이메일을 보낼 준비가 되었습니다. 이메일을 즐겨보세요!

### API 키 획득하기sendgrid

1. SendGrid 대시보드에 로그인합니다sendgrid
2. 왼쪽의 탐색 모음에서 "설정" 하위 메뉴를 열고 "API 키"를 클릭합니다.
3. 오른쪽 상단에서 "API 키 생성"을 클릭합니다.
4. 키에 이름을 지정합니다.
5. 키에 "전체 액세스"로 권한을 부여하거나 "제한된 액세스"를 사용하는 경우 다음을 선택합니다:
   - "메일 보내기"(전체 액세스)
6. "만들기 및 보기"를 클릭합니다.

### 웹훅 설정하기webhook

1. SendGrid 대시보드에 로그인합니다sendgrid
2. 왼쪽의 탐색 모음에서 "설정" 하위 메뉴를 열고 "메일 설정"을 클릭합니다.
3. 메일 설정에서 "이벤트 웹훅"을 클릭합니다.
4. 화면 오른쪽 중앙에서 "새 webhook 만들기"를 클릭합니다.
5. (선택 사항) webhook "친숙한 이름"(예:Botpress Bot")을 지정합니다.
6. Botpress 연동 설정에서 webhook URL을 복사하여 Sendgrid"포스트 URL" 필드에 붙여넣습니다.
7. "게시 할 작업"을 선택하면 Botpress 통합이 수신 할 이벤트가됩니다.
   1. 참고: 이 연동은 아직 모든 이벤트를 지원하지는 않습니다.
8. (선택 사항이지만 권장) "서명 인증" 활성화하기
   1. 이 기능을 활성화한 경우 webhook 저장되면 webhook 톱니바퀴를 클릭하고 "편집"을 클릭합니다.
   2. Sendgrid "인증키"를 복사하여 Botpress 연동 설정의Webhook 인증키" 필드에 붙여넣습니다.
9. "저장"을 클릭하면 Botpress 봇에서 이벤트를 사용할 준비가 완료됩니다.

참고 사항 ## 사이드 노트

현재 구현은 [마크다운](https://spec.commonmark.org/0.31.2/) 리치 텍스트 이메일 전송으로만 제한되어 있지만 향후 확장될 예정입니다.

## 리소스

- https://www.twilio.com/docs/sendgrid/for-developers
- https://www.twilio.com/docs/sendgrid/api-reference
- https://www.twilio.com/docs/sendgrid/ui/account-and-settings/api-keys
- https://www.twilio.com/docs/sendgrid/ui/account-and-settings/how-to-set-up-domain-authentication