Tài liệu

Bắt đầu nhanh

1. Đăng ký và thêm miền của bạn

Tạo tài khoản, sau đó thêm miền gửi từ bảng điều khiển. Chúng tôi sẽ cung cấp bản ghi DNS (DKIM và SPF) để thêm vào cài đặt DNS của miền bạn. Sau khi xác minh, bạn đã sẵn sàng gửi.

2. Nhận thông tin xác thực của bạn

Thông tin xác thực SMTP và API key của bạn có sẵn trong bảng điều khiển. Bạn sẽ cần các thông tin này để xác thực khi gửi email.

3a. Gửi qua SMTP

Cấu hình cài đặt SMTP của ứng dụng với những thông tin sau:

SMTP Host:     smtp.mailertogo.com
SMTP Port:     587 (STARTTLS) hoặc 465 (SSL)
Username:      Tên người dùng SMTP của bạn (từ bảng điều khiển)
Password:      Mật khẩu SMTP của bạn (từ bảng điều khiển)

Hầu hết các framework đều có hỗ trợ SMTP tích hợp:

Rails

# config/environments/production.rb
config.action_mailer.smtp_settings = {
  address:         ENV["MAILERTOGO_SMTP_HOST"],
  port:            587,
  user_name:       ENV["MAILERTOGO_SMTP_USER"],
  password:        ENV["MAILERTOGO_SMTP_PASSWORD"],
  authentication:  :plain,
  enable_starttls: true
}

Django

# settings.py
EMAIL_HOST = os.environ.get("MAILERTOGO_SMTP_HOST")
EMAIL_PORT = 587
EMAIL_HOST_USER = os.environ.get("MAILERTOGO_SMTP_USER")
EMAIL_HOST_PASSWORD = os.environ.get("MAILERTOGO_SMTP_PASSWORD")
EMAIL_USE_TLS = True

Node.js (Nodemailer)

const nodemailer = require("nodemailer");

const transport = nodemailer.createTransport({
  host: process.env.MAILERTOGO_SMTP_HOST,
  port: 587,
  auth: {
    user: process.env.MAILERTOGO_SMTP_USER,
    pass: process.env.MAILERTOGO_SMTP_PASSWORD,
  },
});

Laravel

# .env
MAIL_MAILER=smtp
MAIL_HOST="${MAILERTOGO_SMTP_HOST}"
MAIL_PORT=587
MAIL_USERNAME="${MAILERTOGO_SMTP_USER}"
MAIL_PASSWORD="${MAILERTOGO_SMTP_PASSWORD}"
MAIL_ENCRYPTION=tls

3b. Gửi qua REST API

Gửi email với một yêu cầu HTTP duy nhất:

curl -X POST https://api.mailertogo.com/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "you@yourdomain.com",
    "to": "user@example.com",
    "subject": "Hello",
    "html": "<p>Your email body here.</p>"
  }'

Cài đặt miền

Bản ghi DNS

Để gửi từ miền của bạn, hãy thêm các bản ghi DNS được hiển thị trong bảng điều khiển:

• DKIM — Bản ghi TXT cho phép người nhận xác minh email của bạn là xác thực
• SPF — Bản ghi TXT cho phép các máy chủ của chúng tôi gửi thay mặt cho miền của bạn

Các thay đổi DNS có thể mất tới 48 giờ để lan truyền, mặc dù hầu hết hoàn thành trong vài phút. Bảng điều khiển sẽ hiển thị trạng thái xác minh cho từng bản ghi.

Webhooks

Cấu hình URL webhook trong bảng điều khiển để nhận thông báo thời gian thực về các sự kiện email:

• delivered — Email được máy chủ thư của người nhận chấp nhận
• bounced — Email không thể gửi được
• opened — Người nhận mở email (khi bật theo dõi)
• clicked — Người nhận nhấp vào một liên kết (khi bật theo dõi)

Payload webhook được gửi dưới dạng yêu cầu JSON POST. Chúng tôi thử lại các lần gửi không thành công với backoff theo cấp số nhân.

Tích hợp nền tảng

Heroku

Mailer To Go có sẵn dưới dạng add-on Heroku. Cấp phát nó từ Heroku Elements Marketplace, và thông tin xác thực SMTP của bạn sẽ được đặt dưới dạng các biến cấu hình tự động.

Build.io

Mailer To Go cũng có sẵn trên Build.io. Cấp phát nó từ bảng điều khiển Build.io của bạn để cấu hình tự động.

Hỗ trợ

Có câu hỏi? Gửi email cho chúng tôi tại support@mailertogo.com. Kiểm tra trang trạng thái để xem tính khả dụng dịch vụ.