返信は連絡先が既に知っている携帯番号に届きます。
SMSMobileAPI / API
受信済み SMS API · あなたの携帯は受信箱のままです
携帯で受信したすべてのSMSをアプリケーションで利用できるデータに変換します。
連絡先は既存の携帯番号に通常のSMSを送信します。メッセージはまず接続済みの電話に届き、その後SMSMobileAPIが対応するデータを安全に同期するため、あなたのアプリケーションは返信を取得、分類、処理できます。
仮想受信番号が電話に取って代わることはありません。携帯、SIM、既存の番号がやり取りの中心に残ります。
A連絡先がSMSを送信します
「折り返し電話をいただけますか？」
+1 555 012 9841
折り返し電話できますか？
/getsms/200sms.received
number+15550129841
device営業用携帯
status準備完了
あなたのソフトウェアが利用します
送信者、メッセージ、受信した携帯、タイムスタンプ、GUID、および任意のaliasを取得します。
各SMSをどの接続済み電話が受信したかを保持したまま、返信を一元化します。
簡単な説明
APIは電話の代わりにはなりません。受信したSMSを利用可能にします。
SMSMobileAPIは実際のモバイル受信箱の周りに安全なソフトウェアレイヤーを追加します。これにより、連絡先が使用している番号を変更することなく、CRM、サポートプラットフォーム、社内アプリケーションが適格な受信メッセージデータにアクセスできます。
連絡先がSMSを送信します
連絡先はSIMに紐づいた実際の番号にメッセージを送信します。
あなたの携帯が受信します
SMSは接続された電話に携帯事業者経由で届きます。
アプリがそれを同期します
必要な権限とバックグラウンドアクセスを付与すると、公式アプリが対応するメッセージデータを安全にあなたのアカウントへ送信します。
あなたのソフトウェアが利用します
REST APIで取得するか、Webhook V2イベントを受信するか、対応する統合で表示します。
アプリケーションで利用できる返信
1件のリクエストで、メッセージと処理に必要なコンテキストを返します。
GET /getsms/を使用して同期された受信SMSを一覧表示します。受信した携帯でフィルタ、未読メッセージのみを要求、またはUnixタイムスタンプ以降のメッセージを取得できます。
- number
- 利用可能な場合の国際形式の送信者。
- message
- 接続された携帯から同期されたSMSの本文。
- sIdentifiantPhone
- SMSを受信した接続済みの携帯端末。
- timestamp_unix
- メッセージの時刻（ソートや増分同期に利用可能）。
- guid
- 既読状態やフォローアップ操作のための安定したメッセージ参照。
- alias
- 任意の連絡先またはアプリケーションラベル。
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}適切な配信パターンを選択
APIでメッセージを取得するか、Webhook V2で即座に反応します。
どちらの方法も同じ接続済みモバイルのデータを使用します。アプリケーションの動作に合わせて選択するか、迅速な応答と確実な復旧のために両方を組み合わせてください。
アプリケーションが準備できたときにメッセージをリクエストします。
- 受信トレイまたはスケジュール同期を構築する
- モバイル、時間、未読状態でフィルタリングする
- 中断後にメッセージを回復する
SMSMobileAPI は sms.received イベントをあなたの HTTPS 宛先に送信します。
- ポーリングループなしで反応する
- 永続的な配信と自動再試行を使用する
- イベントが利用可能になり次第ワークフローを開始する
単なるメッセージ一覧以上
受信SMSの完全なワークフローを構築する。
/getsms/受信した SMS を一覧表示する
モバイル、タイムスタンプ、未読フィルタを使用して、アプリケーションが必要とするデータだけを取得する。
/getsms/set-read/処理済みにする
アプリケーションがメッセージを処理した後、SMSMobileAPI API の既読状態を更新する。
/getsms/update/alias を添付する
受信メッセージに連絡先名やアプリケーションのラベルを紐づける。
/conversation/sms/list/会話を構築する
サポートやCRMのタイムラインのために、電話番号ごとに受信・送信メッセージをグループ化する。
API を通じてメッセージを既読にしても、携帯端末のメッセージアプリ内の既読状態は変更されません。
何を構築できますか？
一通の返信から完全なビジネスプロセスまで。
SMS の共有受信トレイを作成する
複数の認可された電話からの返信を、受信したモバイル情報を保ったまま1つのサポートビューにルーティングする。
連絡先のタイムラインを完成させる
送信した SMS や対応した通話の活動と並べて、受信した返信を顧客レコードに追加する。
確認を自動で判別する
確認、キャンセル、再スケジュールのリクエストを検出して、次のステップを更新する。
重要なメッセージをエスカレーションする
条件が一致したら、適切な担当者に通知したり、API を呼び出したり、Workflow Studio の自動化を開始したりする。
ゼロから最初のAPI応答まで
4つの手順で、API 経由で最初の SMS を受信する。
- 1
モバイルをインストールしてペアリングする
最新の公式 SMSMobileAPI アプリをインストールし、対応する電話をアカウントに接続する。
- 2
受信SMS アクセスを有効にする
モバイルアプリで、受信SMS の同期とワークフローに必要なバックグラウンド動作を許可する。
- 3
ユニークなテストメッセージを送信する
別の番号から接続されたモバイルへ SMS を送信し、受信 SMS ダッシュボードログで確認する。
- 4
エンドポイントを安全に呼び出す
API キーをあなたのサーバーに保持し、/getsms/ を呼び出して GUID を保存することで、アプリケーションが重複処理を回避できるようにする。
受信 SMS API のよくある質問
開発者や運用チームがまず抱く疑問。
APIが私のモバイルの代わりにSMSを受信しますか？
いいえ。対応する接続済みのモバイルとSIMがまずSMSを受信します。その後、SMSMobileAPIがサポートされるメッセージデータを同期し、ソフトウェアで取得できるようにします。
複数のモバイルを同じアプリに接続できますか？
はい。複数の許可されたモバイルを1つのアカウントに接続できます。受信モバイルの識別子により、各メッセージの送信元をアプリケーション側で保持できます。
ポーリングとWebhook V2のどちらを使うべきですか？
GET /getsms/は、アプリケーションが取得スケジュールを制御する場合や復旧が必要な場合に使用してください。イベントが利用可能になったら直ちにHTTPS宛先に反応させたい場合は、sms.receivedのWebhook V2イベントを使用してください。多くの本番環境では両方を組み合わせて使用します。
同じメッセージを二重に処理しないためには？
メッセージGUIDをアプリケーションに保存し、処理を冪等にしてください。処理が成功したら、SMSMobileAPIのAPI既読状態を更新することもできます。
メッセージを既読にしても、電話側の受信トレイは変わりますか？
いいえ。エンドポイントはSMSMobileAPIのワークフローで使用されるAPI側の既読状態を変更するだけで、電話のメッセージアプリ内でメッセージを既読にするわけではありません。
アプリから返信できますか？
はい。アプリからSMSの送信エンドポイントを呼び出し、選択した接続済みモバイルがそのSIMと電話番号を使って返信を送信できます。
モバイルで受信したすべての有用な返信をソフトウェアで把握できるようにしましょう。
まず1台の電話を接続し、received-SMS同期を許可して、CRMやサポートプラットフォーム、オートメーションに展開する前に一連の流れをテストしてください。
