WhatsApp デプロイメントのプロビジョニング

始める前に

WhatsApp クラスタをデプロイする前に、以下の情報を収集する必要があります。 設定 のページにある。 WhatsApp Businessダッシュボードを含む：

WhatsApp ビジネスアカウントID

  1. に移動する。 ビジネス設定 ページで アカウント > WhatsAppアカウント.
  2. WhatsApp Businessアカウントを選択します。
  3. WhatsAppビジネスアカウントIDはページ上部、WhatsAppビジネスアカウント名の下に表示されます。

電話番号

  1. に移動する。 ビジネス設定 ページで アカウント > WhatsAppアカウント.
  2. WhatsApp Businessアカウントを選択します。
  3. の下にある。 設定 タブを開く WhatsApp Manager > 電話番号.
  4. リストから希望の電話番号を探します。

証明書（電話番号に関連付けられたもの）

  1. に移動する。 ビジネス設定 ページで アカウント > WhatsAppアカウント.
  2. WhatsApp Businessアカウントを選択します。
  3. の下にある。 設定 タブを開く WhatsApp Manager > 電話番号.
  4. リストから希望の電話番号を探します。
  5. をクリックする。 表示 ボタン 証明書 列）。
  6. 関連する証明書をクリップボードにコピーし、別の文書に貼り付けます。次のステップで必要になります。

Vonageアプリケーションの作成

Vonage API アプリケーションには、Vonage エンドポイントに接続して Vonage API を使用するために必要なセキュリティおよび設定情報が含まれています。この場合、Vonage Messages API を使用するアプリケーションを作成する必要があります。

ご注意: WhatsAppアカウントをVonageアプリケーションにリンクするには、事前にVonageアカウントに接続しておく必要があります。WhatsAppアカウントをVonageアカウントに接続するには Vonage APIダッシュボード.

  • CLIとダッシュボードの両方の例があります。 これ

JWTを生成する

ヒント クライアントSDKとサーバーSDKが必要に応じてJWTを生成するので、Curlでテストする場合のみ、この手順を実行する必要があります。

Vonage API Applicationsを作成すると、アプリケーションIDと秘密鍵ファイルを使用することができます、 private.key, でJWTを生成する。

を使用してJWTトークンを作成するには Vonage CLI次のコマンドを使用する。

# A command with parameters
vonage jwt create `
--app-id='00000000-0000-0000-0000-000000000000' `
--private-key=./private.key

# Will produce a token
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3MzYyODE5NDYsImp0aSI6IjBmZjcwZDNmLTAzN2EtNGY4MC04ODZjLWI3MmM3MmQyMWNmMiIsImlhdCI6MTczNjI4MTA0NiwiYXBwbGljYXRpb25faWQiOiIwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDAifQ.gA7jClpqaZ2OoS0iri-zGCbda4jO7C0M8mka0EnSyjlds1EeY8fNoBEx3FTXHfkkzzrj0TskrWc_dcs1wuM8Kx55c5rLQ7taVpDAYopKSc_CeeOaad8S6aWnRkTUTNeduO4aIn-0CbyRTluBYsH1RBqYBQvobuQIDEwbFw8xBgx0UfREMMN6DAWknR57eiVXN9x_oD6CGQJ1yV3025nGboeMsP9YgX4Nwc-rE2r8c1ZGwCLO81x8i19Qil3Nwu5q1nzouyavQjIw00B_TZkushnI1ufdi_GNqk-h5q2HvGkg7Pj9bVkZHFdVTO8im03JYNyJmcV83vnpjOLuCFRzxQ

または JWTウェブアプリ を使ってJWTを生成する。

ヒント 生成されたJWTは以下でテストできます。 jwt.io

WhatsAppのプロビジョニング

キー 説明
country_code プロビジョニングされる番号の国際ダイヤルコード。
number プロビジョニングされるWhatsApp番号。
vname_certificate 証明書は WhatsApp Business ダッシュボードから取得できます。> 注： をクリックするたびに 表示 ボタンをクリックすると、証明書が変更されます。次のステップで使用できるように、証明書をダウンロードするかコピーしてください。
method ワンタイムパスワード（OTP）の配信方法。以下のいずれかでなければなりません。 sms または voice.
waba_id WhatsApp番号のビジネスアカウントID。
curl -X POST https://api.nexmo.com/v0.1/whatsapp-manager/deployments\
  -H "Authorization: Bearer "$JWT\
  -H "Content-Type: application/json"\
  -d '{
        "country_code": "44",
        "number": "7877001122",
        "vname_certificate": "CnQKMAj669nb79e",
        "method": "sms",
        "waba_id": "345676589250625"
      }'

プロビジョニングが完了すると、WhatsAppクラスタは以下の段階を経て展開されます： INITIALIZING, CREATING_CLUSTER そして CLUSTER_CREATED.その時 CLUSTER_CREATED 段階に達すると、指定した番号にOTP音声通話またはSMSが送信され、配備ステータスは次のようになる。 CODE_SENT.OTP を受信したら、Verify API を呼び出して処理を完了する。

OTPのベリファイ

キー 説明
code 確認のために送信されるワンタイムパスワード。
curl -X POST https://api.nexmo.com/v0.1/whatsapp-manager/$DEPLOYMENT_ID/verify\
  -H "Authorization: Bearer "$JWT\
  -H "Content-Type: application/json"\
  -d '{ "code": "$CODE" }'

WhatsApp クラスタが正常にデプロイされたことを確認してください。 WhatsApp ビジネスプロフィール.

参考