
シェア:
元Vonage開発者教育ディレクター。クリエイティブ・デベロッパー、プロダクト・マネージャー、ハック・デイ・オーガナイザーの経歴を持つマーティンは、放送局や大手レコード会社での勤務を経て、2012年よりテクノロジー・アドボケイトとして活動している。世界中の開発者を教育し、力を与えている。
Messages APIサンドボックスの紹介
所要時間:1 分
Messages API Sandboxは、以下のようなアプリケーションを開発、テストするための新しい方法です。 WhatsApp, Viberまたは Facebookメッセンジャーまたは メッセージ API.
サンドボックス サンドボックスではご自身のWhatsApp、Viber、Facebook Messengerアカウントをリンクすることができます。
このチュートリアルでは、すべてのセットアップ方法を説明する。
前提条件
Vonage API Account
To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.
アカウントを取得したら、以下も必要です:
WhatsApp、Viber、Facebook Messengerがインストールされたスマートフォン。
コマンドラインまたはターミナルアプリケーション。
ホワイトリスト登録
メッセージ メッセージAPIサンドボックスにアクセスしてください。
最初のステップはアカウントのホワイトリスト登録です。どのサービスも手順は同じですが、ここではWhatsAppに焦点を当てます。

Add to sandbox(サンドボックスに追加)」リンクをクリックして、オプションのリストを開きます。新しいアカウントをホワイトリストに追加するには、3つの方法があります:
カメラでQRコードをスキャンすると、あらかじめ設定されたメッセージと共にWhatsAppが起動します。
自分自身、または他のチームメンバーにメールで指示を送る。
WhatsAppから指定した電話番号に直接メッセージを送信。

どの方法を選択しても、WhatsAppアカウントで設定した番号とアカウントIDをNexmoアカウントのAPI Keyにリンクすることになります。
ホワイトリスト・セクションの一番下にこう書かれていれば、うまくいったことがわかる。 You have 1 user(s) whitelisted.すぐに表示されない場合は、「更新」リンクをクリックしてください。
ViberまたはFacebookメッセンジャーのアカウントとリンクしたい場合は、それぞれのサービスの手順を繰り返します。
自分にメッセージを送る
アカウントがホワイトリストに登録されたら、自分にメッセージを送ってテストすることができます。
これを行うには、macOSとLinuxではターミナルを、Windowsではコマンドラインを使うことができる。
画面下のコードブロックから、選択したサービスのコードをコピーします。

API認証情報はあらかじめ入力されていますが、その前にホワイトリストに登録したアカウントの番号と一致するように $TO_NUMBERを変更する必要があります。
コードをターミナル・アプリケーションに貼り付けます。エンターキーを押して、サーバーからの応答を待ちます:
{"message_uuid":"7836a42b-7493-4ece-a7a7-3f59c5058471"}
そしてメッセージが表示されるのを待つ!

かなりクールだろ?
Webhooksでアプリケーションに接続
CURLは素晴らしいが、あなたがコマンドラインから自分自身にメッセージを送るためにここにいるのではないことは分かっている。
サポートされているサービスからの受信メッセージをアプリケーションで受け取るには Inboundをセットアップします。

インバウンド・メッセージを受け取るには、まず、アプリケーションがメッセージをリッスンするエンドポイントを持っていて、リクエストを受け取ることができることを確認してください。 POSTリクエストを受け取れるようにします。このエンドポイントは好きなように呼ぶことができる。 /inboundがよく使われるそうです。
アプリケーションをサーバーにデプロイする前に、次のようなアプリを使うことができる。 Ngrokのようなアプリを使って外部からアクセスできるようにします。この設定方法についての詳細は ドキュメント.
アプリケーションが送信するメッセージに何が起こっているかを知ることは良いことです。そのために Statusを提供しています。
例えば、アプリケーションから送信されたメッセージが到着しているかどうかを知りたい場合、ステータスウェブフックを通して deliveredを使って報告されます。このWebhookの使用は任意ですが、積極的に監視し、送られてくるデータを記録するには最適な選択です。
あなたはここからそれを取ることができる
Messages API Sandboxを使えば、WhatsApp、Viber、Facebook Messengerを素早く簡単に利用できます。新規または既存のアプリケーションにこれらのサービスを接続することができます。
まずは Messages APIのドキュメントを読んでみよう。.
インスピレーションをお探しなら、私たちが作成した他の5つのチュートリアルをご覧ください:
AirtableとNode.jsで受信したSMSメッセージを保存する-受信したWhatsApp、Viber、Facebook Messengerメッセージを保存するように変更できます。
あなたのツイッターの好感度スコアがわかる-このReactの例を基に、ViberやWhatsApp経由でスコアを送信することもできます。
ウェブをスクレイピングしてSMSでアップデートを送信-このアプリの例では、結果をWhatsApp経由で送信することができます。
Node、React、GoogleでリアルタイムSMS翻訳-このアプリケーションに追加して、SMS、WhatsApp、Facebook Messengerのメッセージを翻訳しませんか?
Node.jsとAzure FunctionsでSMSメッセージを送受信する-SMSの代わりにViberメッセージを送信するように、このAzure Functionを修正してみてください。
あなたが何を作っているにせよ、必要であれば私たちはここにいます。こちらへどうぞ Vonage開発者コミュニティSlackにアクセスして、会話をしたり、ヒントを共有したり、他の人から学んだりしてください。
