Dev DOC WhatsApp - SMSMobileAPI

Tài liệu WhatsApp

Tài liệu này dành riêng cho việc gửi và nhận tin nhắn WhatsApp.

Nhấp vào đây để tìm hiểu thêm về tất cả các tính năng mà tích hợp WhatsApp của chúng tôi cung cấp.

Tại SMSmobileAPI, chúng tôi nỗ lực làm cho API của mình tương thích nhất có thể với mọi kiến trúc hoặc nền tảng.
Cho dù bạn đang sử dụng REST, SOAP, cURL hay nhiều ngôn ngữ lập trình khác như Python, JavaScript, PHP, v.v., API của chúng tôi đều được thiết kế để tích hợp liền mạch vào các dự án của bạn.

Chúng tôi cũng có các plugin sẵn sàng sử dụng cho các giải pháp và phần mềm thương mại điện tử. Nhấp vào đây để khám phá chúng.

API NHỚ LẠI
cURL
JavaScript JavaScript
Trăn Trăn
Node.js Node.js
Hồng ngọc Hồng ngọc
WSDL
Gửi WhatsApp
Gửi lại tin nhắn
Đồng bộ hóa
Lấy lại tin nhắn
Số kiểm tra
Xác thực

Gửi API WhatsApp 

Điểm cuối API này được sử dụng để gửi tin nhắn WhatsApp.

Điểm cuối:

GET POST https://api.smsmobileapi.com/sendsms
 

Các thông số:

Tham số Sự miêu tả
apikey
Yêu cầu
Khóa API duy nhất của bạn.
recipients
Yêu cầu
Số điện thoại của người nhận (Số điện thoại này phải có trên WhatsApp).
Nhập số điện thoại bắt đầu bằng mã quốc gia (không có dấu '+' và không có dấu '00'), theo sau là phần còn lại của số điện thoại của bạn.
Ví dụ: 191728660
message
Yêu cầu
Tin nhắn muốn gửi (Có thể gửi nhiều dòng).
waonly
Yêu cầu
Phải có giá trị Đúng → Cần phải chỉ rõ rằng chỉ được gửi một tin nhắn WhatsApp.
url_media URL trực tiếp của tệp phương tiện bạn muốn gửi qua WhatsApp. Phải bắt đầu bằng https:// và chỉ ra một giá trị hợp lệ PDF, tài liệu hoặc hình ảnh tài liệu.
Tệp tin phải được truy cập công khai mà không cần xác thực.
Các định dạng được hỗ trợ:
Tài liệu: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz
Hình ảnh: jpg, jpeg, png
url_media_shorted Nếu giá trị là Đúngvà [pdf_with_image=yes] được thiết lập, liên kết tải xuống PDF sẽ hiển thị thông qua một URL ngắn.
pdf_with_image Nếu giá trị là Đúng, hình ảnh xem trước của tệp PDF sẽ được hiển thị kèm theo tin nhắn (chỉ khi tệp là tệp PDF).
encrypt_message Đúng = Tin nhắn sẽ được mã hóa khi người nhận đọc.
Người nhận sẽ cần nhập một khóa duy nhất để giải mã tin nhắn.
Tìm hiểu thêm về mã hóa tin nhắn
contactGroup Nhập GUID nhóm (có sẵn trong bảng điều khiển) khi bạn đang chỉnh sửa nhóm liên hệ.

Ví dụ không có phương tiện:

GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=191728660&message=Hello%20World

Ví dụ với phương tiện truyền thông:

GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=191728660&message=Hello%20World&url_media=https://smsmobileapi.com/logo.png

Định dạng văn bản trong WhatsApp:

  • In nghiêng: Sử dụng dấu gạch dưới → _text_
  • In đậm: Sử dụng dấu hoa thị → *văn bản*
  • Gạch ngang: Sử dụng dấu ngã → ~text~
  • Đơn cách: Sử dụng dấu ngoặc kép → ```text```
Ví dụ: _Xin chào_ thế giới, Hôm nay bạn thế nào từ ```SMSMobileAPI```

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

 Điểm cuối API này được sử dụng để gửi lại tin nhắn chưa gửi (chỉ khi tin nhắn có trạng thái lỗi)

Điểm cuối:

LẤY   BƯU KIỆN https://api.smsmobileapi.com/resendwa/

Tham số: 

Tham số Sự miêu tả
guid
Yêu cầu
GUID của tin nhắn cần gửi lại.

Ví dụ:

NHẬN https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE



Đồng bộ hóa để lấy tin nhắn  

Điểm cuối API này được sử dụng để gửi yêu cầu đồng bộ hóa và truy xuất tin nhắn WhatsApp.
Bước này là bắt buộc và phải được thực hiện trước khi gọi điểm cuối để lấy tin nhắn.

Cảnh báo: Đồng bộ hóa chỉ được yêu cầu nghiêm ngặt cho chức năng truy xuất tin nhắn. Không bắt đầu đồng bộ hóa để gửi tin nhắn.

