Agent skill cho Adapty Mail

Skill adapty-mail giúp bạn vận hành dự án Adapty Mail ngay từ công cụ AI coding. Nó hoạt động thông qua Adapty Mail MCP server, đăng nhập bằng tài khoản của bạn. Skill này có thể khởi chạy các flow, dịch chiến dịch, hướng dẫn cấu hình DNS và xác minh sending domain, đọc kết quả chiến dịch và A/B test, cũng như tìm hiểu lý do tại sao một người dùng không nhận được email.

The MCP server alone gives your agent the tools. The skill adds what an agent gets wrong without it:

• Kết nối server: Xác minh xem server đã được kết nối và đăng nhập chưa. Nếu chưa, skill sẽ cung cấp bước thiết lập cho client của bạn.
• Mail hay phần còn lại của Adapty: Flow, phân khúc và hồ sơ người dùng có nghĩa khác nhau trong Adapty Mail và trong paywall in-app của Adapty. Skill sẽ làm rõ bạn đang nói đến cái nào trước khi thực hiện bất kỳ thay đổi nào.
• Những gì chỉ dashboard mới làm được: Skill sẽ cho bạn biết khi nào một yêu cầu cần địa chỉ công ty, web checkout, hoặc bật tính năng gửi dữ liệu, đồng thời cung cấp liên kết đến trang hướng dẫn tương ứng.
• Công việc sau khi ra mắt: Kết quả, A/B test, khả năng gửi email và theo dõi email bị thiếu.

Cài đặt skill

Skill adapty-mail là một phần của adapty-skills plugin.

Để cài đặt plugin, chạy lệnh sau trong terminal:

npx adapty skills install

Khởi động lại agent để tải các skill. Để xem các phương thức cài đặt khác, hãy xem README của plugin.

Claude Code không tự động cập nhật plugin. Để nhận các skill mới khi chúng được phát hành, trong Claude Code, chạy /plugin, mở Marketplaces, chọn adapty, rồi chọn Enable auto-update. Để xem lệnh cập nhật cho các agent khác, hãy xem README của plugin.

Skill này cần có Adapty Mail MCP server. Nếu agent của bạn chưa có, hãy yêu cầu nó kết nối Adapty Mail. Skill sẽ cung cấp lệnh cho client của bạn, và bạn xác nhận kết nối trong Adapty Mail dashboard. Các bước thực hiện cho từng client được mô tả trong Quản lý Adapty Mail bằng AI assistants.

Bạn có thể hỏi gì

• “Kết nối Adapty Mail và cho tôi biết project của tôi đang thiếu gì.”
• “Thiết lập flow thu hút khách hàng cũ cho những người dùng có gói đăng ký đã hết hạn.”
• “Dịch chiến dịch về vấn đề thanh toán của tôi sang tiếng Đức và tiếng Tây Ban Nha.”
• “Thêm domain của chúng tôi làm sending domain và hướng dẫn tôi qua các bản ghi DNS.”
• “Chiến dịch nào của tôi có tỷ lệ chuyển đổi tốt nhất tháng trước?”
• “A/B test trên flow never-purchased của tôi đã chạy được ba tuần. Biến thể nào nên thắng?”
• “Tại sao người này không nhận được email trial-expired của chúng tôi?”

Flow: Never purchased, marketing
1. Paid trial users → Trial nudge         (unchanged)
2. Germany → Welcome series DE            (new)
3. All users → Welcome series             (moved from 2)
Removed: nothing

Cách hoạt động

1. Kết nối. Skill xác minh rằng máy chủ MCP đang phản hồi và bạn đã đăng nhập.
2. Định hướng. Skill tìm project của bạn và đọc những gì đã được thiết lập: thương hiệu, địa chỉ công ty, domain gửi mail, campaigns, flow và thời điểm dữ liệu đến lần cuối. Skill sẽ tái sử dụng những gì đã có.
3. Lập kế hoạch. Skill liệt kê những việc chỉ bạn mới có thể làm trên dashboard trước khi bắt đầu.
4. Thực thi. Skill xử lý từng bước thông qua các công cụ của máy chủ và hiển thị kết quả cho bạn. Bất kỳ thao tác nào gửi email đến người thật hoặc không thể hoàn tác đều sẽ chờ xác nhận từ bạn.

Tại sao một email không được gửi

Khi bạn hỏi về một người cụ thể, skill sẽ đọc hồ sơ người dùng và hành trình của hồ sơ đó, sau đó kiểm tra từng lý do theo thứ tự dưới đây và dừng lại ở lý do đầu tiên giải thích được vấn đề:

1. Hồ sơ người dùng bị chặn: đã hủy đăng ký, bị trả về, bị khiếu nại, hoặc không vượt qua xác minh địa chỉ. Xem Hủy đăng ký và chặn gửi.
2. Người dùng đang trong một flow marketing khác.
3. Người dùng đã mua, nên chuỗi đã kết thúc đúng như thiết kế.
4. Giới hạn gửi đã giữ lại email trong quá trình khởi động domain.
5. Trigger chưa kích hoạt. Có thể không có sự kiện mua nào được gửi đến Adapty Mail, hoặc hồ sơ người dùng đã được thêm vào trước khi thiết lập hoàn tất.
6. Không có phân khúc nào trong flow khớp với người dùng này.
7. Double opt-in đang bật và người dùng chưa xác nhận địa chỉ.
8. Email vẫn đang được lên lịch cho khung thời gian gửi theo múi giờ của người dùng.