双方向SMSによる顧客エンゲージメント

プログラム可能なSMSは、一方通行の通知だけに役立つわけではありません。アウトバウンド通知とインバウンドメッセージを組み合わせれば、企業と顧客の間にチャットのようなやり取りが生まれます。

このチュートリアルでは

顧客の電話番号に配達通知を送信し、配達枠を変更したいときに顧客が返信する。

あなたのアプリのワークフローはこうだ:

Phone numberVonageAppPhone numberVonageAppRequest acceptedRequest acceptedRequest to SMS APIResponse from SMS APISend delivery notification SMSReply to delivery notificationSend reply to webhook endpointRequest to SMS APIResponse from SMS APISend acknowledgement in SMS

そのためには

  1. Vonageバーチャル番号を設定する - バーチャル・ナンバーをレンタルし、インバウンド・メッセージ用のウェブフック・エンドポイントを設定する。
  2. 基本的なウェブアプリを作成する - 顧客の電話番号を収集するWebアプリを作成します。
  3. SMS通知を送信する - 顧客にSMSで配達通知を送信し、返信を要求する。
  4. 返信SMSを処理する - SMSの返信を処理し、確認する。

前提条件

このチュートリアルに必要なものは以下の通り:

  • A Vonageアカウント
  • VonageがあなたのアプリにWebhookリクエストを出せるように、一般にアクセス可能なWebサーバー。ローカルで開発する場合は のようなツールを使用する必要があります。 ングロク
  • このチュートリアルのソースコード https://github.com/Nexmo/ruby-customer-engagement/.
  • 米国を拠点とするすべての顧客は、以下を遵守するためにブランドとキャンペーンを登録する必要があります。 10 DLCガイドライン.

Vonageバーチャル番号を設定する

Vonageは、受信メッセージをVonageバーチャル番号に関連付けられたWebhookエンドポイントに転送します。

バーチャルナンバーの管理には 開発者API または Vonage CLI.以下の例では、Vonage CLIを使ってVonage番号をレンタルしています:

次に、仮想番号を次のWebhookエンドポイントに関連付けます。 インバウンドSMSを扱う:

ウェブフック・エンドポイントをバーチャル番号に関連付ける前に、サーバーが稼動しており、一般に利用可能であることを確認してください。 が公開されていることを確認してください。コンフィギュレーションが成功した場合、VonageはWebhookエンドポイントから200 OKレスポンスを受信する必要があります。もし ローカルで開発している場合は、次のようなツールを使用してください。 ングロク ローカル・ウェブ・サーバーをインターネットに公開する。

これでバーチャルナンバーの設定が完了し、SMS配信通知を送信できるようになりました。

基本的なウェブアプリを作成する

用途 シナトラ を使い、単一ページのウェブ・アプリを作成する:

ジェムファイル

app.rb

通知SMSを送信する電話番号を収集するHTMLフォームを追加します:

views/index.erb

フォームは電話番号を E.164 SMS APIが期待するフォーマット:

SMS通知を送信する

このチュートリアルでは、SMSを送信するために Ruby用VonageサーバーSDK をあなたの アプリに

ジェムファイル

Vonage APIを使用する 鍵と秘密 でクライアントを初期化する:

app.rb

コード内にAPI認証情報を保存せず、環境変数を使用してください。

通知SMSへの返信を受け取るには、以下の手順でバーチャル・ナンバーを送信メッセージのSenderIDとして設定します。 にリクエストする。 SMS API:

app.rb

このSMSが顧客に受信されたことを確認するには、以下の項目をチェックしてください。 納品書.このチュートリアルでは領収書のVerifyは行いません。

返信SMSを処理する

あなたの顧客があなたの通知SMSに返信すると、Vonageは次のように転送します。 インバウンドメッセージ を返します。 仮想番号に関連付けられたウェブフック・エンドポイントへ。

このチュートリアルアプリでは、受信した Webhook を処理し、テキストと Numbers を抽出して、確認メッセージを送信します。 を送信します。

app.rb

顧客の入力を保存し、検証することは、このチュートリアルの範囲を超えています。

先ほど受信したSMSに返信してください。アプリによって処理され、数秒以内に以下のような確認メールが届くはずです。 数秒以内にあなたの選択した

結論

あなたのアプリでSMSを送受信するのはとても簡単です。数行のコードで、SMS APIを使って顧客の電話にSMSを送信し、返信を処理し、確認の返信をすることができます。 SMS APIで顧客の電話にSMSを送信し、返信を処理し、確認で応答しています。

コードを取得する

このチュートリアルのコードはすべて 顧客エンゲージメントのための双方向SMS GitHub Repo.

リソース