#SendGrid 集成
概览
sendgrid 是一个集成,允许Botpress 聊天机器人通过SendGrid API 发送邮件。
配置
验证你的域名sendgrid
1.登录SendGrid 面板sendgrid 2.在左侧导航栏中打开 "设置 "子菜单,点击 "发件人身份验证"。 3.3. 在屏幕右中部,点击 "开始 "按钮(仅限第一个域验证)
- 第二个以上域验证)在靠近左下方的 "域验证 "部分,点击 "验证您的域" 4. 4.选择域名的提供商,如果提供商未列出,请选择 "我不确定"(这比 "其他主机 "选项更简单)
- 也可使用 SquareSpace 域名进行测试 5.在 "来自域名 "字段中输入您的域名(例如Botpress.com) 6.在域名提供商(如 Cloudflare、GoDaddy、SquareSpace 等)的门户网站上添加 DNS 记录 7.勾选 "我已添加这些记录 "并点击 "验证",等待SendGrid 确认已验证。
- 如果在域名提供商处正确添加了 "CNAME "DNS 记录后仍显示错误,请尝试从主机密钥中删除域名后缀。(例如,"em1234botpresscom" > "em1234") 8.现在,您就可以使用域名发送电子邮件了。祝您发送邮件愉快!
获取 API 密钥sendgrid
1.登录SendGrid 面板sendgrid 2.在左侧导航栏中打开 "设置 "子菜单,点击 "API 密钥 3.在右上角附近,点击 "创建 API 密钥 4.为密钥命名 5.授予密钥 "完全访问 "权限,如果使用 "受限访问",则选择以下内容:
- 邮件发送"(完全访问) 6.点击 "创建并查看
设置 Webhookswebhook
1.登录SendGrid 面板sendgrid 2.在左侧导航栏中打开 "设置 "子菜单,点击 "邮件设置 3.在 "邮件设置 "中,点击 "事件 Webhooks"; 4. 4.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. 9.点击 "保存",然后就可以在Botpress 机器人中使用这些事件了。
旁注
目前的实现仅限于发送 markdown 富文本电子邮件,不过未来会进一步扩展。
资源
- 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