Gửi email giao dịch đầu tiên

Trong khoảng 10 phút, bạn gửi email giao dịch qua API: hướng dẫn gửi lần đầu đưa bạn đi từ người gửi đến một thư đã gửi thành công, và bước cuối của hướng dẫn kiểm chứng toàn bộ quy trình bằng một lệnh gọi thật từ ứng dụng của bạn.

Trước khi bắt đầu

• Một nhà cung cấp gửi thư đã kết nối với không gian làm việc. Hướng dẫn sẽ yêu cầu bạn kết nối nếu chưa có.
• Một tên miền gửi thư mà bạn có thể thêm bản ghi DNS. Một tên miền con riêng, như notify.example.com, giữ uy tín của thư sản phẩm tách biệt với bản tin của bạn. Xem thêm tên miền gửi thư và người gửi.
• Quyền: transactional:publish để xuất bản mẫu và apikeys:manage để tạo khóa. Các vai trò Chủ sở hữu và Quản trị viên có cả hai quyền.
• curl hoặc HTTP client trong ứng dụng của bạn để thực hiện lệnh gọi đầu tiên.

Gửi thư

1. Mở Giao dịch rồi chọn Bắt đầu hướng dẫn gửi lần đầu. Hướng dẫn có năm bước: Người gửi, Tuyến, Mẫu, Khóa và Xem thư đến. Bạn có thể rời hướng dẫn bằng Thoát hướng dẫn bất cứ lúc nào.

2. Người gửi. Nhập Tên người gửi và Địa chỉ người gửi trên tên miền dùng để gửi thư giao dịch. Nếu tên miền còn mới, hướng dẫn liệt kê các bản ghi DNS cần có (DKIM, return path, SPF và một chính sách DMARC, tùy nhà cung cấp gửi thư) và kiểm tra chúng trực tiếp. Hầu hết dịch vụ DNS chỉ mất vài phút. Khi đã kết nối HostRepute, bạn có thể thêm tên miền vào chế độ giám sát danh sách chặn của HostRepute ngay tại đây.

   

   Ảnh chụp này hiển thị giao diện tiếng Anh.

   Chọn Tiếp tục đến tuyến.

3. Tuyến. Chọn nhà cung cấp gửi thư Chính và, nếu có nhà cung cấp thứ hai, một nhà cung cấp Dự phòng. Nhà cung cấp dự phòng được dùng ngay khi nhà cung cấp chính gặp sự cố. Để Ưu tiên trên nhà cung cấp dùng chung bật, để thư giao dịch đi trước chiến dịch dùng chung nhà cung cấp gửi thư đó. Chọn Tiếp tục đến mẫu.

4. Mẫu. Bắt đầu từ một mẫu khởi đầu: Đặt lại mật khẩu, Liên kết đăng nhập, Xác minh email, Chào mừng, Biên nhận hoặc hóa đơn, Sắp hết thời gian dùng thử, Lời mời vào nhóm hoặc Cảnh báo mức sử dụng. Mỗi mẫu có sẵn các biến đã khai báo và chân thư dành cho email tài khoản. Chọn Xuất bản v1 và tiếp tục, hoặc Sửa trước khi xuất bản để thay đổi trước trong trình soạn mẫu. Nếu mẫu của bạn đang ở Postmark, SendGrid, Mailgun hoặc Notifuse, bạn có thể nhập chúng thay vì tạo mới.

5. Khóa. Đặt tên cho khóa (ví dụ Acme Cloud · chính thức) rồi chọn Tạo khóa chỉ gửi. Một khóa chỉ gửi chỉ có transactional:send và không có quyền nào khác. Hãy sao chép khóa ngay: nó chỉ hiển thị một lần. Sau đó chọn Tôi đã sao chép · xem thư đến.

6. Xem thư đến. Hướng dẫn hiển thị Lệnh gọi đầu tiên của bạn, đã điền sẵn ID mẫu và dữ liệu mẫu. Chạy lệnh gọi này từ máy tính hoặc ứng dụng của bạn với khóa vừa sao chép. Yêu cầu trông như sau; hãy lấy phần thân chính xác từ hướng dẫn, vì nó chứa các biến của mẫu bạn chọn:

   Terminal

   curl -X POST "https://reputecast.example.com/api/v1/workspaces/acme-newsletter/transactional/messages" \
     -H "Authorization: Bearer $REPUTECAST_KEY" \
     -H "Content-Type: application/json" \
     -H "Idempotency-Key: first-send-1" \
     -d @first-message.json

   Dòng thời gian gửi thư theo dõi thư qua các mốc Đã nhận lệnh gọi, Đã kết xuất, Đã chuyển cho nhà cung cấp gửi thư và Gửi thành công, kèm thời gian khứ hồi từ lệnh gọi của bạn đến sự kiện gửi thành công. Nếu không muốn tự chạy lệnh gọi, Gửi từ đây thay vào đó gửi thư tới địa chỉ của chính bạn với dữ liệu mẫu.

7. Chọn Hoàn tất khi thư đầu tiên đã được gửi thành công.

Bạn đã làm được gì

• Một người gửi đã xác minh cho thư giao dịch và một tuyến Giao dịch có chuyển dự phòng tự động.
• Một mẫu đã xuất bản mà ứng dụng của bạn gọi bằng ID. ID được cố định sau lần xuất bản đầu tiên này.
• Một khóa chỉ gửi cho ứng dụng của bạn, được liệt kê trong Giao dịch › , rồi Thiết lập, nơi bạn có thể xoay vòng hoặc thu hồi khóa.
• Thư đầu tiên trong nhật ký thư, với đầy đủ dòng thời gian.

Nếu lệnh gọi bị từ chối, dòng thời gian cho biết lý do. Một mẫu có bản nháp nhưng chưa có phiên bản đã xuất bản thì không gửi được: hãy xuất bản mẫu, rồi gọi lại với cùng khóa idempotency.

Bước tiếp theo

Gửi email giao dịch bằng APIGửi theo lô, hẹn giờ, tệp đính kèm, idempotency và mã lỗi.

Tạo và xuất bản mẫu email giao dịchBiến, dữ liệu thử và kiểm tra thay đổi gây lỗi khi xuất bản.

Nhận webhookNhận message.delivered, message.bounced và các sự kiện khác trong ứng dụng của bạn.