Vòng đời của một tin nhắn
Sau khi bạn gửi, mỗi người nhận được đưa vào hàng đợi và trừ tiền (queued), rồi được chuyển cho tuyến nhà mạng (sent). Sau đó nhà mạng báo điện thoại đã nhận được tin (delivered) hay chưa (failed).
Khi nào có báo cáo
Phần lớn báo cáo đến trong vài giây đến vài phút. Một số nhà mạng báo muộn hoặc không báo; tin nhắn không có báo cáo sẽ giữ trạng thái sent.
Hoàn tiền
Tin gửi thất bại được tự động hoàn vào số dư. Bạn có thể xem từng khoản hoàn tiền trong lịch sử số dư, kèm id tin nhắn.
Nhận webhook
Thêm một địa chỉ https trên trang Khóa API. Khi tin nhắn được gửi đến hoặc thất bại, chúng tôi gửi POST một nội dung JSON gồm id tin nhắn, số điện thoại, trạng thái, giá và ref của bạn. Trả về bất kỳ trạng thái 2xx nào; nếu không, chúng tôi thử lại tối đa 8 lần trong khoảng hai giờ.
Kiểm tra chữ ký
Mỗi webhook có X-PortSMS-Signature: t=<time>,v1=<hex>. Tính HMAC-SHA256 của chuỗi t.body với khóa bí mật ký của bạn và so sánh với v1. Từ chối các yêu cầu cũ hơn năm phút để yêu cầu cũ không thể bị phát lại.
