SendGrid API và cách sử dụng trong Rails

Thứ Sáu, 22/01/2021

Tram Ho

Giới Thiệu

1. SendGrid là gì?

SendGrid là một trong số các nhà cung cấp dịch vụ Email Marketing hàng đầu thế giới. Bên cạnh đó, dịch vụ SMTP Server miễn phí của họ cũng được nhiều người sử dụng và đánh giá cao.
Thông thường, khi dùng WordPress hoặc các mã nguồn khác, chúng ta sử dụng luôn thông tin SMTP của Hosting để gửi mail notification. Tuy nhiên, do IP Hosting dùng chung với hàng trăm website khác nên khả năng rất cao bị blacklist, gửi mail bị chuyển vào Spam.
Thậm chí tồi tệ hơn, một số nhà cung cấp còn chặn gửi mail để bảo vệ server, nếu không để ý bạn sẽ không thể biết được thông tin này.
Khi sử dụng SMTP Server chuyên dụng, bạn sẽ hạn chế được giới hạn này, gửi mail nhanh hơn, vào chuẩn Inbox luôn mà không lạc vào Spam.
Trước đây, SendGrid cho phép sử dụng hoàn toàn miễn phí với giới hạn 12,000 email/tháng nhưng hiện tại chúng ta chỉ có thể dùng thử FREE 1 tháng mà thôi. Gửi được tối đa 40,000 email trong vòng 30 ngày đầu. Sau đó, phí mỗi tháng sẽ từ 9.95$, phụ thuộc vào số lượng email muốn gửi đi.
Với chất lượng ổn định, khả năng delivery cao của SendGrid nên được rất nhiều blogger lớn và doanh nghiệp tin tưởng sử dụng.

2. Đăng ký tài khoản SendGrid và API key

Các bạn có thể tham khảo ở Link này , khá là chi tiết và rõ ràng
Làm theo các bước trên ta sẽ có API để tiếp tục các bước tiếp theo

3. Tạo lib mailer

Hiện nay SendGrid đã có gem hỗ trợ có thể import vào dự án, các bạn có thể tham khảo cách sử dụng ở đây Link
Nhưng để dễ hiểu và nhanh gọn mình sẽ hướng dẫn các bạn xây dựng 1 lib mailer nhỏ ,sử dụng cURL để gọi API v3 SendGrid.
Trước tiên khởi tạo một lib:
- path: /lib/send_grid_mailer.rb
- Các bạn nhớ autoload lib config ở application.rb,bạn nào chưa biết có thể xem thêm ở đây
Bắt đầu code thôi

class SendGridMailer
   def self.send(subject, from, to, message_text, message_html) 
     begin
       @api_key = "SG.xxxxx"
       url = "https://api.sendgrid.com/v3/mail/send"
       if @proxy.blank?
         http_client = HTTPClient.new(default_header: { "Content-Type" =&gt; "application/json", "Authorization" =&gt; "Bearer #{@api_key}" })
       else
         http_client = HTTPClient.new("http://#{@proxy.ip_address}:#{@proxy.port}", default_header: { "Content-Type" =&gt; "application/json", "Authorization" =&gt; "Bearer #{@api_key}" })
         http_client.set_proxy_auth(@proxy.user_name, @proxy.password)
       end
       data = {
         personalizations: [
           {
             to:[
               email: to.to_s
             ]
           }
         ],
         from: { email: from.to_s},
         subject: subject,
         content: [
           {
             type: "text/html",
             value: message_html
           },
           {
             type: "text/text",
             value: message_text
           }
         ],          
       }
       data = data.to_json
       result = http_client.post(url, data)
       if (result.header.status_code == 200 || result.header.status_code == 202)
         #Xử lí thành công
       else  
         #Xử lí thất bại
       end
     rescue
       #Xử lí ngoại lệ 
     end
   end
end

class SendGridMailer

def self.send(subject, from, to, message_text, message_html)

begin

@api_key = "SG.xxxxx"

url = "https://api.sendgrid.com/v3/mail/send"

if @proxy.blank?

http_client = HTTPClient.new(default_header: { "Content-Type" => "application/json", "Authorization" => "Bearer #{@api_key}" })

else

http_client = HTTPClient.new("http://#{@proxy.ip_address}:#{@proxy.port}", default_header: { "Content-Type" => "application/json", "Authorization" => "Bearer #{@api_key}" })

http_client.set_proxy_auth(@proxy.user_name, @proxy.password)

end

data = {

personalizations: [

{

to:[

email: to.to_s

]

}

from: { email: from.to_s},

subject: subject,

content: [

{

type: "text/html",

value: message_html

{

type: "text/text",

value: message_text

}

data = data.to_json

result = http_client.post(url, data)

if (result.header.status_code == 200 || result.header.status_code == 202)

#Xử lí thành công

else

#Xử lí thất bại

end

rescue

#Xử lí ngoại lệ

end

Tham số truyền vào lib gồm có :subject, :from, :to, :message_text, :message_html
Mình giải thích thêm tý để mọi người rõ hơn các tham số này:

subject: Là subject của email mà mình muốn gửi đi.
from: Địa chỉ mail của người gửi, exp: “[email protected]“.
to: Địa chỉ mail của người nhận, exp: “[email protected]“.
message_text: Nội dung email gửi đi dạng text
message_html: Nội dung email có thể gửi dưới code dạng html.

Ở phần code trên có mình có sử dụng biến proxy , nó là biến của HTTPClient các bạn có thể xem thêm ở đây nếu muốn biết rõ hơn.

và biến api_key = “SG.xxxxx” chính là api_key bên SendGrid cung cấp cho mình khi tạo account.
Cuối cùng là cách gọi nó ra thôi:

SendGridMailer.send(subject, from, to, content, content_html)

1 2	SendGridMailer.send(subject, from, to, content, content_html)

Nhớ truyền đủ các tham số các bạn nhá =)))

4. Kết Luận

Trên đây là một cách trong rất nhiều cách mà các bạn có thể dùng với SendGrid, đây cũng là một cách thuận tiện và nhanh chóng và dễ dàng tìm hiểu cho các bạn mới bắt đầu

Chúc các bạn sử dụng thành công =))))

Link tài liệu :

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo

SendGrid API và cách sử dụng trong Rails

Giới Thiệu

1. SendGrid là gì?

2. Đăng ký tài khoản SendGrid và API key

3. Tạo lib mailer

4. Kết Luận

TikTok trở thành nền tảng mảng xã hội lớn thứ hai ở Nam Phi

Mất giá nhanh nhất sau 9 tháng ra mắt, iPhone 14 Pro Max tiếp tục phá đáy tại Việt Nam

Hướng dẫn sử dụng ngôn ngữ R cho người mới bắt đầu

10 plugin cần thiết của SublimeText dành cho các lập trình viên JavaScript