API SMS, API SMPP API Bộ lập lịch MS
Hướng dẫn sử dụng
API SMS, API SMPP API Bộ lập lịch MS
| Đã sửa đổi: | 6/24/2025 |
| Phiên bản: | 1.7 |
| Tác giả: | Kenny Colander Norden, KCN |
Tài liệu này chỉ dành cho người nhận được chỉ định và có thể chứa thông tin đặc quyền, độc quyền hoặc thông tin cá nhân khác. Nếu bạn nhận được nó do lỗi, vui lòng thông báo ngay cho người gửi và xóa bản gốc. Bất kỳ việc sử dụng tài liệu nào khác của bạn đều bị cấm.
Thay đổi lịch sử
| Sửa đổi | Ngày | By | Thay đổi từ bản phát hành trước |
| 1.0 | 2010-03-16 | KCN | Tạo |
| 1. | 2019-06-11 | TPE | Đã cập nhật các logo LINK |
| 1. | 2019-09-27 | PNI | Đã thêm tham chiếu đến thông số kỹ thuật SMPP 3.4 |
| 1. | 2019-10-31 | EP | Quan sát về thời hạn hiệu lực tag |
| 1. | 2020-08-28 | KCN | Đã thêm thông tin về các phiên bản TLS được hỗ trợ |
| 2. | 2022-01-10 | KCN | Đã thêm thông tin bổ sung liên quan đến báo cáo giao hàng Thông tin cập nhật về TLS 1.3 |
| 2. | 2025-06-03 | GM | Đã thêm mã kết quả 2108 |
| 2. | 2025-06-24 | AK | Đã thêm hạn ngạch |
Giới thiệu
LINK Mobility là nhà phân phối SMS từ năm 2001 và có nhiều kinh nghiệm làm việc với cả nhà khai thác và nhà tổng hợp kết nối. Nền tảng này được thiết kế để xử lý lưu lượng truy cập lớn, duy trì tính sẵn sàng cao và giúp dễ dàng định tuyến lưu lượng truy cập qua nhiều kết nối.
Tài liệu này mô tả giao diện SMPP với nền tảng SMSC và các tham số, lệnh cần thiết cũng như các tham số được hỗ trợ.
Tài liệu này sẽ không xử lý các trường hợp sử dụng cụ thể như tin nhắn nối tiếp, WAPpush, Flash SMS, v.v. Bạn có thể liên hệ với bộ phận hỗ trợ để biết thêm thông tin về các trường hợp đó.
Các lệnh được hỗ trợ
Máy chủ của LINK Mobility phải được coi là SMPP 3.4. Thông số kỹ thuật chính thức có thể được tìm thấy tại https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Tất cả các phương pháp không được hỗ trợ và tất cả sự khác biệt được chỉ định bên dưới.
4.1 Ràng buộc
Các lệnh liên kết sau đây được hỗ trợ.
- Máy phát
- người chuyển tiền
- Người nhận
Các thông số bắt buộc:
- system_id – thu được từ bộ phận hỗ trợ
- mật khẩu - lấy từ bộ phận hỗ trợ
Các thông số tùy chọn:
- addr_ton – giá trị mặc định nếu TON được đặt thành Không xác định trong khi gửi.
- addr_npi – giá trị mặc định nếu NPI được đặt thành Không xác định trong khi gửi.
Thông số không được hỗ trợ:
- phạm vi địa chỉ
4.2 Bỏ ràng buộc
Lệnh hủy liên kết được hỗ trợ.
4.3 Truy vấn liên kết
Lệnh truy vấn liên kết được hỗ trợ và sẽ được gọi sau mỗi 60 giây.
4.4 Gửi
Phương thức gửi nên được sử dụng để gửi tin nhắn.
Các thông số bắt buộc:
- nguồn_addr_ton
- nguồn_addr_npi
- địa chỉ nguồn
- dest_addr_ton
- dest_addr_npi
- dest_addr
- esm_class
- mã hóa dữ liệu
- sm_length
- Tin nhắn ngắn
Thông số không được hỗ trợ:
- loại dịch vụ
- giao thức_id
- cờ ưu tiên
- lịch_giao_hàng
- thay thế_if_hiện_flag
- sm_default_msg_id
Ghi chú rằng trọng tải tag không được hỗ trợ và chỉ có thể gửi một tin nhắn SMS cho mỗi cuộc gọi và khuyến nghị rằng thời gian hiệu lực tag có giá trị dài ít nhất 15 phút.
4.4.1 Đề xuất TON và NPI
Nên sử dụng TON và NPI sau đây khi gửi tin nhắn bằng lệnh gửi.
4.4.1.1 Nguồn
Các kết hợp TON và NPI sau đây được hỗ trợ cho địa chỉ nguồn. Tất cả các kết hợp khác sẽ được coi là không hợp lệ. Lệnh TON mặc định từ bind sẽ được sử dụng nếu TON được đặt thành Không xác định (0). Lệnh NPI mặc định từ bind sẽ được sử dụng nếu NPI được đặt thành Không xác định (0).
| TẤN | NIP | Sự miêu tả |
| Chữ và số (5) | Không rõ (0) ISDN (1) |
Sẽ được coi là văn bản người gửi chữ và số |
| Quốc tế (1) | Không rõ (0) ISDN (1) |
Sẽ được coi là MSISDN |
| Quốc gia (2) Mạng cụ thể (3) Số thuê bao (4) Viết tắt (6) |
Không rõ (0) ISDN (1) Quốc gia (8) |
Sẽ được coi là số ngắn cụ thể của quốc gia. |
4.4.1.2 Điểm đến
Các kết hợp TON và NPI sau được hỗ trợ cho địa chỉ đích. Tất cả các kết hợp khác sẽ được coi là không hợp lệ. TON mặc định từ lệnh liên kết sẽ được sử dụng nếu TON được đặt thành Không xác định (0). NPI mặc định từ lệnh liên kết sẽ được sử dụng nếu NPI được đặt thành Không xác định (0).
| TẤN | NIP | Sự miêu tả |
| Quốc tế (1) | Không rõ (0) ISDN (1) |
Sẽ được coi là MSISDN |
4.4.2 Mã hóa được hỗ trợ
Các mã hóa sau đây được hỗ trợ. X có thể chứa bất kỳ giá trị nào.
| DCS | Mã hóa |
| 0xX0 | Bảng chữ cái GSM mặc định có phần mở rộng |
| 0xX2 | 8-bit nhị phân |
| 0xX8 | UCS2 (ISO-10646-UCS-2) |
hạn ngạch
5.1 Vượt quá hạn ngạchview
Hạn ngạch xác định số lượng tin nhắn SMS tối đa có thể được gửi trong một khoảng thời gian nhất định (chẳng hạn như mỗi ngày, tuần, tháng hoặc vô thời hạn). Mỗi hạn ngạch được xác định duy nhất bằng quotaId (UUID) và được đặt lại theo múi giờ của khách hàng. Hạn ngạch có thể được phân bổ theo quốc gia, khu vực hoặc cấp độ mặc định thông qua Quota Pro.file. Quota cũng có thể được gán động bằng cách sử dụng Quota Mapping. Quota Mapping sẽ ánh xạ QuotaId gốc (UUID) và Khóa Quota duy nhất (ví dụ: người gửi hoặc người dùng) đến một quotaId cụ thể.
Hạn ngạch được thiết lập theo bộ phận hỗ trợ tại địa phương, người quản lý tài khoản được chỉ định hoặc theo mặc định nếu không có thông tin nào được chỉ định.
5.2 Trạng thái 106 – Vượt quá hạn ngạch
Tin nhắn SMS có thể bị chặn với mã trạng thái 106 (“vượt quá hạn ngạch”) khi:
- Tin nhắn vượt quá giới hạn được xác định cho quotaId tương ứng trong khoảng thời gian hiện tại.
- Quốc gia hoặc khu vực đích không được chỉ định hạn ngạch (tức là bị chặn rõ ràng với ánh xạ hạn ngạch rỗng trong profile).
- Không có hạn ngạch phù hợp và không có hạn ngạch mặc định nào được xác định, dẫn đến việc bị từ chối.
Trong những trường hợp này, hệ thống sẽ ngăn chặn việc xử lý tin nhắn tiếp theo để thực thi giới hạn dựa trên khách hàng hoặc điểm đến và tránh sử dụng sai mục đích.
Báo cáo giao hàng
Chỉ hỗ trợ không giao hàng nào hoặc giao hàng cuối cùng với kết quả thành công/thất bại.
Định dạng trên báo cáo giao hàng: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ngày thực hiện: yyMMddHHmm stat:
Các giá trị khả dụng trong trạng thái:
- GIAO HÀNG
- HẾT HẠN
- BỊ TỪ CHỐI
- KHÔNG GIAO HÀNG
- ĐÃ XÓA
6.1 Định dạng báo cáo phân phối mở rộng
Thông tin mở rộng trong các báo cáo giao hàng có thể được yêu cầu khi liên hệ với đại diện bán hàng của bạn.
Định dạng báo cáo giao hàng: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 ngày gửi:
yyMMddHHmm ngày thực hiện: yyMMddHHmm số liệu thống kê: lỗi: chữ:
Các giá trị khả dụng trong trạng thái:
- GIAO HÀNG
- HẾT HẠN
- BỊ TỪ CHỐI
- KHÔNG GIAO HÀNG
- ĐÃ XÓA
Các trường “phụ” và “dlvrd” sẽ luôn được đặt thành 000 và trường “văn bản” sẽ luôn trống.
Xem chương Mã lỗi để biết giá trị của trường “err”.
Các phiên bản TLS được hỗ trợ
TLS 1.2 hoặc TLS 1.3 là bắt buộc đối với tất cả các kết nối TLS qua SMPP.
Hỗ trợ cho TLS 1.0 và 1.1 đã ngừng hoạt động kể từ ngày 2020-11-15. Phiên bản 1.0 và 1.1 của TLS là các giao thức cũ hơn không được dùng nữa và được coi là rủi ro bảo mật trong cộng đồng Internet.
LINK thực sự khuyên bạn nên sử dụng TLS nếu các kết nối SMPP không được mã hóa hiện đang được sử dụng. Các kết nối SMPP không được mã hóa không được LINK ngừng sử dụng kể từ ngày 2020/09/01 và sẽ bị xóa trong tương lai. Ngày xóa các kết nối không được mã hóa vẫn chưa được quyết định.
Các kết nối tới máy chủ SMPP cho TLS ở cổng 3601 thay vì không được mã hóa ở cổng 3600.
Bạn vẫn có thể sử dụng TLS ngay cả khi việc triển khai SMPP của bạn không hỗ trợ TLS bằng cách sử dụng stunnel, hãy xem https://www.stunnel.org/
Mã lỗi
Các mã lỗi sau đây có thể được trả lời trong trường lỗi nếu trường này được bật.
| Mã lỗi | Sự miêu tả |
| 0 | Lỗi không thể nhận biết |
| 1 | Lỗi định tuyến tạm thời |
| 2 | Lỗi định tuyến vĩnh viễn |
| 3 | Đã vượt quá mức điều tiết tối đa |
| 4 | Hết giờ |
| 5 | Lỗi không xác định của nhà điều hành |
| 6 | Lỗi của người vận hành |
| 100 | Không tìm thấy dịch vụ |
| 101 | Không tìm thấy người dùng |
| 102 | Tài khoản không được tìm thấy |
| 103 | Mật khẩu không hợp lệ |
| 104 | Lỗi cấu hình |
| 105 | Lỗi nội bộ |
| 106 | Vượt quá hạn ngạch |
| 200 | OK |
| 1000 | Đã gửi |
| 1001 | Đã giao hàng |
| 1002 | Hết hạn |
| 1003 | Đã xóa |
| 1004 | Điện thoại di động đầy đủ |
| 1005 | Đã xếp hàng |
| 1006 | Chưa giao hàng |
| 1007 | Giao hàng, tính phí chậm trễ |
| 1008 | Đã tính phí, tin nhắn không được gửi |
| 1009 | Đã tính phí, tin nhắn không được gửi |
| 1010 | Hết hạn, không có báo cáo giao hàng của nhà điều hành |
| 1011 | Đã tính phí, đã gửi tin nhắn (đến nhà điều hành) |
| 1012 | xếp hàng từ xa |
| 1013 | Đã gửi tin nhắn cho nhà điều hành, tính phí bị trì hoãn |
| 2000 | số nguồn không hợp lệ |
| 2001 | Số ngắn không được hỗ trợ làm nguồn |
| 2002 | Alpha không được hỗ trợ làm nguồn |
| 2003 | MSISDN không được hỗ trợ dưới dạng số nguồn |
| 2100 | Số ngắn không được hỗ trợ làm đích |
| 2101 | Alpha không được hỗ trợ làm đích |
| 2102 | MSISDN không được hỗ trợ làm đích |
| 2103 | Hoạt động bị chặn |
| 2104 | Người đăng ký không xác định |
| 2105 | Điểm đến bị chặn |
| 2106 | lỗi số |
| 2107 | Điểm đến tạm thời bị chặn |
| 2108 | Điểm đến không hợp lệ |
| 2200 | Lỗi sạc |
| 2201 | Thuê bao có số dư thấp |
|
2202 |
Người đăng ký bị chặn vì tính phí quá cao (cao cấp)
tin nhắn |
|
2203 |
Người đăng ký quá trẻ (đối với trường hợp cụ thể này)
Nội dung) |
| 2204 | Thuê bao trả trước không được phép |
| 2205 | Dịch vụ bị thuê bao từ chối |
| 2206 | Thuê bao chưa đăng ký trong hệ thống thanh toán |
| 2207 | Người đăng ký đã đạt đến số dư tối đa |
| 2208 | Cần xác nhận người dùng cuối |
| 2300 | Đã hoàn lại |
|
2301 |
Không thể hoàn tiền do bất hợp pháp hoặc mất tích
MSISDN |
| 2302 | Không thể hoàn tiền do thiếu messageId |
| 2303 | Xếp hàng chờ hoàn tiền |
| 2304 | hết thời gian hoàn tiền |
| 2305 | hoàn tiền không thành công |
| 3000 | Mã hóa GSM không được hỗ trợ |
| 3001 | Mã hóa UCS2 không được hỗ trợ |
| 3002 | Mã hóa nhị phân không được hỗ trợ |
| 4000 | Báo cáo giao hàng không được hỗ trợ |
| 4001 | Nội dung tin nhắn không hợp lệ |
| 4002 | biểu giá không hợp lệ |
| 4003 | Dữ liệu người dùng không hợp lệ |
| 4004 | Tiêu đề dữ liệu người dùng không hợp lệ |
| 4005 | Mã hóa dữ liệu không hợp lệ |
| 4006 | VAT không hợp lệ |
| 4007 | Nội dung không được hỗ trợ cho đích đến |
Tài liệu / Tài nguyên
 |
liên kết di động API SMS, API SMPP API Trình lập lịch MS [tập tin pdf] Hướng dẫn sử dụng API SMS API SMPP API bộ lập lịch MS, API SMS SMPP API, API bộ lập lịch MS, API bộ lập lịch, API |