WhatsApp API Documentation

ここから開始

4 つのステップで最初のリクエストを実行します

Connect and enable WhatsApp for a supported mobile.

Confirm the recipient with the number-check endpoint.

Send with waonly=yes.

For inbound messages, activate retrieval, synchronize, then call /getwa.

The secure SMSMobileAPI mobile app connecting a phone to the web dashboard and REST API for SMS and call operations — Encrypted mobile-to-platform connection

Official mobile application

The secure bridge between your phone, dashboard and API.

SMS and call operations pass through the official SMSMobileAPI app installed on your connected phone. The app securely pairs the device with your account, synchronizes authorized events and links the mobile network to the dashboard and REST API.

1Mobile appPairs the phone and its SIM 2Encrypted linkAuthenticates and protects data in transit 3Dashboard & APIControls workflows and activity

Signed releases distributed through the official Google Play and Apple App Store listings
Google and Apple platform review, signing and distribution controls
Secure device pairing, HTTPS transport and authenticated API access
Only the permissions required for the mobile features you enable

Get the official SMSMobileAPI app on Google Play

Download the official SMSMobileAPI app on the Apple App Store

Capabilities depend on the permissions and background access allowed by Android or iOS.

認証

認証情報をサーバー上に保持します

Use apikey for direct integrations. OAuth2 client credentials are available for server-side applications; request a token and send it as Authorization: Bearer ACCESS_TOKEN.

POST · GET

Send a WhatsApp message

ENDPOINThttps://api.smsmobileapi.com/sendsms

Sends a WhatsApp text or supported media through the connected environment.

いつ使用するか

Use it for individual recipients or a dashboard contact group.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	Your API key; omit when using a Bearer token.
`recipients`	phone	必須	Country code plus number, without + or 00.
`message`	弦	必須	Text body; multiple lines are supported.
`waonly`	はい	必須	Must be yes to request WhatsApp-only delivery.
`url_media`	HTTPS URL	オプション	Public PDF, document, archive or JPG/PNG URL.
`url_media_shorted`	はい	オプション	Use a shortened download URL with PDF preview mode.
`pdf_with_image`	はい	オプション	Add an image preview for a PDF.
`encrypt_message`	はい	オプション	Require recipient-side decryption.
`contactGroup`	GUID	オプション	Send to every contact in a dashboard group.

リクエストの例

カール

curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=191728660" \
  --data-urlencode "message=Your order is ready."

回答例

JSON

{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "MESSAGE_GUID",
    "send_with_whatsapp": "1"
  }
}

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

Good to know

Supported media URLs must be public HTTPS resources.
WhatsApp formatting: *bold*, _italic_, ~strikethrough~ and triple-backtick monospace.

POST · GET

Resend an unsent WhatsApp message

ENDPOINThttps://api.smsmobileapi.com/resendwa/

Retries a WhatsApp message that currently has an error status.

いつ使用するか

Use it after diagnosing a failed WhatsApp log entry.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	API キー。
`guid`	弦	必須	GUID of the failed message.

リクエストの例

カール

curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

Good to know

Only failed messages are eligible for resend.

得る

Activate inbound retrieval

ENDPOINThttps://api.smsmobileapi.com/getwa/active/

Activates, deactivates or toggles WhatsApp message retrieval.

いつ使用するか

Call it once before using inbound WhatsApp synchronization.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	API キー。
`statut`	0 \| 1 \| x	オプション	1 activates, 0 deactivates, x or omission toggles the current state.

リクエストの例

カール

curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"

回答例

JSON

{
  "success": true,
  "read_message_active": 1,
  "status_note": "Activated"
}

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

Good to know

Inbound retrieval is disabled by default for privacy.

得る

Synchronize inbound messages

ENDPOINThttps://api.smsmobileapi.com/getwa/synchronisation/

Requests a fresh WhatsApp synchronization before retrieval.

いつ使用するか

Call it immediately before /getwa when your application needs current inbound data.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	API キー。

