開発ドキュメント WhatsApp

WhatsApp ドキュメント

このドキュメントは、WhatsApp メッセージの送受信に特化しています。

詳細はこちらをクリック WhatsApp 統合が提供するすべての機能について。

SMSmobileAPI では、あらゆるアーキテクチャやプラットフォームと API を可能な限り互換性のあるものにするよう努めています。
REST、SOAP、cURL、または Python、JavaScript、PHP などのさまざまなプログラミング言語を使用している場合でも、当社の API はプロジェクトにシームレスに統合できるように設計されています。

また、eコマースソリューションやソフトウェア用のすぐに使用できるプラグインもご用意しています。クリックしてご覧ください.

API レスト

cURL

JavaScript

パイソン

Node.js

ルビー

WSDL

WhatsApp APIを送信

この API エンドポイントは WhatsApp メッセージを送信するために使用されます。

終点：

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

パラメータ:

パラメータ	説明
apikey	必須固有の API キー。
recipients	必須受信者の電話番号（WhatsApp で利用可能な番号である必要があります）。国番号（「+」と「00」なし）から始まる電話番号を入力し、その後に番号の残りの部分を直接入力します。例： 191728660
message	必須送信するメッセージ（複数行可能）。
waonly	必須価値がなければなりませんはい → WhatsApp メッセージを 1 つだけ送信するように指定する必要があります。
url_media	WhatsApp経由で送信したいメディアファイルの直接URL。 https:// 有効な PDF, ドキュメントまたは画像ファイル。ファイルは認証なしで公開アクセスできる必要があります。サポートされている形式: 文書: pdf、xml、doc、docx、odt、rtf、txt、tex、xls、xlsx、csv、ods、ppt、pptx、odp、zip、rar、7z、tar、gz 画像: jpg、jpeg、png
url_media_shorted	値がはい[pdf_with_image=yes] が設定されている場合、PDF のダウンロードリンクの表示は短縮 URL を経由します。
pdf_with_image	値がはい、メッセージに添えて PDF の画像プレビューが表示されます (ファイルが PDF の場合のみ)。
encrypt_message	はい = 受信者が読むときにメッセージは暗号化されます。受信者はメッセージを復号化するために一意のキーを入力する必要があります。メッセージの暗号化について詳しくはこちら

メディアなしの例:


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

メディアの例:


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

WhatsAppでテキストをフォーマットする:

イタリック： アンダースコアを使用する → _text_
大胆な： アスタリスクを使用する → *テキスト*
取り消し線: チルダを使用する → ~text~
等幅フォント: バッククォートを使用する → ```text```

たとえば: _Hello_ world、How *are* you ~today~ from ```SMSMobileAPI```

送信されていないWhatsAppメッセージを再送信する

この API エンドポイントは、未送信のメッセージを再送信するために使用されます (メッセージがエラー状態の場合のみ)

終点：

得る役職 https://api.smsmobileapi.com/resendwa/

パラメータ:

パラメータ	説明
guid	必須再送信するメッセージの GUID。

例：


        https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE を取得します

メッセージを取得するための同期

この API エンドポイントは、WhatsApp メッセージを同期および取得するためのリクエストを送信するために使用されます。
この手順は必須であり、メッセージを取得するエンドポイントを呼び出す前に実行する必要があります。

警告： 同期は、メッセージ取得機能にのみ厳密に必要です。メッセージを送信するために同期を開始しないでください。

終点：

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

パラメータ:

パラメータ	説明
apikey (required)	必須あなたが持っている、または受け取る予定の API キー。

例：


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

返事：



{


 "エラー": "0",

   "メッセージ": "同期済み",

  "有効期限": "2025-03-11 12:27:00",

  "UNIXで期限切れ": "1741692420",


 

}

WhatsAppメッセージを取得

この API エンドポイントは、受信した WhatsApp メッセージを取得するために使用されます。

終点：

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

パラメータ:

パラメータ	説明
apikey	必須あなたが持っている、または受け取る予定の API キー。
before	タイムスタンプをパラメータとして渡し、このタイムスタンプの下のレコードを表示します。
date	(yyyy-mm-dd) 日付に基づいてすべてのレコードを取得します。
message_type	すべて表示するには空白のままにしてください（テキストと音声メッセージ）使用 `文章` テキストメッセージのみを表示する使用 `オーディオ` 音声メッセージのみをテキストに変換して表示する

例：


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

返事：



{


  「日付」: 「2025-03-11」、

  "時間": "12:27:00",

  "タイムスタンプ": "1741692420",

  "番号": "19176728660",

  "連絡先": "Smsmobileapi",

  "message": "注文した商品がいつ届くか教えていただけますか?",

  "GUID": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c",

  
  "もっと"： {

    "自動返信": "1",

    "メールへの転送": "1",

    "チャット返信": "1"

	
  },


  「チャットGPT」: {

    "prompt_tokens": "900",

    "完了トークン": "10",

    "total_tokens": "910",

    "total_token_cost": "0.182"

	 "response": "ご注文の #576 は明日発送されます。"

	
  }

    
  
}

認証

SMSMobile API は、シンプルな API キーを使用するか、クライアント ID とクライアントシークレットを使用した OAuth2 プロトコルを使用する 2 つの認証方法をサポートしています。

1. APIキー認証

