Theo dõi
Trạng thái tin nhắn và báo cáo giao hàng
| status | Ý nghĩa | Cuối cùng | Đã tính phí |
|---|---|---|---|
| scheduled | Đang chờ send_at. | No | Có, được hoàn tiền nếu hủy |
| queued | Đã chấp nhận và đang chờ lượt xử lý tiếp theo (mỗi 2 giây). | No | Yes |
| sent | Đã chuyển đến mạng; đang chờ báo cáo giao nhận. | No | Yes |
| delivered | Thiết bị đã xác nhận nhận tin nhắn. | Yes | Yes |
| failed | Không thể gửi; lỗi sẽ cho biết lý do. | Yes | Không, đã hoàn tiền |
| canceled | Lô đã lên lịch bị hủy. | Yes | Không, đã hoàn tiền |
Mã lỗi trên tin nhắn
| error.code | Ý nghĩa |
|---|---|
| network_error | Không thể chuyển tin nhắn đến mạng. Số tiền đã được hoàn vào số dư. |
| undeliverable | Mạng báo cáo không thể kết nối đến thiết bị. |
| canceled | Lô đã lên lịch bị hủy trước khi bắt đầu. |
Hoàn tiền
Khi tin nhắn thất bại, toàn bộ số tiền sẽ được hoàn vào số dư ngay lập tức, dưới dạng một dòng hoàn tiền trong sổ cái ghi rõ lô. Trường refunded của lô hiển thị tổng số tiền đã hoàn.
Webhooks hoặc polling
Webhooks là cách nhanh nhất: mỗi trạng thái cuối cùng sẽ gọi đến endpoint của bạn ngay khi được thiết lập. Đối với khối lượng nhỏ hoặc để kiểm tra lại, có thể poll GET /v1/messages/{id} hoặc GET /v1/batches/{id}; giới hạn tốc độ cho phép cả hai.