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

Trăn

Node.js

Hồng ngọc

WSDL

Xác thực

KHÓA API
OAuth2

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ố:

- apikey: Khóa API duy nhất của bạn.

- recipients: Số điện thoại của người nhận (Số điện thoại 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ó '+' và không có '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: Tin nhắn muốn gửi (Có thể gửi nhiều dòng).

- 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ập tin. Tập tin phải được truy cập công khai mà không cần xác thực.
Hỗ trợ: pdf, xml, doc, docx, odt, rtf, txt, tex, xls, xlsx, csv, ods, ppt, pptx, odp, zip, rar, 7z, tar, gz
jpg, jpeg, png, gif, bmp, tiff, svg, webp, ico, heic, jfif

- waonly: phải có giá trị Đúng -> Bắt buộc phải chỉ định rằng chỉ nên gửi một tin nhắn WhatsApp

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ố:

- guid: (bắt buộc) 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ố:

- apikey (required): 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ố:

- apikey (required): Khóa API bạn có hoặc sẽ nhận được.

- before (optional): 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 (optional): (yyyy-mm-dd) lấy tất cả các bản ghi dựa trên ngày.

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."

	
  }

    
  
}

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.

Gửi tin nhắn WhatsApp

URL WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Các thông số:

- recipients: Số điện thoại di động của người nhận.

- message: Tin nhắn cần gửi.

- apikey: Khóa API bạn có hoặc sẽ nhận được.

- waonly: phải có giá trị Đúng -> Cần phải chỉ rõ rằng chỉ được gửi một tin nhắn WhatsApp.

Ví dụ


                require_once "lib/nusoap.php";

                

                $client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

                $error  = $client->getError();

                

                $result = $client->call("sendSms", array("waonly" =>"yes","recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

                

                print_r($result);

Gửi WhatsApp

Lệnh cURL cơ bản

Bạn có thể sử dụng lệnh cURL sau để gửi tin nhắn WhatsApp qua SMSmobileAPI:


        curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

Ví dụ cURL trong PHP

Nếu bạn đang sử dụng PHP, đây là cách bạn có thể gửi tin nhắn WhatsApp bằng cURL:


        <?php

        

        $url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'


        );

        

        $options = array(

            CURLOPT_URL => $url,

            CURLOPT_POST => true,

            CURLOPT_POSTFIELDS => http_build_query($data),

            CURLOPT_RETURNTRANSFER => true,

        );

        

        $ch = curl_init();

        curl_setopt_array($ch, $options);

        $response = curl_exec($ch);

        curl_close($ch);

        

        echo $response;

        

        ?>

Ví dụ PHP này trình bày cách gửi yêu cầu POST bằng cURL đến SMSmobileAPI, truyền các tham số cần thiết dưới dạng một mảng liên kết.

Gửi WhatsApp

Sử dụng Mô-đun Python chính thức của chúng tôi: https://smsmobileapi.com/python/
hoặc sử dụng cách thủ công ...

Sử dụng thư viện `requests`

Thư viện `requests` là một thư viện HTTP phổ biến và đơn giản dành cho Python. Sau đây là cách bạn có thể sử dụng nó để gửi tin nhắn WhatsApp qua SMSmobileAPI:


        import requests



        url = "https://api.smsmobileapi.com/sendsms/waonly=yes"



        payload = {

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        }



        response = requests.post(url, data=payload)



        print(response.text)

Ví dụ này trình bày một yêu cầu POST đơn giản tới SMSmobileAPI, gửi tin nhắn WhatsApp đến một số điện thoại cụ thể.

Sử dụng thư viện `http.client`

Thư viện `http.client` được bao gồm trong thư viện chuẩn của Python và cũng có thể được sử dụng để tương tác với API của bạn:


        import http.client

        import urllib.parse



        conn = http.client.HTTPSConnection("api.smsmobileapi.com")



        params = urllib.parse.urlencode({

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        })



        headers = { "Content-type": "application/x-www-form-urlencoded" }



        conn.request("POST", "/sendsms/?waonly=yes", params, headers)

        response = conn.getresponse()

        data = response.read()



        print(data.decode("utf-8"))

        conn.close()

Ví dụ này cho thấy cách sử dụng thư viện `http.client` để gửi yêu cầu POST đến API. Các tham số được mã hóa URL và được gửi với tiêu đề phù hợp.

Gửi WhatsApp

Sử dụng API `fetch`

API `fetch` là một cách hiện đại và linh hoạt để thực hiện các yêu cầu HTTP trong JavaScript. Sau đây là cách bạn có thể sử dụng nó để gửi tin nhắn WhatsApp qua SMSmobileAPI:


        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = {

            recipients: "PHONE_NUMBER",

            message: "YOUR_MESSAGE",

            apikey: "YOUR_API_KEY"

        };



        fetch(url, {

            method: "POST",

            headers: {

                "Content-Type": "application/x-www-form-urlencoded"

            },

            body: new URLSearchParams(data)

        })

        .then(response => response.text())

        .then(result => console.log(result))

        .catch(error => console.error("Error:", error));

Ví dụ này trình bày cách gửi yêu cầu POST bằng API `fetch`, được hỗ trợ trong hầu hết các trình duyệt hiện đại.

Sử dụng `XMLHttpRequest`

Nếu bạn cần hỗ trợ các trình duyệt cũ hơn, bạn có thể sử dụng đối tượng `XMLHttpRequest`:


        const xhr = new XMLHttpRequest();

        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";



        xhr.open("POST", url, true);

        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");



        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 && xhr.status === 200) {

                console.log(xhr.responseText);

            }

        };



        xhr.send(data);

Ví dụ này cho thấy cách sử dụng `XMLHttpRequest` để gửi yêu cầu POST, đảm bảo khả năng tương thích với các trình duyệt cũ hơn có thể không hỗ trợ `fetch`.

Gửi WhatsApp

Sử dụng thư viện `axios`

Thư viện `axios` là một HTTP client phổ biến cho Node.js. Sau đây là cách bạn có thể sử dụng nó để gửi tin nhắn WhatsApp qua SMSmobileAPI:


        const axios = require('axios');



        const url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        const data = {

            recipients: 'PHONE_NUMBER',

            message: 'YOUR_MESSAGE',

            apikey: 'YOUR_API_KEY'

        };



        axios.post(url, data)

        .then(response => {

            console.log(response.data);

        })

        .catch(error => {

            console.error('Error:', error);

        });

Ví dụ này trình bày cách gửi yêu cầu POST bằng `axios` trong Node.js để tương tác với SMSmobileAPI.

Gửi WhatsApp

Sử dụng thư viện `Net::HTTP`

Bạn có thể sử dụng thư viện `Net::HTTP` trong Ruby để gửi tin nhắn WhatsApp qua SMSmobileAPI:


        require 'net/http'

        require 'uri'



        uri = URI.parse("https://api.smsmobileapi.com/sendsms/?waonly=yes")

        request = Net::HTTP::Post.new(uri)

        request.set_form_data(

            "recipients" => "PHONE_NUMBER",

            "message" => "YOUR_MESSAGE",

            "apikey" => "YOUR_API_KEY"

        )



        req_options = {

            use_ssl: uri.scheme == "https",

        }



        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

            http.request(request)

        end



        puts response.body

Ví dụ này trình bày cách gửi yêu cầu POST bằng `Net::HTTP` trong Ruby đến SMSmobileAPI.

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