Điểm cuối:

GET https://api.smsmobileapi.com/getwa/synchronisation/
 

Tham số:

Tham số Sự miêu tả
apikey (required)
Yêu cầu
Khóa API bạn có hoặc sẽ nhận được.

Ví dụ:

GET https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY

Hồi đáp :

{
"lỗi": "0",
"tin nhắn": "đồng bộ",
"expire_at ": "2025-03-11 12:27:00",
"hết hạn tại unix": "1741692420",
}

Lấy lại tin nhắn WhatsApp 

Điểm cuối API này được sử dụng để truy xuất tin nhắn WhatsApp đã nhận.

Điểm cuối:

GET https://api.smsmobileapi.com/getwa
 

Tham số:

Tham số Sự miêu tả
apikey
Yêu cầu
Khóa API bạn có hoặc sẽ nhận được.
before Truyền dấu thời gian dưới dạng tham số và hiển thị các bản ghi bên dưới dấu thời gian này.
date (yyyy-mm-dd) Lấy tất cả các bản ghi dựa trên ngày.
message_type
  • Để trống để xem tất cả (tin nhắn văn bản và âm thanh)
  • Sử dụng chữ chỉ để xem tin nhắn văn bản
  • Sử dụng âm thanh để chỉ xem các tin nhắn âm thanh được chuyển đổi thành văn bản


Ví dụ:

GET https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY

Hồi đáp :

{
"ngày": "2025-03-11",
"giờ": "12:27:00",
"dấu thời gian": "1741692420",
"số": "19176728660",
"liên hệ": "Smsmobileapi",
"message": "Bạn có thể cho tôi biết khi nào tôi sẽ nhận được đơn hàng của mình không?",
"hướng dẫn": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c",
"hơn": {
"tự động trả lời": "1",
"chuyển_đến_email": "1",
"chatgpt_reply": "1"
},
"chatgpt": {
"prompt_tokens": "900",
"mã thông báo hoàn thành": "10",
"total_tokens": "910",
"total_tokens_cost": "0,182"
"response": "Đơn hàng #576 của bạn sẽ được chuyển đi vào ngày mai."
}
}

Kiểm tra số trên WhatsApp 

Điểm cuối API này cho phép bạn kiểm tra xem số điện thoại có khả dụng trên mạng WhatsApp hay không.

Điểm cuối:

GET https://api.smsmobileapi.com/whatsapp/checknumber/
 

Tham số:

Tham số Sự miêu tả
apikey
Yêu cầu
apikey của bạn
recipients
Yêu cầu
Số điện thoại để xác minh


Ví dụ:

GET https://api.smsmobileapi.com/whatsapp/checknumber/?recipients=_YOUR_API_KEY_&apikey=_PHONE_NUMBER_

Hồi đáp :

{
"contact_found_on_whatsapp": "có",
"người nhận": 19176728660",
}

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  

Để gửi hoặc nhận tin nhắn WhatsApp qua API của chúng tôi, cần phải xác thực bằng khóa API. Điều này đảm bảo quyền truy cập an toàn và được ủy quyền vào dịch vụ nhắn tin. Chỉ cần đưa khóa API của bạn vào yêu cầu để xác thực và bắt đầu gửi tin nhắn liền mạch.

2. Xác thực OAuth2

OAuth2 cung cấp phương pháp xác thực an toàn và có khả năng mở rộng hơn.
Bạn sẽ cần sử dụng ID khách hàng và bí mật khách hàng để có được mã thông báo truy cập, sau đó sẽ được đưa vào yêu cầu API của bạn bằng cách sử dụng Ủy quyền tiêu đề.

client_id và client_secret có sẵn trong bảng điều khiển của bạn.

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

Để lấy mã thông báo truy cập, hãy gửi yêu cầu POST đến điểm cuối mã thông báo với ID máy khách và bí mật máy khách của bạn.

curl -X POST https://api.smsmobileapi.com/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=1ab0ex4b4c1ef2c800690d" \
-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

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

Khi bạn đã có mã thông báo truy cập, hãy đưa nó vào Ủy quyền tiêu đề yêu cầu API của bạn:

curl -X POST https://api.smsmobileapi.com/sendsms?waonly=yes \
-H "Authorization: Bearer abc123xyz456" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "recipients=+1234567890" \
-d "message=Hello"

Which Method Should You Use?

- Use API Key Authentication for quick and straightforward integrations.

- Use OAuth2 Authentication for enhanced security and scalability in your integrations.


Cũng có thể gửi tin nhắn WhatsApp và tin nhắn SMS cùng lúc.

Nếu bạn có bất kỳ câu hỏi, đề xuất hoặc cần hỗ trợ, nhóm của chúng tôi luôn sẵn sàng trợ giúp.
Hãy thoải mái liên hệ với chúng tôi tại api@smsmobileapi.com

Kết nối điện thoại di động của tôi