SMSドキュメント

SMSを送信

終点： 

パラメータ:

例：

送信されていないSMSを再送信する

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

終点：

パラメータ: 

例： 

APIから送信されたSMSのログ

この API エンドポイントは、API 経由で送信された SMS メッセージのログを取得するために使用されます。

終点： 

パラメータ:

例：

携帯電話から送信されたSMSの一覧

このAPIエンドポイントは、モバイルデバイスから送信され、SMSMobileAPIアカウントに同期されたSMSメッセージを一覧表示するために使用されます。

重要： この機能はAndroidバージョンから利用可能です 4.1.20.

重要： この機能は デフォルトでは有効になっていません Androidアプリで。

プライバシー： 同期されたすべての情報は匿名化され、機密情報として扱われ、安全に処理されます。

履歴制限: このAPIは常に最後のデータを返します 7日間 のみ。

注記： 標準APIエンドポイントを使用してSMSを送信する場合 https://api.smsmobileapi.com/sendsms/これらのSMSは、実際にあなたのモバイルデバイスから送信されたものであるため、このリストに表示される場合があります。

終点：

パラメータ: 

返されたフィールド: 

例： 

フィルターを使用した例：

期間があらかじめ定義されている例：

SMS受信

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

終点：

パラメータ: 

例：

受信したSMSメッセージを既読にする

このAPIエンドポイントは、受信したSMSメッセージを1つ既読としてマークするために使用されます。 APIステータスのみ.
これによってスマートフォン上の既読ステータスは変更されません。  

終点：

パラメータ: 

例：

SMSエイリアスを更新

このAPIエンドポイントは、受信したSMSのGUIDを使用して、そのエイリアスを更新するために使用されます。

注記： の alias パラメータは空でも構いません。その場合、エイリアスはクリアされます。

終点：

パラメータ: 

例： 

エイリアスをクリアする例：

SMSを削除

この API エンドポイントは、SMS モバイル API のサーバー ログから SMS メッセージを削除するために使用されます。

終点： 

パラメータ:

例：

注: 削除されるSMSは、サーバーログに保存されているもののみです。デバイス上のSMSは削除されません。

SMSの会話一覧

このAPIエンドポイントは、あなたのアカウントに関連付けられたSMSの会話履歴を表示するために使用されます。

各会話は電話番号ごとにグループ化され、関連する送受信SMSメッセージが含まれています。

注記： 会話の出発点は、 origineConversation パラメータ:

• received: 会話は最初に受信した SMS から検出されます logsmsreceive
• sent: 会話は最初に送信された SMS から検出されます logsmssent

注記： もし numero が指定されていない場合、API は最新の会話のみを返します。デフォルトでは、最後の 20 会話が返されます。

注記： 送信SMSの場合、 timearea_of_message 利用可能です（例： UTC+02) 表示される日付は、この値を使用して自動的に変換されます。この変換された日付は、並べ替えにも使用されます。

注記： もし resume=1各会話の最新メッセージのみが返されます。 resume_line_how 最新のメッセージをいくつ含めるかを定義する。

終点：

パラメータ: 

行動の詳細： 

例1 - 受信したSMSから最新の会話を一覧表示する： 

例2 - 送信済みSMSから最新の会話を一覧表示する：

例3 - 特定の電話番号をフィルタリングする：

例4 - 日付範囲でフィルタリングする：

例5 - 会話ごとに最後の3つのメッセージを含む再開モード：

成功例： 

{ "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": "Hello, I would like more information.", "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": "もちろん、何を知りたいですか？", "status": "送信済み", "mobile_sid": "device_sid_2" } ] } ] }

応答フィールド:

エラー例：

{ "success": false, "error": "必須パラメータ「apikey」が不足しています" }

注：

ゲートウェイ – 接続されているモバイルの一覧

接続されているモバイルを一覧表示 SMSゲートウェイ.

終点：

パラメータ:

例：

ゲートウェイ – モバイルラベルを更新する

接続されているモバイルのラベル (nom_reference) を更新します。

終点：

パラメータ:

例：

重要： ラベルは必須ですが、空でも構いません (ラベル=)。

ゲートウェイ – 接続されたモバイルを削除する

接続されているモバイルをゲートウェイから削除します (この SID のすべての履歴行を削除します)。

終点：

パラメータ:

例：

Webhook – SMS 受信

この Webhook システムは、SMS を受信するたびに、設定された URL に POST リクエストを送信します。システムは、指定された Webhook URL に SMS の詳細を配信することで、リアルタイムの更新を保証します。

ダッシュボードでWebhookを設定する方法

ダッシュボードで Webhook URL を設定するには、次の手順に従います。

1. アカウントにログインしてください SMS モバイル API ダッシュボード.
2. に移動 Webhook設定 セクション。
3. Webhook URLを入力します（例： https://example.com/webhook-endpoint).
4. クリックして Webhook を保存 ボタン。 
5. 保存すると、システムは設定された URL に SMS の詳細を送信し始めます。

Webhook ペイロード

SMS を受信すると、システムは次の JSON ペイロードを Webhook URL に送信します。

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "こんにちは、これはテストです。", "number": "+123456789", "guid": "abcde12345" }

ペイロードフィールド:

• 日付： SMS が追加された日付 (YYYY-MM-DD)。
• 時間： SMS が追加された時間 (HH:mm:ss)。
• 受信時間: SMS を受信した時刻。
• メッセージ： SMSの内容。 
• 番号： 送信者の電話番号。
• ガイド: SMS の一意の識別子。

Webhookエンドポイントの例

サーバーは、受信した POST リクエストを処理できる状態になっている必要があります。以下は、Webhook ペイロードを処理する PHP スクリプトの例です。

Webhookのテスト

Webhook 構成をテストするには、次のようなツールを使用します。

• Webhook.サイト
• リクエストビン

トラブルシューティング

• Webhook URL が正しく、公開アクセス可能であることを確認します。
• 成功したリクエストに対してサーバーが HTTP 200 ステータス コードを返すことを確認します。
• ペイロードの処理中にエラーが発生していないか、サーバー ログを確認してください。

強化されたSMS

認証

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

1. APIキー認証

 このメソッドには、GET または POST リクエストのいずれかにパラメータとして含めることができる API キーが必要です。

2. OAuth2認証

OAuth2 はより安全な認証方法を提供します。
クライアントIDとクライアントシークレットを使用してアクセストークンを取得し、それを 承認 ヘッダ。

client_id と client_secret はダッシュボードで確認できます。
今すぐモバイルアプリをダウンロード または ダッシュボードにアクセスする.

アクセストークンの取得

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

どの方法を使用すべきでしょうか?

- 使用 APIキー認証 迅速かつ簡単な統合を実現します。

- 使用 OAuth2認証 セキュリティとスケーラビリティを強化します。