Tôi gần đây xây dựng trang landing page đơn giản cho khách hàng muốn nhận email qua trang web mà không chia sẻ email.
Thực tế, tôi chưa bao giờ tự triển khai chức năng đó trước. Tôi luôn dùng nút "Contact Us" đơn giản với thẻ anchor và mailto trong thuộc tính href như sau:
<button> <a href="mailto:myemail@example.com">Contact Me</a> </button> Nhưng cách này có hai bất tiện:
- Buộc cả hai bên, người dùng muốn gửi tin nhắn và chủ trang web nhận, chia sẻ email lẫn nhau. Dù OK với một số, không lý tưởng cho người quan tâm riêng tư.
- Đối với người truy cập, nhấp link buộc họ mở chương trình mail mặc định trên thiết bị, điều đó khó chịu. Đếu họ dùng máy tính công cộng? Đếu chưa đăng nhập? Đếu đơn giản không muốn dùng chương trình mail?
Vâng, kỹ thuật họ có thể lấy email người nhận và gửi qua trình duyệt hoặc nơi họ đăng nhập. Nhưng đó đều là bước thêm và rào cản khiến người dùng nản gửi tin nhắn và doanh nghiệp mất phản hồi hoặc cơ hội tiềm năng.
Vì vậy, chúng tôi chọn form email từ đó người dùng viết tin nhắn và nhấp submit, gửi email cho chủ trang web mà không bao giờ rời khỏi trang.
Tìm kiếm nhanh Google cho thấy có công cụ/tiện ích thứ ba nhúng vào web, nhưng hầu hết có thương hiệu và cần trả phí đăng ký cho tùy chỉnh đầy đủ.
Và trừ khi dùng CMS như WordPress có plugin tích hợp làm được, đó là chi phí định kỳ bất tiện.
Tôi thay vào đó chọn tự code tính năng đó để có toàn quyền kiểm soát.
Với mục đích hướng dẫn này, tôi sẽ tái tạo các bước tôi làm để triển khai chức năng dùng HTML và dịch vụ AWS.
Form HTML
Giữ đơn giản ở đây với form HTML cơ bản không CSS, chỉ test chức năng mong muốn.
<h2>Contact Us</h2> <form> <label for="name">Name:</label> <input name="name" type="text"/><br/><br/> <label for="email">Email:</label> <input name="email" type="email"/><br/><br/> <label for="name">Message:</label> <textarea name="message"></textarea><br/><br/> <input type="submit"/> <div> <p id="result-text"></p> </div> </form> 
Bây giờ muốn xử lý submit với JavaScript.
const form = document.querySelector('form') form.addEventListener('submit', event => { // prevent the form submit from refreshing the page event.preventDefault() const { name, email, message } = event.target console.log('Name: ', name.value) console.log('email: ', email.value) console.log('Message: ', message.value) }) Lúc này, có form lấy input từ người dùng và mã JS chỉ hiển thị kết quả ra console.
Để nó vậy và bắt đầu làm việc backend service nhận dữ liệu form và gửi email với dữ liệu đó.
Tổng Quan Backend
Đi sâu vào AWS và dịch vụ chúng ta dùng và cách.
Như đề cập trong tiêu đề, dùng AWS Lambda và Simple Email Service (SES). SES là dịch vụ nhắn tin serverless cho phép gửi email khi được gọi. AWS Lambda cho phép viết mã server-side thực thi phản hồi sự kiện.
Cũng dùng API Gateway cho phép gọi hàm Lambda qua HTTP.

Trong trường hợp này, khi form submit, quy trình sau xảy ra:
- Trình duyệt (JavaScript) gửi post request, với dữ liệu form trong body request, đến endpoint URL do AWS API Gateway chỉ định
- API Gateway validate request. Sau đó kích hoạt hàm Lambda nhận tham số event. API Gateway đặt dữ liệu form vào thuộc tính body của tham số event.
- Hàm Lambda trích xuất dữ liệu từ event body, dùng dữ liệu xây dựng body email muốn gửi và người nhận. Hàm dùng AWS SDK gọi SES với dữ liệu email.
- Khi SES nhận request sendMail, nó biến dữ liệu email thành email văn bản thực và gửi đến người nhận qua mail server của AWS.
Sau khi email gửi, trình duyệt nhận phản hồi status code 200 và thông báo thành công. Nếu bước nào trong AWS cloud thất bại, phản hồi status code 500.
Bước 1: Cách Thiết Lập SES
Thực tế thiết lập từng bước theo thứ tự ngược, bắt đầu với SES, dễ hơn.
Trong AWS console, vào dịch vụ SES —> nhấp Email Addresses menu bên —> nhấp nút "Verify a New Email Address".

Trong hộp thoại mở ra, nhập địa chỉ email bạn muốn SES đặt làm người gửi khi gửi email.

Điều này gửi email đến địa chỉ bạn nhập với link nhấp để xác minh. Cách AWS biết chủ email đồng ý dùng địa chỉ làm người gửi.
Cho đến khi xác minh email, dashboard SES giữ trạng thái xác minh pending.

Khi chủ email mở email từ AWS và nhấp link xác minh, trạng thái xác minh đổi thành verified (làm mới trang thấy thay đổi).

Đó là tất cả cho SES. Bạn có thể test dịch vụ chọn email đã xác minh trong danh sách và nhấp "Send a Test Email". Cho nhập email người nhận, chủ đề, tin nhắn và gửi.
Email gửi được ký bởi server AWS và địa chỉ xác minh là người gửi. Trông như sau:

Bước 2: Cách Thiết Lập Lambda
Đây là phần vui nhất. Tạo hàm nhận dữ liệu form và gọi SES.
Vẻ đẹp của Lambda function là không lo chạy mã backend trên server 24/7 và bảo trì server. Nó serverless.
Nhưng không nghĩa là không server liên quan. AWS lo phần đó dưới vỏ bọc nên bạn chỉ tập trung viết mã, không bảo trì server. Thêm vào đó, chỉ tính phí theo số lần hàm được gọi và thời gian thực thi, và cực rẻ!
Tạo IAM Role Và Cấu Hình
Trước khi viết lambda function, cần tạo IAM role gắn cho function và cấp quyền (gọi là policies trong AWS) gọi dịch vụ SES.

Từ AWS console, vào dịch vụ IAM —> nhấp Policies menu bên —> nhấp nút "Create Policy".

Trong trang tạo policy, vào tab JSON và dán quyền sau, nhấp Next.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "ses:SendEmail", "ses:SendRawEmail" ], "Resource": "*" } ] } Màn hình thứ ba, đặt tên policy và nhấp "Create Policy".

