Mô-đun SMTP tùy chỉnh bổ sung các cài đặt cơ bản để cho phép bạn gửi email trực tiếp từ ứng dụng của mình.
Để làm cho biểu mẫu gửi thư xuất hiện trong ứng dụng, bạn cần thêm các cài đặt còn thiếu và các yếu tố cần thiết. Thuật toán của các hành động sẽ như sau:
- Thêm một trang hoặc cửa sổ nơi biểu mẫu thư sẽ được đặt.
- Kết nối mô-đun, thêm thông số máy chủ SMTP vào nó, cũng như tên người dùng và mật khẩu của bạn.
- Tạo quy trình nghiệp vụ, điểm cuối và biểu mẫu liên quan đến mô-đun.
Hãy trình bày cách thực hiện việc này trong một ứng dụng web sử dụng dịch vụ thư Gmail làm ví dụ.
Tạo một trang
Đi tới trình chỉnh sửa và tạo một trang mới mà bạn sẽ đăng. Cho biết tên trang của bạn ("Tiêu đề"), địa chỉ của trang ("URL trang") và các nhóm người dùng có thể gửi tin nhắn ("Hiển thị cho nhóm"). Nhấp vào để lưu".
Lưu các thay đổi của bạn và chuyển đến khối mô-đun.
Thêm và định cấu hình một mô-đun
Tìm mô-đun SMTP tùy chỉnh trong tab Thị trường và nhấp vào nút Cài đặt để thêm mô-đun đó vào ứng dụng.
Chuyển đến tab "Đã cài đặt", nơi chứa tất cả các mô-đun được cài đặt trong ứng dụng của bạn và nhấp vào hộp "SMTP tùy chỉnh" để mở cài đặt của nó. Thông tin cơ bản về mô-đun và một nút để xóa nó khỏi ứng dụng được hiển thị ở bên trái. Ở bên phải là các trường bạn cần điền:
- Trong các trường "Đăng nhập" và "Mật khẩu", hãy nhập dữ liệu của hộp thư mà từ đó bạn sẽ gửi tin nhắn.
- Chỉ định cài đặt kết nối SMTP - chúng khác nhau đối với từng dịch vụ e-mail. Theo mặc định, cài đặt Gmail được thêm vào mô-đun.
- Trong trường "Tên người gửi", hãy nhập tên sẽ được hiển thị cho người nhận thư của bạn.
Quan trọng! Để gửi thư qua Gmail, bạn cần bật các ứng dụng của bên thứ ba trong tài khoản Google của mình.
Để biết thêm thông tin về mô-đun là gì, cách cập nhật và tùy chỉnh chúng, hãy xem tài liệu của chúng tôi .
Hãy nhớ lưu các thay đổi của bạn.
Tạo quy trình kinh doanh, điểm cuối và biểu mẫu
Quy trình kinh doanh , điểm cuối và biểu mẫu là những yếu tố có liên quan với nhau và rất quan trọng để thiết lập một cách nhất quán. Bằng cách tương tác với nhau, họ sẽ hoàn thành cấu hình ứng dụng của bạn - và biểu mẫu gửi tin nhắn sẽ xuất hiện trên trang.
Bạn có thể đọc thêm về các yếu tố này trong tài liệu của chúng tôi .
Quy trình kinh doanh
Chuyển đến tab "Logic kinh doanh" và nhấp vào nút để tạo quy trình kinh doanh mới.
Nhập tên của quy trình (bắt buộc), mô tả của quy trình (tùy chọn) và nhấp vào nút "Tạo".
Mỗi quy trình nghiệp vụ trong trình soạn thảo được phân chia trực quan thành các khối - các bộ phận cấu thành chịu trách nhiệm cho các chức năng khác nhau. Khi một quy trình mới được tạo, "Bắt đầu" và "Kết thúc" sẽ tự động xuất hiện trong đó. Tất cả các khối khác mà bạn có thể thêm sẽ được hiển thị ở bên trái.
Sau khi cài đặt, mô-đun "SMTP tùy chỉnh" đã thêm "SMTP tùy chỉnh: Gửi Email" vào danh sách này. Để đưa khối này vào quy trình nghiệp vụ, hãy kéo khối này vào trường trình chỉnh sửa bằng cách sử dụng con trỏ chuột. Cửa sổ "SMTP tùy chỉnh: Gửi Email" sẽ xuất hiện, các trường trong đó chứa các biến mà nội dung của biểu mẫu gửi thư trong tương lai của bạn phụ thuộc vào:
- "Subject" - chủ đề của bức thư;
- "Nội dung" - một trường có nội dung của bức thư;
- "Tới" - địa chỉ của người nhận;
- "Cc" - địa chỉ để gửi một bản sao;
- "Từ tên" - tên của người gửi;
- "Bcc" là địa chỉ để gửi bản sao mù.
Bây giờ bạn cần liên kết "Bắt đầu", "SMTP tùy chỉnh: Gửi Email" và "Kết thúc" - để cho thấy rằng chúng tạo thành một quy trình kinh doanh duy nhất:
1. Di chuyển con trỏ chuột qua trường "Bắt đầu" trong khối "Bắt đầu", giữ nút chuột trái và vuốt đến trường "Trong" trong khối "SMTP tùy chỉnh: Gửi Email" - một kết nối được hình thành giữa các khối.
2. Tương tự, tạo liên kết giữa trường "Ra" của khối "SMTP tùy chỉnh: Gửi Email" và trường "Kết thúc" của khối "Kết thúc"
Bây giờ, trong khối "Bắt đầu", bạn cần tạo các trường (biến) mới và liên kết chúng với các biến trong khối "SMTP tùy chỉnh: Gửi Email". Các trường mà bạn thêm vào khối "Bắt đầu" sẽ xuất hiện trong biểu mẫu gửi tin nhắn của bạn. Hãy tưởng tượng rằng bạn sẽ không gửi bản sao và bản sao mù, vì vậy khối "Bắt đầu" sẽ chứa các trường sau:
- “Sender” (tên người gửi) - được liên kết với from_name;
- "Địa chỉ" (người mà nó đã được gửi) - được liên kết với "tới";
- "Subject" (chủ đề); - liên kết với "chủ đề" (tên biến trong các khối khác nhau có thể giống nhau);
- "Message" (nội dung của lá thư) - được liên kết với "body".
Để ràng buộc các biến, chúng phải khớp với nhau về kiểu. Loại biến có thể được xem bằng cách nhấp vào khối chứa nó và mở menu chỉnh sửa.
Trong các trường của các khối, bên cạnh mỗi biến có một biểu tượng, màu sắc và hình dạng của chúng phụ thuộc vào loại của nó - để giúp bạn điều hướng trong chúng dễ dàng hơn. Trong ví dụ của chúng tôi, có hai loại biến:
- "Chủ đề", "nội dung" và "from_name" thuộc loại "Chuỗi",
- To, cc và bcc thuộc loại Email Array.
Tạo các biến
Để tạo biến đầu tiên trong khối "Start", hãy nhấp vào nó - một danh sách sẽ được hiển thị (trong khi nó trống). Nhấp vào "+".
Trong cửa sổ đã mở, nhập tên của biến: tên "người gửi", nhập "Chuỗi". Nhấp vào "Tạo".
Tương tự, thêm "địa chỉ", "chủ đề" và "tin nhắn". Bây giờ danh sách các biến trong khối "Bắt đầu" trông giống như sau:
Liên kết chúng với các biến tương ứng trong khối SMTP tùy chỉnh: Gửi Email:
Cuối cùng thì mối quan hệ giữa các biến sẽ trông như thế nào. Lưu các thay đổi của bạn và tiến hành tạo điểm cuối.
Điểm cuối
Nhấp vào "Tạo điểm cuối" - bạn sẽ thấy chính mình trong cài đặt trên tab "Logic kinh doanh", ở đây bạn cần chỉ định các cài đặt sau:
- "Tuyến đường điểm cuối" - tên của điểm cuối, theo đó bạn sẽ hiểu chức năng của nó;
- "Nhóm điểm cuối" - tên của nhóm mà nó sẽ được đặt;
- "Loại yêu cầu" - chọn "ĐĂNG";
- "Quy trình kinh doanh" - chọn quy trình kinh doanh send_email mà bạn đã tạo.
Sau đó, chuyển đến tab "Phần mềm trung gian".
Trên tab “Phần mềm trung gian”, bạn cần định cấu hình các quyền để thực hiện các hành động với điểm cuối này (và do đó, để khởi chạy quy trình kinh doanh liên quan). Nói cách khác, bạn sẽ chỉ định ai có thể gửi email từ ứng dụng của bạn. Để thực hiện việc này, bạn cần thay đổi cài đặt của mã thông báo ủy quyền "Token Auth".
Chú ý! Nếu cài đặt này không được thay đổi, thì tất cả người dùng sẽ có quyền gửi email!
Nhấp vào biểu tượng bánh răng bên cạnh “Mã xác thực”. Trong cửa sổ đã mở, bật bộ chọn, trong trường "Nhóm được phép", hãy chọn nhóm "Quản trị viên" (hoặc bất kỳ nhóm nào khác mà bạn muốn cấp quyền truy cập). Nhấp vào để lưu"
Bây giờ lưu điểm cuối bằng cách nhấp vào "Tạo".
Quá trình gửi tin nhắn được cấu hình. Bây giờ bạn có thể tạo một bản trình bày trực quan của biểu mẫu gửi tin nhắn.
Hình thức
Để tạo biểu mẫu, hãy quay lại trình chỉnh sửa ứng dụng web, đến tab bạn đã tạo trước đó. Kéo một phần tử Biểu mẫu vào canvas trang.
Trong cửa sổ đã mở, nhấp vào "Tạo bản ghi", danh sách các điểm cuối có sẵn sẽ được hiển thị trong trường "Lưu Bản ghi vào" - chọn một điểm mà bạn vừa tạo. Nhấp vào "Chỉ định".
Hình dạng bạn đã tạo sẽ xuất hiện trên canvas. Nhấp vào hình bánh răng để chuyển đến cài đặt của nó.
Trên tab “Giao diện & Phí” l, nhập tiêu đề cho biểu mẫu trong trường “Tiêu đề”. Tại đây, bạn cũng có thể thay đổi giao diện của nó và xem tên mà nó được ghi trong cài đặt.
Trên tab "Dữ liệu" - thông tin về chế độ của biểu mẫu và điểm cuối. Cũng tại đây, bạn có thể thay đổi vị trí của các trường bằng cách di chuyển chúng tương đối với nhau.
Sắp xếp các trường theo thứ tự hợp lý: Người gửi, Địa chỉ, Chủ đề, Tin nhắn. Để thay đổi cài đặt chi tiết cho từng trường (ví dụ: tên của nó) - hãy nhấp vào biểu tượng bánh răng bên cạnh nó. Nhấp vào “Lưu” để lưu các thay đổi của bạn.
Thêm nút cho biểu mẫu
Để biểu mẫu hoạt động, bạn cần thêm nút xác nhận gửi. Sử dụng phần tử "Nút" - kéo nó bằng con trỏ chuột đến khu vực bên dưới biểu mẫu.
Mở cài đặt nút bằng cách nhấp vào nó. Trên tab “Giao diện”, thay đổi “Nhãn” (tên của nút sẽ hiển thị trong ứng dụng) và “Tên” (tên sẽ hiển thị trong cài đặt).
Trên tab "Trình kích hoạt", thêm hành động vào trình kích hoạt onClick: trong trường "Mục tiêu", chọn biểu mẫu của bạn, trong trường "Hành động", chọn "Gửi biểu mẫu". Nhấp vào để lưu".
Bảo quản, xuất bản và xác minh
Lưu tất cả các thay đổi đã thực hiện, xuất bản chúng, nhấp vào biểu tượng ứng dụng.
Nhập dữ liệu để gửi tin nhắn. Nếu bạn để trống trường người gửi, tên bạn đã nhập trong cài đặt mô-đun sẽ tự động được thêm vào. Gửi tin nhắn thử nghiệm đến bất kỳ địa chỉ email nào mà bạn có quyền truy cập.
Sau khi gửi, một thông báo xác nhận sẽ xuất hiện và một bức thư với dữ liệu được chỉ định sẽ xuất hiện ở người nhận địa chỉ trong thư mục Hộp thư đến.
Nếu bạn đã làm mọi thứ theo hướng dẫn, nhưng thay vì xác nhận rằng một lỗi xuất hiện hoặc bức thư kết thúc trong thư mục "Thư rác", hãy viết thư cho kênh điện tín hỗ trợ kỹ thuật của chúng tôi.
