Messages APIを使い始める
このページでは、Vonage Messages APIを使用するために必要なすべてのステップを説明します。 Messages APIは、SMS、MMS、RCS、WhatsApp、Facebook、Viberといった複数の一般的なチャネルを通じて、お客様にメッセージを送信するシンプルな方法を提供します。各プラットフォームと個別に統合する代わりに、一度接続すればすべての会話を一箇所で管理できます。
まず、このガイドに従ってアカウントとアプリケーションを作成してください。その後、以下のスタートガイドをご覧ください。 選ばれたチャンネル をクリックしてオンボーディングを完了してください。
前提条件
最初のメッセージを送信する前に、Vonageアカウントとアプリケーションを作成する必要があります：
Vonageアカウントの作成
無料のVonageアカウントを作成するには：
- ブラウザで ダッシュボード.
- 会社情報を追加し 登録する.
VonageはPINをテキストメッセージまたは自動電話としてお客様の電話に送信します。各認証試行のタイムアウトは5分です。
注電話番号は1つのアカウントにのみ関連付けることができます。電話番号がすでにVonageアカウントに関連付けされている場合は、次のようにしてください。 その電話番号を削除する 既存のアカウントから。 - で 電話番号認証をクリックし、Vonageから送られてきたPINを入力して Verify. Dashboardにログインし、Vonageでの開発を開始する方法が表示されます。このページはVonage APIで最初の通話を成功させるまでログインするたびに表示されます。
Vonageアカウントを作成すると、2ユーロの無料テストクレジットが与えられ、アカウントはデモモードに設定されます。最大10の宛先番号にメッセージを送信するために私たちの製品を使用することができ、アカウントがデモモードであることを示すメッセージは、あなたが送信したすべてのSMSに追加されます。デモモードを解除するには アカウントにクレジットを追加する.
ごく一部の国では、Vonageは自動的にアカウントを作成することができません。これは、支払い制限または米国登録企業の法的取引制限のためです。
Vonage APIアプリケーションの作成
Messagesアプリケーションを作成するには、2つの方法があります：
- Vonage CLIの使用
- ダッシュボードの使用
それぞれの方法については、以下のセクションで説明する。
Vonage CLIを使用してメッセージアプリケーションを作成する方法
Vonage CLIを使用してアプリケーションを作成するには、シェルに次のコマンドを入力します：
これは Messages API アプリケーションを作成します。 能力WebhookのURLを指定通りに設定し、秘密鍵ファイルを生成する。 my_messages_app.key を作成または更新します。 vonage_app.json ファイル。
ダッシュボードを使用してメッセージアプリケーションを作成する方法
でメッセージアプリケーションを作成できます。 ダッシュボード.
ダッシュボードを使用してアプリケーションを作成します：
アンダー Applications をクリックします。 新規アプリケーションの作成 ボタンをクリックする。
アンダー 名称アプリケーション名を入力します。後で参照しやすいように名前を決めてください。
ボタンをクリックする 公開鍵と秘密鍵の生成.これで公開鍵と秘密鍵のペアが作成され、秘密鍵はブラウザからダウンロードされる。
アンダー 能力 を選択する。 メッセージ ボタンをクリックする。
の中で インバウンドURL ボックスに、受信メッセージ・ウェブフックのURLを入力します、
https://example.com/webhooks/inbound-message.の中で ステータスURL ボックスに、メッセージ・ステータスWebhookのURLを入力します、
https://example.com/webhooks/message-status.をクリックする。 新規アプリケーションの作成 ボタンをクリックします。アプリケーション作成手順の次のステップに進み、Vonage API番号をアプリケーションにリンクしたり、Facebookなどの外部アカウントをこのアプリケーションにリンクしたりできます。
このアプリケーションをリンクさせたい外部アカウントがある場合は、そのアカウントをクリックします。 リンクされた外部アカウント タブをクリックし、対応する リンク ボタンをクリックします。
これでアプリケーションの作成は完了です。
注： アプリケーションをテストする前に、Webhookが設定され、Webhookサーバーが動作していることを確認してください。