https://d226lax1qjow5r.cloudfront.net/blog/blogposts/introducing-the-messages-api-sandbox/e_messaging-api-sandbox_1200x600.png

Messages APIサンドボックスの紹介

最終更新日 April 19, 2021

所要時間: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に焦点を当てます。

External Accounts view in the Messages API Sandbox

Add to sandbox(サンドボックスに追加)」リンクをクリックして、オプションのリストを開きます。新しいアカウントをホワイトリストに追加するには、3つの方法があります:

  1. カメラでQRコードをスキャンすると、あらかじめ設定されたメッセージと共にWhatsAppが起動します。

  2. 自分自身、または他のチームメンバーにメールで指示を送る。

  3. WhatsAppから指定した電話番号に直接メッセージを送信。

Whitelisting options for WhatsApp

どの方法を選択しても、WhatsAppアカウントで設定した番号とアカウントIDをNexmoアカウントのAPI Keyにリンクすることになります。

ホワイトリスト・セクションの一番下にこう書かれていれば、うまくいったことがわかる。 You have 1 user(s) whitelisted.すぐに表示されない場合は、「更新」リンクをクリックしてください。

ViberまたはFacebookメッセンジャーのアカウントとリンクしたい場合は、それぞれのサービスの手順を繰り返します。

自分にメッセージを送る

アカウントがホワイトリストに登録されたら、自分にメッセージを送ってテストすることができます。

これを行うには、macOSとLinuxではターミナルを、Windowsではコマンドラインを使うことができる。

画面下のコードブロックから、選択したサービスのコードをコピーします。

The CURL command required to send a WhatsApp message

API認証情報はあらかじめ入力されていますが、その前にホワイトリストに登録したアカウントの番号と一致するように $TO_NUMBERを変更する必要があります。

コードをターミナル・アプリケーションに貼り付けます。エンターキーを押して、サーバーからの応答を待ちます:

{"message_uuid":"7836a42b-7493-4ece-a7a7-3f59c5058471"}

そしてメッセージが表示されるのを待つ!

What the message looks like when it is received

かなりクールだろ?

Webhooksでアプリケーションに接続

CURLは素晴らしいが、あなたがコマンドラインから自分自身にメッセージを送るためにここにいるのではないことは分かっている。

サポートされているサービスからの受信メッセージをアプリケーションで受け取るには Inboundをセットアップします。

The Webhooks Settings

インバウンド・メッセージを受け取るには、まず、アプリケーションがメッセージをリッスンするエンドポイントを持っていて、リクエストを受け取ることができることを確認してください。 POSTリクエストを受け取れるようにします。このエンドポイントは好きなように呼ぶことができる。 /inboundがよく使われるそうです。

アプリケーションをサーバーにデプロイする前に、次のようなアプリを使うことができる。 Ngrokのようなアプリを使って外部からアクセスできるようにします。この設定方法についての詳細は ドキュメント.

アプリケーションが送信するメッセージに何が起こっているかを知ることは良いことです。そのために Statusを提供しています。

例えば、アプリケーションから送信されたメッセージが到着しているかどうかを知りたい場合、ステータスウェブフックを通して deliveredを使って報告されます。このWebhookの使用は任意ですが、積極的に監視し、送られてくるデータを記録するには最適な選択です。

あなたはここからそれを取ることができる

Messages API Sandboxを使えば、WhatsApp、Viber、Facebook Messengerを素早く簡単に利用できます。新規または既存のアプリケーションにこれらのサービスを接続することができます。

まずは Messages APIのドキュメントを読んでみよう。.

インスピレーションをお探しなら、私たちが作成した他の5つのチュートリアルをご覧ください:

あなたが何を作っているにせよ、必要であれば私たちはここにいます。こちらへどうぞ Vonage開発者コミュニティSlackにアクセスして、会話をしたり、ヒントを共有したり、他の人から学んだりしてください。

シェア:

https://a.storyblok.com/f/270183/250x250/d0444194cd/martyn.png
Martyn Daviesヴォネージの卒業生

元Vonage開発者教育ディレクター。クリエイティブ・デベロッパー、プロダクト・マネージャー、ハック・デイ・オーガナイザーの経歴を持つマーティンは、放送局や大手レコード会社での勤務を経て、2012年よりテクノロジー・アドボケイトとして活動している。世界中の開発者を教育し、力を与えている。