Bây giờ tạo IAM role gắn cho lambda và liên kết policy quyền vừa tạo.

Từ menu IAM bên, nhấp Roles rồi nhấp "Create role".

Trong màn hình tạo role, đảm bảo type chọn "AWS service" và chọn Lambda case rồi nhấp "Next:Permissions".

Màn hình tiếp, tìm policy tạo trước bằng tên và chọn, nhấp next.

Màn hình review, đặt tên role nhớ được rồi nhấp "Create role".
Bây giờ tạo lambda function mới. Vào dashboard dịch vụ Lambda nhấp "Create Function".

Trong màn hình tạo function, đặt tên function, chọn "Author from scratch", chọn Node.js runtime.
Dưới "Change default execution role" chọn "Use an existing role" rồi chọn tên role tạo bước trước từ "Existing role" dropdown.
Cuối cùng, nhấp "Create function" tạo function.
Viết Mã Và Test

Trong editor, mở file index.js (file thực thi khi lambda gọi), thay nội dung bằng mã sau:
const aws = require("aws-sdk"); const ses = new aws.SES({ region: "us-east-1" }); exports.handler = async function (event) { console.log('EVENT: ', event) const params = { Destination: { ToAddresses: ["your@email.com"], }, Message: { Body: { Text: { Data: `Hello from Lambda!` }, }, Subject: { Data: `Message from AWS Lambda` }, }, Source: "your@email.com", }; return ses.sendEmail(params).promise() }; Lưu ý dòng 2 dùng AWS SDK tạo instance SES. Lý do chọn us-east-1 vì đó là nơi tôi đăng ký & xác minh email. Hãy thay email và dùng region AWS nơi bạn đăng ký email.
Test function, nhấp "Deploy". Sau đó nhấp Test —> Configure test event mở hộp thoại cấu hình test event nơi tạo test event mới.
Trong editor body test event, nhập JSON sau mô phỏng thứ cuối cùng đến từ request trình duyệt. Nhấp create.
{ "body": { "senderName": "Namo", "senderEmail": "namo@trains.com", "message": "I love trains!" } } Bây giờ nhấp test sẽ chạy test vừa tạo. Sẽ mở tab mới editor hiển thị log từ chạy function, trông như sau:

