SendGrid

  # SendGrid Tích hợp ## Tổng quan `@botpresshub/ sendgrid ` là một sự tích hợp cho phép một Botpress chatbot để gửi email qua SendGrid API. ## Cấu hình ### Xác thực tên miền của bạn (https://app. sendgrid .com/settings/sender_auth) 1. Đăng nhập vào SendGrid bảng điều khiển (https://app. sendgrid .com/) 2. Trong thanh điều hướng bên trái, mở menu phụ "Cài đặt", nhấp vào "Xác thực người gửi" 3. Ở phần giữa bên phải của màn hình, nhấp vào nút "Bắt đầu" (Chỉ xác thực tên miền đầu tiên) - (xác thực tên miền thứ 2 trở lên) Gần góc dưới bên trái trong phần "Xác thực tên miền", nhấp vào "Xác thực tên miền của bạn" 4. Chọn nhà cung cấp cho tên miền của bạn, nếu nhà cung cấp không được liệt kê, hãy chọn "Tôi không chắc chắn" (Dễ hơn tùy chọn "Máy chủ khác") - Cũng đã thử nghiệm với SquareSpace Domains 5. Trong trường "Từ tên miền", nhập tên miền của bạn (ví dụ: " Botpress .com") 6. Thêm bản ghi DNS vào cổng thông tin của nhà cung cấp tên miền của bạn (ví dụ: Cloudflare, GoDaddy, SquareSpace, v.v.) 7. Chọn "Tôi đã thêm những bản ghi này" và nhấp vào "Xác minh" rồi đợi SendGrid để xác nhận rằng nó đã được xác minh. - Nếu lỗi vẫn hiển thị mặc dù đã thêm đúng bản ghi DNS 'CNAME' vào nhà cung cấp tên miền của bạn, hãy thử xóa hậu tố tên miền khỏi khóa máy chủ. (ví dụ: "em1234. botpress .com" > "em1234") 8. Bây giờ bạn đã sẵn sàng gửi email với tên miền của mình. Chúc bạn gửi email vui vẻ! ### Nhận khóa API (https://app. sendgrid .com/settings/api_keys) 1. Đăng nhập vào SendGrid bảng điều khiển (https://app. sendgrid .com/) 2. Trong thanh điều hướng bên trái, mở menu phụ "Cài đặt", nhấp vào "Khóa API" 3. Gần góc trên bên phải, nhấp vào "Tạo khóa API" 4. Đặt tên cho khóa 5. Cấp quyền cho khóa bằng "Quyền truy cập đầy đủ" hoặc nếu sử dụng "Quyền truy cập hạn chế", hãy chọn tùy chọn sau: - "Gửi thư" (Quyền truy cập đầy đủ) 6. Nhấp vào "Tạo & Xem" ### Thiết lập Webhooks (https://app. sendgrid .com/settings/mail_settings/ webhook _settings) 1. Đăng nhập vào SendGrid bảng điều khiển (https://app. sendgrid .com/) 2. Trong thanh điều hướng bên trái, mở menu phụ "Cài đặt", nhấp vào "Cài đặt thư" 3. Trong Cài đặt thư, nhấp vào "Webhooks sự kiện" 4. Ở phần giữa bên phải của màn hình, nhấp vào "Tạo mới webhook " 5. (Tùy chọn) Cung cấp webhook một "Tên thân thiện" (ví dụ " Botpress Bot") 6. Sao chép webhook URL từ Botpress cấu hình tích hợp và dán nó vào Sendgrid Trường "Đăng URL" 7. Chọn "Hành động sẽ được đăng", đây sẽ là các sự kiện mà Botpress tích hợp sẽ nhận được. 1. Lưu ý: Tích hợp này chưa hỗ trợ tất cả các sự kiện 8. (Tùy chọn, nhưng được khuyến nghị) Bật "Xác minh chữ ký" 1. Nếu bạn đã bật tính năng này, sau khi webhook được lưu, hãy nhấp vào bánh răng trên webhook và nhấp vào "chỉnh sửa" 2. Sao chép "Khóa xác minh" từ Sendgrid và dán nó vào " Webhook Trường "Khóa xác minh" của Botpress cấu hình tích hợp 9. Nhấp vào "Lưu" và bạn đã sẵn sàng sử dụng các sự kiện trong Botpress bot ## Ghi chú bên lề Việc triển khai hiện tại chỉ giới hạn ở việc gửi email có văn bản [markdown](https://spec.commonmark.org/0.31.2/), mặc dù tính năng này sẽ được mở rộng trong tương lai. ## Tài nguyên - https://www. twilio .com/docs/ sendgrid /dành cho nhà phát triển - 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