リクエストの例

カール

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

回答例

JSON

{
  "error": "0",
  "messages": "synchronized",
  "expire_at": "2026-03-11 12:27:00",
  "expire_at_unix": "1773232020"
}

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

Good to know

Synchronization is for receiving messages only. Do not call it before sending.

得る

Retrieve WhatsApp messages

ENDPOINThttps://api.smsmobileapi.com/getwa

Returns synchronized inbound WhatsApp messages.

いつ使用するか

Use it after activating and synchronizing inbound retrieval.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	API キー。
`before`	Unix timestamp	オプション	Return records before this timestamp.
`date`	年-月-日	オプション	Return records for one date.
`message_type`	text \| audio	オプション	Filter text messages or audio messages converted to text; omit for both.

リクエストの例

カール

curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"

回答例

JSON

{
  "date": "2026-03-11",
  "hour": "12:27:00",
  "timestamp": "1773232020",
  "number": "19176728660",
  "contact": "SMSMobileAPI",
  "message": "When will I receive my order?",
  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

得る

Check a WhatsApp number

ENDPOINThttps://api.smsmobileapi.com/whatsapp/checknumber/

Checks whether a phone number is available on WhatsApp.

いつ使用するか

Use it before sending to reduce avoidable failures.

パラメータ

名前	タイプ	要件	説明
`apikey`	弦	必須	API キー。
`recipients`	phone	必須	Country code plus number, without + or 00.

リクエストの例

カール

curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"

回答例

JSON

{
  "contact_found_on_whatsapp": "yes",
  "recipients": "19176728660"
}

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

役職

Create an OAuth2 access token

ENDPOINThttps://api.smsmobileapi.com/oauth2/token

Exchanges client credentials for a Bearer token.

いつ使用するか

Use it for server-to-server integrations where short-lived credentials are preferred.

パラメータ

名前	タイプ	要件	説明
`grant_type`	弦	必須	Must be client_credentials.
`client_id`	弦	必須	Client ID from the dashboard.
`client_secret`	弦	必須	Client secret from the dashboard.

リクエストの例

カール

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=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

これを実行したいrequest? Connect your API key at the top of the page to unlock the interactive tester.

接続キー ↑

Good to know

Keep the client secret on your server. Never include it in mobile or browser code.

トラブルシューティング

エラーと安全な再試行

再試行する前に、HTTP ステータスと JSON エラーフィールドを読み取ります。最初にリクエストを修正せずに、検証または認証の失敗を再試行しないでください。

HTTP	コード	対処方法
400	`missing_parameter`	A required parameter is empty or absent. Check the parameter table for the endpoint.
403	`invalid_apikey`	The API key is unknown, expired or not authorized for the requested feature.
429	`too_many_requests`	Requests are arriving too quickly. Wait, then retry with exponential backoff.
500	`server_error`	The service could not complete the request. Keep the response and contact support if it persists.

再試行ルール一時的な 429 応答と 5xx 応答のみを再試行します。 1 秒後に開始し、2 秒、4 秒、8 秒に戻ります。

ヘルプが必要ですか?

シークレットではなくリクエストコンテキストを提供します。

エンドポイント、タイムスタンプ、HTTP ステータス、サニタイズされたレスポンスを共有します。 API キー、トークン、プライベートメッセージコンテンツは決して含めないでください。

API サポートに問い合わせる →

WhatsApp API documentation

4 つのステップで最初のリクエストを実行します

The secure bridge between your phone, dashboard and API.

認証情報をサーバー上に保持します

パラメータ

リクエストの例

回答例

パラメータ

リクエストの例

パラメータ

リクエストの例

回答例

パラメータ

リクエストの例

回答例

パラメータ

リクエストの例

回答例

パラメータ

リクエストの例

回答例

パラメータ

リクエストの例

エラーと安全な再試行

シークレットではなくリクエスト コンテキストを提供します。

シークレットではなくリクエストコンテキストを提供します。