Xử lý sự cố Email, Chiến dịch và Cronjob

Trong quá trình vận hành hệ thống Marketing Automation trên ABOT, người dùng có thể gặp các tình huống chiến dịch không tự động gửi thư hoặc gửi email phát sinh lỗi kỹ thuật. Tài liệu này hướng dẫn cách kiểm tra và khắc phục nhanh chóng.

---

1. Chiến dịch (Campaign) đã kích hoạt nhưng Email không tự động gửi

Biểu hiện:

Bạn đã thiết lập chiến dịch tự động, có khách hàng lọt vào phân khúc (Segment), nhưng bước gửi email tiếp theo không thấy thực thi, hoặc email nằm mãi ở trạng thái chờ.

Nguyên nhân:

Hệ thống Automation của ABOT hoạt động dựa trên các tiến trình chạy ngầm định kỳ (Cronjobs). Nếu cronjob trên máy chủ bị dừng hoặc chưa được cấu hình, chiến dịch sẽ không thể kích hoạt các bước hành động.

Cách kiểm tra và xử lý:

1. Kiểm tra nhật ký Contact: Vào chi tiết một Contact trong chiến dịch ➡️ Bấm vào tab Audit Log (Nhật ký kiểm tra) hoặc Campaigns ở cột bên phải để xem contact đã được thêm vào chiến dịch chưa và đang dừng ở bước nào.

2. Kiểm tra các lệnh Cronjob bắt buộc: Đảm bảo trên máy chủ (crontab của người dùng www hoặc root) đã kích hoạt đầy đủ các lệnh sau:

   • Cập nhật phân khúc (Segments): php bin/console mautic:segments:update (Chạy mỗi 15 phút)

   • Đưa liên hệ vào chiến dịch (Campaign Rebuild): php bin/console mautic:campaigns:rebuild (Chạy mỗi 15 phút)

   • Kích hoạt các hành động gửi email/tin nhắn trong chiến dịch: php bin/console mautic:campaigns:trigger (Chạy mỗi 5 phút)

   • Gửi thư từ hàng đợi (Spool): php bin/console mautic:emails:send (Chạy mỗi 5 phút)

---

2. Lỗi Unknown DSN scheme khi gửi Email qua Amazon SES trên ABOT 7.x

Biểu hiện:

Khi bấm gửi thử email hoặc khi chiến dịch gửi thư, hệ thống thông báo lỗi:

The "ses+smtp" scheme is not supported, or Unknown DSN scheme. Please make sure the mailer DSN is configured properly.

Nguyên nhân:

Trên phiên bản ABOT 7.x (Symfony 7 / PHP 8.4):

1. Thư viện tích hợp symfony/amazon-mailer chưa được cài đặt trong vendor.

2. Hoặc mật khẩu SMTP của Amazon SES có chứa các ký tự đặc biệt (/, +, =) chưa được mã hóa URL (URL-encoded) khi kết nối DSN.

Cách xử lý:

• Yêu cầu quản trị viên hệ thống chạy lệnh cài đặt thư viện hỗ trợ SES:

  composer require symfony/amazon-mailer --update-no-dev

• Trong file cấu hình config/local.php, đảm bảo mật khẩu SMTP đã được mã hóa bằng hàm urlencode($smtp_password).

---

3. Email bị tỷ lệ Trả về (Bounce Rate) cao hoặc bị đánh dấu Spam

Biểu hiện:

Số lượng email gửi đi không đến được hộp thư người nhận hoặc tỷ lệ rơi vào thư mục Rác/Spam vượt quá 5%.

Nguyên nhân & Cách xử lý:

1. Thiếu bản ghi xác thực tên miền DNS:

   • Bắt buộc kiểm tra và cấu hình đầy đủ SPF, DKIM và DMARC theo hướng dẫn trong tài liệu Xác thực DNS cho tên miền.

2. Danh sách liên hệ bị cũ hoặc chất lượng kém:

   • Bật cơ chế Do Not Contact (Không liên hệ lại) tự động khi email bị Hard Bounce.

   • Lọc và loại bỏ các contact không mở bất kỳ email nào trong vòng 6 tháng qua.

3. Nội dung email vi phạm bộ lọc Spam:

   • Tránh sử dụng quá nhiều chữ IN HOA ở tiêu đề (ví dụ: KHUYẾN MÃI CỰC KHỦNG DUY NHẤT HÔM NAY).

   • Tỷ lệ hình ảnh và văn bản phải cân đối (tránh gửi một bức ảnh duy nhất mà không có nội dung chữ).

   • Bắt buộc có liên kết Hủy đăng ký (Unsubscribe Link): Luôn chèn thẻ {unsubscribe_url} ở chân trang email.