Chú ý object event log hiển thị ở đây dưới Function logs với dữ liệu body dùng trong test event.
Test này cũng nên gửi email đến inbox – xem có xảy ra không.

Đúng, như kỳ vọng. Và xảy ra gần như ngay sau chạy test.
Bây giờ sửa mã function lấy tin nhắn có nghĩa hơn từ test data.
const aws = require("aws-sdk"); const ses = new aws.SES({ region: "us-east-1" }); exports.handler = async function (event) { console.log('EVENT: ', event) // Trích xuất thuộc tính từ event body const { senderEmail, senderName, message } = JSON.parse(event.body) const params = { Destination: { ToAddresses: ["the.benhawy@gmail.com"], }, // Nội suy dữ liệu trong chuỗi để gửi Message: { Body: { Text: { Data: `You just got a message from ${senderName} - ${senderEmail}: ${message}` }, }, Subject: { Data: `Message from ${senderName}` }, }, Source: "the.benhawy@gmail.com", }; return ses.sendEmail(params).promise(); }; Lưu ý quan trọng: khi API Gateway gọi function, nó truyền string vào event.body. Đó là lý do dùng JSON.parse trên event.body, biến thành JSON và trích xuất email, tên, tin nhắn người gửi. Sau đó dùng biến đó trong text email và subject dùng string interpolation.
Nếu test, mã trả lỗi. Vì test truyền object JSON vào event.body và dùng JSON.parse trên JSON, gây lỗi JS.
Buồn thay, editor test không cho truyền string vào event, phải test sau từ nơi khác.
Bước 3: Cách Thiết Lập API Gateway
Tiếp, dịch vụ AWS cuối dùng là API Gateway, cho phép trình duyệt gửi HTTP request đến Lambda function tạo.

Không rời trang lambda function, mở rộng "Function overview" nhấp "Add trigger".

Chọn API Gateway từ dropdown, HTTP API làm API type, "Open" làm security mechanism, tích checkbox CORS. Nhấp "Add".

Bạn được chuyển tab "Configuration" function, hiển thị trigger API Gateway mới tạo. Từ đó, ghi nhớ API endpoint. Đây là URL gọi từ trình duyệt với dữ liệu form.
Quay Lại HTML
Cuối cùng test form xem có gửi email không.
Sửa JavaScript xử lý gửi request khi form submit.
const form = document.querySelector("form"); form.addEventListener("submit", (event) => { // prevent the form submit from refreshing the page event.preventDefault(); const { name, email, message } = event.target; // Dùng API endpoint URL bạn copy bước trước const endpoint = "<https://5ntvcwwmec.execute-api.us-east-1.amazonaws.com/default/sendContactEmail>"; // Dùng JSON.stringify để dữ liệu gửi như string qua HTTP const body = JSON.stringify({ senderName: name.value, senderEmail: email.value, message: message.value }); const requestOptions = { method: "POST", body }; fetch(endpoint, requestOptions) .then((response) => { if (!response.ok) throw new Error("Error in fetch"); return response.json(); }) .then((response) => { document.getElementById("result-text").innerText = "Email sent successfully!"; }) .catch((error) => { document.getElementById("result-text").innerText = "An unkown error occured."; }); }); Bây giờ, khoảnh khắc chân lý: điền form và nhấp submit. Nếu thấy thông báo thành công, email đã gửi.

Vì tôi sở hữu email tin nhắn gửi đến, tôi kiểm tra nhanh inbox thấy nhận email từ chính tôi với chi tiết dùng trong form!

Nếu bạn làm theo, bây giờ bạn có form "Contact Us" hoạt động nhúng vào bất kỳ trang web. Bạn chỉ bị tính phí khi thực sự dùng.
Tôi không biết bạn, nhưng tôi thấy điều này khá tuyệt vời và gần như ma thuật! Và cách thực tế dùng cloud computing/services trong quy trình làm việc.
Tất nhiên bạn tùy chỉnh luồng dùng framework frontend như React hoặc Vue hoặc ngôn ngữ khác cho Lambda như Python hoặc Go.
Trước Khi Đi...
Cảm ơn đã đọc đến đây! Tôi viết bài về JavaScript, phát triển cloud, và trải nghiệm giáo dục & nghề nghiệp tự học. Theo dõi tôi twitter @adham_benhawy nơi tôi tweet về chúng!
Tài Nguyên
- https://aws.amazon.com/premiumsupport/knowledge-center/lambda-send-email-ses/
- https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html
- https://docs.aws.amazon.com/lambda/latest/dg/services-apigateway.html?icmpid=docs_lambda_console