当社の API 経由で WhatsApp メッセージを送信または取得するには、API キーを使用した認証が必要です。これにより、メッセージングサービスへの安全で承認されたアクセスが保証されます。リクエストに API キーを含めるだけで認証され、シームレスにメッセージの送信を開始できます。

2. OAuth2認証

OAuth2 は、より安全でスケーラブルな認証方法を提供します。
アクセストークンを取得するにはクライアントIDとクライアントシークレットを使用する必要があります。アクセストークンは、承認ヘッダ。

client_id と client_secret はダッシュボードで確認できます。

アクセストークンの取得

アクセストークンを取得するには、クライアント ID とクライアントシークレットを使用してトークンエンドポイントに POST リクエストを送信します。


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"

アクセストークンの使用:

アクセストークンを取得したら、それを承認 API リクエストのヘッダー:


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.

WhatsAppメッセージを送信

WSDL URL

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

パラメータ:

- recipients: 受信者の携帯電話番号。

- message: 送信するメッセージ。

- apikey: あなたが持っている、または受け取る予定の API キー。

- waonly: 価値を持たなければならないはい -> WhatsApp メッセージを 1 つだけ送信するように指定する必要があります。

例


                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);

WhatsAppを送信

基本的な cURL コマンド

SMSmobileAPI 経由で WhatsApp メッセージを送信するには、次の cURL コマンドを使用できます。


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

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

PHP での cURL の例

PHP を使用している場合、cURL を使用して WhatsApp メッセージを送信する方法は次のとおりです。


        <?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;

        

        ?>

この PHP の例は、必要なパラメータを連想配列として渡しながら、cURL を使用して POST リクエストを SMSmobileAPI に送信する方法を示しています。

WhatsAppを送信

公式 Python モジュールを使用します。 https://smsmobileapi.com/python/
または手動で行うこともできます...

`requests` ライブラリの使用

`requests` ライブラリは、Python 用の人気のあるシンプルな HTTP ライブラリです。これを使用して SMSmobileAPI 経由で WhatsApp メッセージを送信する方法は次のとおりです。


        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)

この例では、特定の電話番号に WhatsApp メッセージを送信する、SMSmobileAPI への単純な POST リクエストを示します。

`http.client` ライブラリの使用

`http.client` ライブラリは Python の標準ライブラリに含まれており、API とのやり取りにも使用できます。


        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()

この例では、`http.client` ライブラリを使用して API に POST リクエストを送信する方法を示します。パラメータは URL エンコードされ、適切なヘッダーとともに送信されます。

WhatsAppを送信

`fetch` API の使用

`fetch` API は、JavaScript で HTTP リクエストを行うための最新かつ多用途な方法です。これを使用して SMSmobileAPI 経由で WhatsApp メッセージを送信する方法は次のとおりです。


        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));

この例では、ほとんどの最新ブラウザでサポートされている `fetch` API を使用して POST リクエストを送信する方法を示します。

`XMLHttpRequest` の使用

古いブラウザをサポートする必要がある場合は、`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);

この例では、`XMLHttpRequest` を使用して POST リクエストを送信し、`fetch` をサポートしていない可能性のある古いブラウザとの互換性を確保する方法を示します。

WhatsAppを送信

`axios` ライブラリの使用

`axios` ライブラリは、Node.js 用の人気のある HTTP クライアントです。これを使用して、SMSmobileAPI 経由で WhatsApp メッセージを送信する方法は次のとおりです。


        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);

        });

この例では、Node.js で `axios` を使用して POST リクエストを送信し、SMSmobileAPI と対話する方法を示します。

WhatsAppを送信

`Net::HTTP` ライブラリの使用

Ruby の `Net::HTTP` ライブラリを使用して、SMSmobileAPI 経由で WhatsApp メッセージを送信できます。


        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

この例では、Ruby で `Net::HTTP` を使用して POST リクエストを SMSmobileAPI に送信する方法を示します。

また、 WhatsAppメッセージとSMSを同時に送信する.

ご質問、ご提案、またはサポートが必要な場合は、当社のチームがお手伝いいたします。
お気軽にお問い合わせください api@smsmobileapi.com

SMS機能

WhatsAppの機能

一般的なプラグイン

オンラインストアプラグイン

API と開発者向けドキュメント

ツールと変更ログ

WhatsApp ドキュメント

WhatsAppを送信

メッセージを再送信

同期

メッセージを取得

認証

WhatsApp APIを送信

終点：

パラメータ:

メディアなしの例:

メディアの例:

WhatsAppでテキストをフォーマットする:

送信されていないWhatsAppメッセージを再送信する

終点：

パラメータ:

例：

メッセージを取得するための同期

終点：

パラメータ:

例：

返事 ：

WhatsAppメッセージを取得

終点：

パラメータ:

例：

返事 ：

認証

1. APIキー認証

2. OAuth2認証

アクセストークンの取得

アクセストークンの使用:

Which Method Should You Use?

WhatsAppメッセージを送信

WSDL URL

パラメータ:

例

WhatsAppを送信

基本的な cURL コマンド

PHP での cURL の例

WhatsAppを送信

`requests` ライブラリの使用

`http.client` ライブラリの使用

WhatsAppを送信

`fetch` API の使用

`XMLHttpRequest` の使用

WhatsAppを送信

`axios` ライブラリの使用

WhatsAppを送信

`Net::HTTP` ライブラリの使用

返事：

返事：