Câu hỏi và câu trả lời về Bulk SMS API

Một API SMS hàng loạt dành cho nhà phát triển: gửi một tin nhắn hoặc một batch lên đến 10,000 số mỗi yêu cầu đến 227 quốc gia qua REST, theo dõi mọi tin nhắn với webhooks được ký và thanh toán cho mỗi tin nhắn từ số dư trả trước. Một console web gửi chiến dịch từ danh sách dán hoặc CSV mà không cần mã.

Các nhóm sản phẩm và kỹ thuật gửi tin nhắn từ hệ thống của họ: mã đăng nhập và đăng ký, cập nhật đơn hàng và giao hàng, nhắc lịch hẹn, cảnh báo thanh toán, thông báo dịch vụ và chiến dịch marketing. Bất kỳ ai có thể thực hiện yêu cầu HTTPS đều có thể sử dụng nó.

227 quốc gia và vùng lãnh thổ, được liệt kê cùng với giá cả trên trang giá và trang quốc gia. Một yêu cầu có thể trộn các quốc gia: mỗi số được định giá theo quốc gia mà nó thuộc về.

Không. Bạn thanh toán cho mỗi segment tin nhắn từ số dư trả trước và không có phí hàng tháng, phí thiết lập hoặc khối lượng tối thiểu. Số dư không có ngày hết hạn.

Tài khoản bắt đầu với số dư bằng không và lần nạp tiền đầu tiên sẽ mở mọi thứ. Lần nạp tiền đầu tiên thêm một khoản thưởng lên đến 40%, vì vậy các tin nhắn đầu tiên có chi phí thấp hơn. Giá cả được công khai và endpoint ước tính cùng với console hiển thị chi phí chính xác trước khi bất kỳ thứ gì được gửi đi.

POST /v1/batches xử lý tối đa 10,000 số mỗi yêu cầu, có thể là một nội dung chung hoặc nội dung riêng cho từng số. Console hỗ trợ 50,000 số mỗi chiến dịch. Danh sách lớn hơn sẽ được chia thành nhiều yêu cầu.

Hàng đợi chạy mỗi 2 giây và xử lý tối đa 1,200 tin nhắn mỗi phút cho mỗi tài khoản, theo thứ tự nhận được. Một tin nhắn đơn lẻ thường được gửi đi trong vài giây sau yêu cầu.

Định dạng E.164 quốc tế: dấu cộng, mã vùng và số điện thoại, ví dụ +14155550123. Khoảng trắng, dấu gạch ngang, dấu ngoặc và tiền tố 00 sẽ được tự động loại bỏ; các số trùng lặp hoặc không thể đọc được sẽ được đặt sang một bên và không tính phí.

Tối đa 10 segments: 1,530 ký tự GSM-7 hoặc 670 Unicode. Mỗi segment chứa 160 ký tự GSM-7 hoặc 70 Unicode; văn bản dài hơn sẽ được chia thành các phần 153 hoặc 67 ký tự và ghép lại trên điện thoại.

Chỉ cần một ký tự ngoài bảng chữ cái GSM-7, như dấu ngoặc kép, emoji hoặc chữ cái như á, ç, sẽ chuyển toàn bộ văn bản sang Unicode với 70 ký tự mỗi segment. Trình soạn thảo console sẽ chỉ ra các ký tự này, và POST /v1/estimates trả về định dạng mã hóa trước khi gửi.

Có. Thêm send_at vào yêu cầu API, hoặc chọn thời gian trong console, từ 2 phút đến 45 ngày sau. Một lô tin nhắn đã lên lịch có thể hủy cho đến khi bắt đầu gửi, và toàn bộ chi phí sẽ được hoàn lại vào số dư.

Có. Qua API, gửi một lô tin nhắn với cấu trúc {to, text} cho mỗi người nhận. Trong console, dán hoặc tải lên danh sách có cột bổ sung và sử dụng merge fields {{1}} đến {{9}} trong nội dung.

Thiết lập nội dung từ chối nhận tin một lần trong Cài đặt, ví dụ liên kết hoặc địa chỉ email, và console sẽ thêm vào chiến dịch khi bạn tích chọn. Qua API bạn kiểm soát toàn bộ nội dung, nên tự thêm dòng này vào tin nhắn marketing. Số trong danh sách không gửi sẽ bị bỏ qua bởi cả console và API, và không tính phí.

Có. Console có tính năng gửi thử đến một số trước khi chạy chiến dịch, và qua API bạn có thể gửi một tin nhắn đến điện thoại của mình bằng POST /v1/messages.

Mỗi tin nhắn chuyển từ trạng thái queued sang sent rồi delivered hoặc failed. Thêm URL webhook trong console để nhận sự kiện có chữ ký cho mỗi trạng thái cuối, hoặc truy vấn GET /v1/messages/{id} và GET /v1/batches/{id}.

Theo chuẩn Standard Webhooks: headers webhook-id, webhook-timestamp và webhook-signature, với chữ ký là HMAC-SHA256 của id, timestamp và body nguyên bản dùng khóa whsec_. Tài liệu có mã xác thực cho Node.js, Python, PHP và Go.

Mỗi sự kiện được thử tối đa 10 lần trong 24 giờ, mỗi lần thử đều ghi lại trong console với mã HTTP. Bạn cũng có thể truy vấn endpoint tin nhắn bất cứ lúc nào.

Thiết bị có thể tắt quá lâu, số điện thoại không còn hoạt động, hoặc mạng từ chối tin nhắn. Trạng thái failed kèm mã lỗi và số tiền được hoàn lại.

Các lô tin nhắn, tin nhắn và sổ cái số dư được lưu trong tài khoản và API. Nhật ký request ghi 500 lần gọi API gần nhất, nhật ký webhook ghi 500 lần gửi gần nhất.

Có. Trong console, bạn có thể dán số điện thoại hoặc tải lên một file CSV với tối đa 50,000 dòng, viết nội dung với các trường hợp nhất, kiểm tra bản xem trước cho từng người nhận và chi phí theo quốc gia, sau đó gửi ngay hoặc đặt lịch gửi.

Số dư, các batch gần đây với số lượng trực tiếp, từng batch với các tin nhắn và trạng thái của nó, nạp tiền và sổ cái, khóa API, cài đặt và giao nhận webhook, nhật ký yêu cầu, bảng giá, vé hỗ trợ và cài đặt.

Từ trang Hỗ trợ trong console. Câu hỏi về thanh toán có thể được đặt từ ngày đầu tiên; các chủ đề khác sẽ mở sau khi lần nạp tiền đầu tiên được ghi nhận.