スタートガイド
このガイドは、クラウドAPIを使用して最初のメッセージを送受信するのに役立ちます。Webhooksを構成する方法も学習し、サンプルアプリで使用します。
このガイドは、自分用または自分の組織のためにアプリを開発している開発者向けです。他のビジネスが使用するアプリを開発する場合は、ソリューションプロバイダーをお読みください。
開始する前に
以下が必要です。
- Meta開発者アカウント — Meta開発者としての登録について詳しくはこちら
- ビジネスアプリ — アプリの作成について詳しくはこちら。ビジネスアプリを作成するオプションが表示されない場合は、アプリの作成中に[その他] > [次へ] > [ビジネス]を選択します。
ステップ1: WhatsApp製品をアプリに追加する
この時点で、新しいアプリを作成してある場合は、アプリに製品を追加するプロンプトが表示されます。下にスクロールし、[WhatsApp]で[設定]を選択します。そうでない場合は、[マイアプリ]画面からアプリを選択し、同じ手順に従ってアプリにWhatsApp製品を追加することができます。
Metaビジネスアカウント(MBA)を持っている場合は、WhatsApp製品をアプリに追加するときに、アカウントの添付を求めるプロンプトが表示されます。MBAを持っていない場合は、MBAの作成に役立ついくつかのプロンプトが表示されます。MBAがアプリに添付されると、テストを開始する準備が整います。
WhatsApp製品をアプリに追加すると、次のことが行われます。
- Metaビジネスアカウントがない場合は、作成を促すプロンプトが出ます。
- テスト用のWhatsApp Businessアカウントが自動的に作成されます。メッセージの支払いをしていないため、このアカウントには制限があります。テストと開発の目的で使用してください。
- WhatsApp Businessアカウントに関連付けられたテスト用の電話番号を作成します。この番号を使用すると、最大5つの宛先の電話番号に無料でメッセージを送信できます。
- 事前承認されたメッセージテンプレートのセットを作成します。
ステップ2: 宛先番号を追加する
テストメッセージを送信できる有効なWhatsApp番号を追加します。
アプリダッシュボードの左側のメニューで、[WhatsApp] > [API設定]に移動します。[メッセージの送受信]で[宛先]フィールドを選択し、[電話番号リストの管理]を選択します。
有効なWhatsApp番号を宛先として追加できます。宛先の番号は、番号の確認に使用できる確認コードをWhatsAppで受け取ります。
宛先番号を確認したら、[宛先]フィールドでその宛先番号が選択されている状態になるはずです。別の宛先を追加する(合計5人まで)場合は、このプロセスを繰り返します。
ステップ3: テストメッセージを送信する
事前承認されているhello_worldテンプレートメッセージを、選択した宛先番号に送信します。
[WhatsApp] > [API設定]パネルで次のことを行います。
- 自分のテスト電話番号が [差出人]フィールドで選択されていることを確認します。
- メッセージを送りたい宛先の電話番号が[宛先]フィールドで選択されていることを確認します。複数の番号を追加すると、複数のメッセージを一度に送信できます。
- [APIを使用してメッセージを送信]パネルで、[メッセージを送信]ボタンをクリックします。
または、cURLコマンドをコピーして、新しいターミナルウィンドウに貼り付けて実行することもできます。
このコードは、テンプレートメッセージ(”type”:”template”)を送信していること、また使用する具体的なテンプレート(”name”:”hello_world”)を特定していることを示しています。
ステップ4: サンプルアプリのクローンを作成し、Webhooksを構成する
Webhooksを利用すると、特定のオブジェクトに加えられる変更のHTTP通知をリアルタイムで受け取ることができます。WhatsAppでは、Webhooksを利用して、メッセージ配信や既読通知、さらにはアカウントの変更など、アプリ内の多くのイベントを通知できます。
Webhooksの内容を確認するには、コールバックURLを追加します。WebhooksテストのコールバックURLのサンプルのガイダンスに従ってサンプルアプリのクローンを作成します。このアプリが、Webhooks通知を受け入れ、画面上にJSONペイロードを表示します。
Webhooksが設定されたら、テンプレートメッセージを再送信し、それに返信します。メッセージの送信、配信、既読通知、受信メッセージの内容という4つのWebhooks通知がそれぞれ表示されます。
ステップ5: (任意)実際のビジネス用電話番号を追加する
テストビジネス番号とテストWhatsApp Businessアカウントを使用して、アプリケーションの開発を始めることができます。これらのテストアセットを使用している間は、アプリの開発中のメッセージ送信に料金を支払う必要はありません。
顧客にメッセージを送信する準備ができたら、 [API設定]パネルに実際の会社の電話番号を追加し、実際のWhatsApp Businessアカウントを作成できます。