Tài liệu SMS

Gửi tin nhắn SMS

Điểm cuối: 

Các thông số:

Ví dụ về yêu cầu:

Ví dụ về phản hồi JSON:

{ "result": { "error": 0, "sent": "1", "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "note": "sent by mobile", "datetime": "2026-03-20T21:07:44Z", "datetimeLocal": "2026-03-20T22:07:44+01:00", "port": null, "iac_control": "1", "iac_authorized": "1", "send_with_whatsapp": "0", "encrypted": { "status": "0" }, "trial_account": { "status": "0", "sms_sent": 0 } } }

Giải thích câu trả lời:

Gửi lại tin nhắn SMS chưa gửi

Điểm cuối này cho phép bạn gửi lại tin nhắn SMS chưa được gửi trước đó, chỉ khi tin nhắn hiện đang ở trạng thái lỗi.

Điểm cuối:

Các thông số: 

Ví dụ về yêu cầu: 

Ví dụ về phản hồi JSON:

{ "kết quả": { "lỗi": "0", "tin nhắn": "đã gửi lại thành công", "lần thử": 1 } }

Giải thích câu trả lời:

Nhật ký tin nhắn SMS được gửi từ API

Điểm cuối này cho phép bạn truy xuất nhật ký các tin nhắn SMS đã được gửi qua API.

Điểm cuối: 

Các thông số:

Ví dụ về yêu cầu:

Ví dụ về phản hồi JSON:

{ "result": { "error": "0", "sms": [ { "sIdentifiantPhone": "abbg00055x5", "port": 0, "date_add": "2026-03-20", "hour_add": "22:07:44", "timestamp": 1774044464, "send_from_mobile": 1, "send_from_mobile_date": "2026-03-20", "send_from_mobile_heure": "22:10:05", "send_from_mobile_timestamp": 1774044605, "recipients": "32495898697", "sms": "test", "error_api": "", "send_from_mobile_erreur": "", "guid_message": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "timearea": "UTC+01", "date_add_server": "2026-03-20", "hour_add_server": "21:07:44", "timestamp_server": 1774040864, "send_from_mobile_date_server": "2026-03-20", "send_from_mobile_heure_server": "21:10:05" } ] } }

Giải thích câu trả lời:

Danh sách tin nhắn SMS đã gửi từ điện thoại di động

Điểm cuối này cho phép bạn liệt kê các tin nhắn SMS đã gửi từ thiết bị di động của bạn và được đồng bộ hóa với tài khoản SMSMobileAPI của bạn.

Quan trọng: Tính năng này có sẵn từ phiên bản Android trở lên. 4.1.20.

Quan trọng: Tính năng này là không được bật theo mặc định trong ứng dụng Android.

Sự riêng tư: Tất cả thông tin được đồng bộ hóa đều được ẩn danh, bảo mật và xử lý một cách an toàn.

Giới hạn lịch sử: API này chỉ trả về dữ liệu từ lần cập nhật cuối cùng. 7 ngày.

Ghi chú: Nếu bạn gửi tin nhắn SMS bằng điểm cuối API tiêu chuẩn https://api.smsmobileapi.com/sendsms/Những tin nhắn SMS này cũng có thể xuất hiện trong danh sách này vì chúng được gửi trực tiếp từ thiết bị di động của bạn.

Điểm cuối:

Các thông số: 

Các trường được trả về: 

Ví dụ về yêu cầu: 

Ví dụ với bộ lọc:

Ví dụ với khoảng thời gian được xác định trước:

Ví dụ về phản hồi JSON:

{ "result": { "error": "0", "count": 200, "limit": 200, "history_limit_days": 7, "sort_by": "mobile_date_ms", "sort_order": "DESC", "sms": [ { "sIdentifiant": "508b004b4aadacc4", "number": "+15551234567", "message": "Xin chào, cuộc hẹn của bạn đã được xác nhận.", "mobile_date_ms": 1774041004692, "mobile_date_formatted": "2026-03-20 22:10:04", "synchro_time": "2026-03-20 21:10:05" }, { "sIdentifiant": "e5b70a8a28b2ec3d", { "số điện thoại": "+447700900123", "tin nhắn": "Mã xác minh của bạn là 482915.", "ngày_trên_điện_thoại": 1774040902284, "ngày_trên_điện_thoại_định_dạng": "2026-03-20 22:08:22", "giờ_đồng_bộ": "2026-03-20 21:08:35" }, { "mã_danh_dạng": "e5b70a8a28b2ec3d", "số điện thoại": "+33198765432", "tin nhắn": "Cảm ơn bạn đã đặt hàng. Đơn hàng của bạn hiện đang được xử lý.", "ngày_trên_điện_thoại": 1774026491230, "ngày_trên_điện_thoại_định_dạng": "2026-03-20 18:08:11", "synchro_time": "2026-03-20 17:19:19" } ] } }

Giải thích câu trả lời:

Đã nhận được tin nhắn SMS

Điểm cuối này cho phép bạn truy xuất các tin nhắn SMS đã nhận trên điện thoại thông minh. 

Điểm cuối:

Các thông số: 

Ví dụ về yêu cầu:

Ví dụ về phản hồi JSON:

{ "result": { "error": "", "sms": [ { "id": 466340, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320222332804", "indice": "27593", "message": "Xin chào, gói hàng của bạn đã được giao.", "number": "+15551234567", "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466341, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320221005892", "indice": "27591", "message": "Cuộc hẹn của bạn đã được xác nhận cho ngày mai.", "number": "+447700900123", "guid": "BF3B38D7-8401-4A8C-8BA6-D8D58ACBB23E", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466324, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:08:24", "timestamp_unix": 1774040904, "time_received": "20260320220822763", "indice": "27590", "message": "Vui lòng gọi lại cho chúng tôi khi có thể.", "number": "+33198765432", "guid": "08C88E20-9B98-453F-B361-9BB06D3275D6", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466156, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "19:05:22", "timestamp_unix": 1774033522, "time_received": "20260320200026246", "indice": "27588", "message": "Nhắc nhở: quá trình xem xét tài khoản của bạn đang chờ xử lý.", "number": "10001", "guid": "551B2CF4-9330-4DD2-B2BA-5A4026EEEB15", "alias": null, "apikey": "YOUR_API_KEY_HASH" } ] } }

Giải thích câu trả lời:

Đánh dấu tin nhắn SMS đã nhận là đã đọc

Điểm cuối API này được sử dụng để đánh dấu một tin nhắn SMS đã nhận là đã đọc trong hệ thống. Chỉ trạng thái API.
Việc này không làm thay đổi trạng thái đã đọc trên điện thoại thông minh.  

Điểm cuối:

Tham số: 

Ví dụ:

Cập nhật bí danh SMS

Điểm cuối API này được sử dụng để cập nhật bí danh của tin nhắn SMS đã nhận bằng GUID của nó.

Ghi chú: Các alias Tham số có thể để trống. Trong trường hợp đó, bí danh sẽ bị xóa.

Điểm cuối:

Các thông số: 

Ví dụ: 

Ví dụ về cách xóa bí danh:

Xóa tin nhắn SMS

Điểm cuối này cho phép bạn xóa tin nhắn SMS khỏi nhật ký máy chủ SMSMobileAPI.

Điểm cuối: 

Các thông số:

Ví dụ về yêu cầu:

Ví dụ về phản hồi JSON:

{ "result": { "error": null, "count_delete": 1 } }

Giải thích câu trả lời:

Lưu ý: Chỉ những tin nhắn SMS được lưu trữ trong nhật ký máy chủ SMSMobileAPI mới bị xóa. Các tin nhắn SMS đã được lưu trữ trên thiết bị di động sẽ không bị xóa.

Liệt kê các cuộc hội thoại SMS

Điểm cuối API này được sử dụng để liệt kê các cuộc hội thoại SMS liên kết với tài khoản của bạn.

Mỗi cuộc hội thoại được nhóm theo số điện thoại và bao gồm các tin nhắn SMS đến và đi có liên quan.

Ghi chú: Điểm khởi đầu của cuộc trò chuyện được xác định bởi origineConversation tham số:

• received: Các cuộc hội thoại được phát hiện lần đầu tiên từ tin nhắn SMS nhận được trong logsmsreceive
• sent: Các cuộc hội thoại được phát hiện lần đầu tiên từ tin nhắn SMS đã gửi trong logsmssent

Ghi chú: Nếu như numero Nếu không được cung cấp, API chỉ trả về các cuộc hội thoại mới nhất. Theo mặc định, cuộc hội thoại cuối cùng sẽ được trả về. 20 Các cuộc trò chuyện được đáp lại.

Ghi chú: Đối với tin nhắn SMS gửi đi, nếu timearea_of_message có sẵn (ví dụ: UTC+02), ngày hiển thị sẽ tự động được chuyển đổi bằng giá trị này. Ngày đã chuyển đổi này cũng được sử dụng để sắp xếp.

Ghi chú: Nếu như resume=1Chỉ những tin nhắn mới nhất của mỗi cuộc hội thoại mới được trả về. Sử dụng resume_line_how để xác định số lượng tin nhắn mới nhất cần được bao gồm.

Điểm cuối:

Các thông số: 

Chi tiết về hành vi: 

Ví dụ 1 - Liệt kê các cuộc hội thoại gần đây nhất từ tin nhắn SMS đã nhận: 

Ví dụ 2 - Liệt kê các cuộc hội thoại gần đây nhất từ tin nhắn SMS đã gửi:

Ví dụ 3 - Lọc một số điện thoại cụ thể:

Ví dụ 4 - Lọc theo khoảng thời gian:

Ví dụ 5 - Chế độ tiếp tục với 3 tin nhắn cuối cùng của mỗi cuộc hội thoại:

Ví dụ về phản hồi thành công: 

{ "success": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Xin chào, tôi muốn biết thêm thông tin.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Tất nhiên, bạn muốn biết gì?", "status": "sent", "mobile_sid": "device_sid_2" } ] } ] }

Các trường phản hồi:

Ví dụ về lỗi:

{ "thành công": false, "lỗi": "Thiếu tham số bắt buộc: apikey" }

Ghi chú:

Cổng kết nối – Liệt kê các thiết bị di động đã kết nối

Liệt kê các thiết bị di động được kết nối với bạn. Cổng tin nhắn SMS.

Điểm cuối:

Các thông số:

Ví dụ:

Cổng – Cập nhật nhãn di động

Cập nhật nhãn (nom_reference) của thiết bị di động đã kết nối.

Điểm cuối:

Các thông số:

Ví dụ:

Quan trọng: Nhãn là bắt buộc nhưng có thể để trống. (nhãn=).

Gateway – Xóa thiết bị di động đã kết nối

Xóa thiết bị di động đã kết nối khỏi cổng thanh toán của bạn (xóa tất cả các dòng lịch sử cho SID này).

Điểm cuối:

Các thông số:

Ví dụ:

Webhook – Đã nhận tin nhắn SMS

Hệ thống webhook này gửi yêu cầu POST đến URL được cấu hình bất cứ khi nào nhận được tin nhắn SMS. Hệ thống đảm bảo cập nhật theo thời gian thực bằng cách gửi thông tin chi tiết về tin nhắn SMS đến URL webhook đã chỉ định.

Cách cấu hình Webhook trong Bảng điều khiển

Thực hiện theo các bước sau để thiết lập URL webhook của bạn trong bảng điều khiển:

1. Đăng nhập vào tài khoản của bạn trên Bảng điều khiển API di động SMS.
2. Điều hướng đến Cài đặt Webhook phần.
3. Nhập URL webhook của bạn (ví dụ: https://example.com/webhook-endpoint).
4. Nhấp vào Lưu Webhook cái nút. 
5. Sau khi lưu, hệ thống sẽ bắt đầu gửi thông tin chi tiết về SMS đến URL đã cấu hình.

Tải trọng Webhook

Khi nhận được tin nhắn SMS, hệ thống sẽ gửi nội dung JSON sau đến URL webhook của bạn:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Xin chào, đây là một bài kiểm tra.", "number": "+123456789", "guid": "abcde12345" }

Trường tải trọng:

• ngày: Ngày thêm tin nhắn SMS (YYYY-MM-DD).
• giờ: Giờ tin nhắn SMS được thêm vào (HH:mm:ss).
• thời gian nhận được: Thời gian nhận được tin nhắn SMS.
• tin nhắn: Nội dung của tin nhắn SMS. 
• con số: Số điện thoại của người gửi.
• hướng dẫn: Mã định danh duy nhất của tin nhắn SMS.

Ví dụ về điểm cuối Webhook

Máy chủ của bạn phải sẵn sàng xử lý các yêu cầu POST đến. Dưới đây là một ví dụ về tập lệnh PHP để xử lý tải trọng webhook:

Kiểm tra Webhook

Để kiểm tra cấu hình webhook của bạn, hãy sử dụng các công cụ như:

• Webhook. trang web
• Yêu cầuBin

Xử lý sự cố

• Đảm bảo URL webhook là chính xác và có thể truy cập công khai.
• Xác minh rằng máy chủ của bạn đang trả về mã trạng thái HTTP 200 cho các yêu cầu thành công.
• Kiểm tra nhật ký máy chủ của bạn để xem có lỗi nào trong quá trình xử lý tải trọng không.

SMS được làm giàu

Xác thực

API SMSMobile hỗ trợ hai phương pháp xác thực: sử dụng Khóa API đơn giản hoặc giao thức OAuth2 với ID máy khách và bí mật máy khách.

1. Xác thực khóa API

 Phương pháp này yêu cầu một Khóa API, có thể được đưa vào làm tham số trong yêu cầu GET hoặc POST.

2. Xác thực OAuth2

OAuth2 cung cấp phương thức xác thực an toàn hơn.
Sử dụng ID khách hàng và mã bí mật khách hàng để lấy mã truy cập, sau đó đưa chúng vào Ủy quyền tiêu đề.

client_id và client_secret có sẵn trong bảng điều khiển của bạn.
Tải xuống ứng dụng di động ngay bây giờ hoặc truy cập bảng điều khiển của bạn.

Nhận mã thông báo truy cập

Sử dụng Mã thông báo truy cập:

Bạn nên sử dụng phương pháp nào?

- Sử dụng Xác thực khóa API để tích hợp nhanh chóng và dễ dàng.

- Sử dụng Xác thực OAuth2 để tăng cường bảo mật và khả năng mở rộng.