Tính năng là gì
Beta (thử nghiệm), chưa mở cho khách hàng. Hỗ trợ tương tác là tính năng bổ sung tặng kèm theo gói trả phí của MADIAD Hub. Mỗi kỳ gói, tài khoản có gói trả phí đang hiệu lực nhận một mức credits. Bạn dùng credits đó để đặt đơn tăng tương tác (ví dụ lượt thích) cho bài viết hoặc trang của chính bạn trên mạng xã hội.- Không thu thêm khoản tiền nào ngoài giá gói. Credits đi kèm gói, không quy đổi thành tiền.
- Tính năng đang ở giai đoạn thử nghiệm: kết quả của một đơn có thể chậm, lệch hoặc gián đoạn. Đơn nào chạy thiếu hay không chạy thì được hoàn credits (xem Trạng thái đơn).
- Điều khoản của tính năng nằm ở mục 3 Điều khoản sử dụng: giá trị, hạn dùng và cách hoàn credits. Trang Hỗ trợ tương tác của dashboard cũng có liên kết tới mục này.
Ai có credits
Beta (thử nghiệm), chưa mở cho khách hàng.
Khi kỳ này không có credits, dashboard nói rõ lý do bằng một câu (ví dụ “Gói dùng thử và kỳ gói 0 đồng không kèm credits Hỗ trợ tương tác.”), và API trả mã lý do trong trường
reason (xem Dùng qua API).
Kỳ gói và hạn dùng credits
Beta (thử nghiệm), chưa mở cho khách hàng.- Kỳ gói dài một tháng, tính từ ngày thanh toán của bạn theo giờ Việt Nam. Gói 6 tháng và 12 tháng cũng làm mới credits hằng tháng, không nhận một lần cho cả gói.
- Credits không dùng hết sẽ hết hạn cùng kỳ, không cộng dồn sang kỳ sau.
- Kỳ cuối của gói kết thúc đúng lúc gói hết hạn. Dashboard ghi rõ khi bạn đang ở kỳ cuối.
- Gia hạn trước hạn: kỳ gói mới bắt đầu ngay từ lần thanh toán đó, với trọn mức credits của kỳ. Phần còn lại của kỳ cũ không dùng tiếp được.
- Ngày bắt đầu và ngày kết thúc của kỳ hiện tại hiện trên trang Hỗ trợ tương tác của dashboard, giờ Việt Nam.
Đặt đơn
Beta (thử nghiệm), chưa mở cho khách hàng. Trên dashboard, mục Hỗ trợ tương tác (cuối nhóm Nội dung) có danh sách những gì đặt được trong kỳ, số credits còn lại, form đặt đơn và lịch sử đơn.- Dán liên kết bài viết hoặc trang: một địa chỉ
https://, dài tối đa 2.048 ký tự. Form tự nhận ra liên kết thuộc nền tảng nào (Facebook, Instagram…). - Chọn loại tương tác của nền tảng đó, ví dụ lượt thích. Danh sách loại đang có hiện trong dashboard. Bạn không cần chọn gì thêm: phần chạy đơn do MADIAD lo.
- Nhập số lượng trong khoảng tối thiểu đến tối đa. Form hiện ngay số credits đơn sẽ dùng và số credits còn lại sau đơn.
- Đặt đơn. Credits được giữ ngay khi đơn được nhận. Đơn thường được gửi đi trong vài phút, và trạng thái cập nhật trong lịch sử đơn.
Trạng thái đơn
Beta (thử nghiệm), chưa mở cho khách hàng.
Với
unknown, dashboard ghi đúng câu: “Chưa rõ kết quả, credits đang được giữ và sẽ được hoàn nếu xác nhận đơn không chạy.” MADIAD chỉ hoàn khi đã có bằng chứng đơn không chạy, nên trạng thái này có thể giữ lâu hơn các trạng thái khác.
Credits hoàn về kỳ nào. Đơn đã gửi đi (chạy thiếu, bị huỷ, bị từ chối, hay chưa rõ rồi xác nhận không chạy) hoàn vào kỳ gói hiện tại của bạn, kể cả khi đơn được đặt ở kỳ trước. Đơn chưa kịp gửi đi hoàn về kỳ đã giữ chỗ cho đơn đó. Không có nút huỷ hay hoàn đơn bằng tay: credits chỉ được hoàn theo kết quả thật của đơn.
Khi tính năng gián đoạn, tạm ngừng hoặc ngừng
Beta (thử nghiệm), chưa mở cho khách hàng. Đầu trang Hỗ trợ tương tác có một băng thông báo khi tính năng không ở trạng thái bình thường. Có thông báo công khai thì băng có liên kết “Xem thông báo”.
Credits trong từng trường hợp này theo điều khoản sử dụng của tính năng.
Dùng qua API
Beta (thử nghiệm), chưa mở cho khách hàng.Các đường dẫn dưới đây chỉ trả lời khi tính năng đã mở cho tài khoản của bạn. Phần Tham chiếu API của chúng được thêm vào khi tính năng mở. Mọi câu trả lời theo cách của Lỗi.
Gửi lại cùng
Idempotency-Key với cùng nội dung thì nhận lại đúng đơn cũ, không trừ thêm credits (xem Idempotency). Cùng khoá mà nội dung khác thì nhận 409 idempotency_conflict. Các đường dẫn này chỉ đọc header Idempotency-Key (không nhận X-Idempotency-Key hay X-Request-Id), và lần gửi lại không kèm header Idempotent-Replayed: câu trả lời là chính đơn đó, 202 nếu đơn còn chờ gửi, 200 nếu không.
Khi tính năng đã mở cho tài khoản, GET /v1/usage có thêm khối boost_credits:
Các câu trả lời lỗi riêng của nhóm này:

