SendGrid

  #SendGrid 整合

## 總覽

sendgrid 是一個整合，允許Botpress 聊天機透過SendGrid API 傳送電子郵件。

## 配置

### 驗證您的網域sendgrid

1.登錄SendGrid 面板sendgrid
2.在左邊的導覽列，開啟 「設定 」子選單，點選 「寄件者驗證」。
3.在螢幕右上方，點選「開始」按鈕 (僅限第一個網域認證)
   - (第二個以上網域驗證) 在靠近左下方的「網域驗證」部分，按一下「驗證您的網域」 4.
4.選擇域的提供商，如果提供商沒有列出，請選擇 「我不確定」（這比 「其他主機 」選項更容易）
   - 也可使用 SquareSpace 網域進行測試
5.在「來自網域」欄位中，輸入您的網域 (例如：Botpress.com」)
6.在您的域名提供商（例如 Cloudflare、GoDaddy、SquareSpace 等）的入口網站中加入 DNS 記錄
7.勾選 "I've added these records「（我已經新增這些記錄）並點選 」Verify"（驗證），然後等待SendGrid 確認已經驗證。
   - 如果在您的網域名稱提供商正確添加了 "CNAME "DNS 記錄，但仍然顯示錯誤，請嘗試從主機密鑰中移除網域後綴。(例如："em1234botpress.com" > "em1234")
8.現在您可以使用您的網域發送電子郵件了。祝您電郵愉快！

### 取得 API 金鑰sendgrid

1.登錄SendGrid 面板sendgrid
2.在左邊的導覽列，開啟 「設定 」子選單，點選 「API 金鑰」
3.靠近右上方，點擊 「創建 API 密鑰」 4.
4.為金鑰命名
5.授予該金鑰 「完全訪問 」權限，如果使用 「受限訪問」，則選擇以下項目：
   - 「郵件發送」（完全訪問）
6.按一下「建立與檢視

### 設定 Webhookswebhook

1.登錄SendGrid 面板sendgrid
2.在左邊的導覽列，開啟 「設定 」子選單，點選 「郵件設定」。
3.在 「邮件设置 」中，点击 「事件 Webhooks」。
4.在螢幕右邊中央部分，按一下「建立新webhook」 5.
5.（可選）為webhook 起一個「友好名稱」（例如Botpress Bot）
6.複製Botpress 整合設定中的webhook URL，並貼到Sendgrid 的「發佈 URL」欄位。
7.選擇「要發佈的動作」，這些將會是Botpress 整合程式要接收的事件。
   1.注意：這個整合還不支援所有的事件。
8.(可選，但推薦）啟用 「簽名驗證」 1.
   1.如果您已啟用此功能，儲存webhook 後，按一下webhook 上的齒輪，然後按一下「編輯」。
   2.從Sendgrid 複製 「驗證碼 」並貼到Botpress 整合配置中的Webhook 驗證碼 」欄位。
9.點選「儲存」，您就可以在Botpress 殭屍中使用這些事件了。

## 旁注

目前的實作只限於傳送 [markdown](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