クラウドAPI

ビジネスマネージャアカウントまたは単にビジネスアカウントと呼ばれているMetaビジネスアカウントは、ビジネスポートフォリオに改称されます。この変更は、Metaのテクノロジーに段階的に導入されます。この変更の対象は化粧品のみで、MetaビジネスアカウントID(ビジネスポートフォリオID)には影響はありません。

ビジネス電話番号

WhatsApp Businessアカウント(WABA)には、有効な専用のビジネス電話番号が必要です。このドキュメントでは、ビジネス電話番号の要件と機能、電話番号の登録方法、および登録された電話番号の管理方法について説明します。

ソリューションパートナーがいる場合、あなたに代わってソリューションパートナーがビジネス電話番号を管理します。

要件

登録対象となるには、ビジネス電話番号は次の条件を満たしていなければなりません。

  • 自身で所有している
  • 国番号と市外局番がある(ショートコードはサポートされていません)
  • 音声通話またはSMSの受信が可能(所有権を確認するメッセージを送信します)

登録された番号は、通話やテキスト メッセージなどの日常的な用途に引き続き使用できます。

WhatsApp MessengerアプリまたはWhatsApp Businessアプリで既に使用されている番号は、先に削除しない限り登録できません。番号を削除したい場合は、ヘルプセンターの記事アカウントの削除方法をご覧ください。

ブロックされたWhatsApp番号は、最初にブロックを解除しないと登録できません。アカウントがブロックされており、異議を申し立てたい場合は、サポートにお問い合わせください。

表示名

ビジネス電話番号の表示名は、WhatsAppマネージャに表示される名前です。次の条件を満たしている場合、WhatsAppチャットスレッドヘッダー、チャットリスト、およびそのプロフィールにも表示することができます。

  • ビジネス電話番号に関連付けられたWhatsApp Businessアカウントを所有するビジネスポートフォリオが、ビジネス認証を受けている。
  • ビジネス電話番号のname_statusがAPPROVEDである。

上記の条件を満たすと、ビジネス電話番号のverified_name(WhatsAppマネージャの表示名)が表示されます。

WhatsAppユーザーがアプリ内でビジネスのプロファイル名を編集した場合は、編集した名前が代わりに表示されることに注意してください。

表示名は、電話番号数の上限に達していない限り、ビジネス電話番号を追加する際に、アプリダッシュボード > [WhatsApp] > [API設定]パネル、または[WhatsAppマネージャ] > [アカウントツール] > [電話番号]パネルで設定できます。

認証を受けるためにビジネスポートフォリオを提出し、それが認証された場合、Metaは次のいずれかを行います。

  • 表示名を承認する
  • 表示名を却下する
  • さらにメッセージを送信するよう依頼する

いずれの場合も、phone_number_name_update WebhookとMeta Business Suite通知によってお知らせします。

承認された場合、ビジネス電話番号のname_statusがAPPROVEDに設定されます。

却下された場合、ビジネス電話番号のname_statusがDECLINEDに設定されます。表示名のガイドラインを再確認し、それに基づいて表示名を編集し、開発者サポートまたはエンタープライズ開発者サポートを通じて異議を申し立てることをおすすめします。

さらに多くのメッセージの送信を求められた場合、それは、該当番号で表示名承認が妥当かどうかを判断するためのAPI使用データが不足しているということです。引き続きAPIを使い、電話番号とメッセージの品質をモニタリングし、品質スコア改善のための適切な対応をしてください。表示名は、いずれ自動的に再審査されることになります。

電話番号を登録する

スタートガイドドキュメントのステップを完了すると、アプリダッシュボードを使用してビジネス電話番号を登録できます。

スタートガイドのドキュメントのステップを完了する際に番号を登録していない場合は、[アプリダッシュボード]に戻り、[WhatsApp] > [APIの設定]パネルに移動します。[ステップ5: 電話番号の追加]までスクロールダウンし、[電話番号を追加]ボタンをクリックし、フローを完了します。

登録プロセスの一環として、電話番号の所有者であることを確認するために、認証コードを含む音声またはSMSメッセージを電話番号に送信します。

WhatsAppマネージャを使用して番号を登録することもできます。詳しくは、WhatsApp Businessアカウントに電話番号をリンクする方法のヘルプセンター記事をご覧ください。

1-800の番号を登録する場合は、1-800および無料通話番号の登録で追加情報をご覧ください。

電話番号を削除する

制限

  • ビジネス電話番号を削除できるのは、ビジネスポートフォリオの管理者のみです。
  • 過去30日以内に有料メッセージの送信に使用された番号は削除できません。
  • 過去30日以内に有料メッセージの送信にこの番号を使用した場合、前回の有料メッセージの日付を示すインサイトページにリダイレクトされます。この日から30日経ったら、番号を削除することができます。

登録済みのビジネス電話番号を削除するには、次のようにします。

  1. WhatsAppマネージャで、ビジネスポートフォリオを読み込みます。
  2. [電話番号]パネルが自動的に読み込まれない場合は、[アカウントツール] (ツールボックスのアイコン) > [電話番号]に移動します。
  3. 電話番号のゴミ箱のアイコンをクリックして、フローを完了してください。

電話番号のステータスがリンク済みである場合、パスワードの入力を求められる場合があります。

1-800および無料通話番号を登録する

プラットフォームに1-800またはその他のフリーダイヤル番号を登録したいと思われるかもしれません。しかし、通常これらの番号ではInteractive Voice Response (IVR)システムがバックエンドで使用されており、WhatsApp登録通話はそのシステムを操作することができません。IVRシステムを使用している電話番号を登録することはできますが、国外の電話番号からの着信を受け入れることができ、かつSMSメッセージまたは音声通話を実際の人に転送できなければなりません。

IVRシステムを使用している電話番号の登録は次のように行います。

  1. WhatsAppは、登録通話の発信元となる電話番号を1つか2つシェアします。
  2. その番号を許可リストに載せます。許可リストにその番号を載せられない場合は、WABAにその電話番号を追加し、ダイレクトサポートチケットをオープンして、登録通話の電話番号をリクエストします。その際、登録しようとしている電話番号をチケットに記載してください。
  3. 登録通話を、登録コードをキャプチャする従業員またはメールボックスに転送します。

登録通話の着信ができないIVRシステムをバックエンドに使用している電話番号はサポートされていません。

登録された番号の制限

ビジネス電話番号は、一度に1つのAPIでのみ、つまりクラウドAPIかオンプレミスAPIのいずれか1つでのみ登録できます。

ビジネスポートフォリオは最初、登録済みのビジネス電話番号2つに制限されていますが、この上限は最大20つまで引き上げることができます。

ビジネスが認証済みである場合や、品質評価の高いテンプレートを使用して30日間の移行期間中にビジネス側が開始した会話が1,000件以上開始作成した場合は、MetaがAPIの利用量に応じてビジネスの電話番号の上限を引き上げるかどうかを判断します。

上限引き上げが妥当と判断される場合、上限は自動的に引き上げられ、business_capability_update WebhookとMeta Business Suite通知によって、新しい上限について通知されます。

上限引き上げが妥当でないと判断される場合、上限は2個のままになります。ビジネスが認証されてから1週間以上経過しても上限が2のままであるなら、電話番号とメッセージの品質をモニタリングしていることを確認した上で、品質スコア改善のための適切な対応をしてください。品質スコアが改善された後に、ビジネスの上限引き上げが妥当だと判断された場合、上限は自動的に引き上げられ、WebhookとMeta Business Suite通知によって、新しい上限について通知されます。

エンタープライズサポートにアクセスできる場合、上限を20より増やす必要があるなら、以下のように選択してダイレクトサポートチケットをオープンし、20を超える番号が必要な理由を説明してください。

[WABiz: アカウントとWABA] > [リクエストの種類] > [電話番号上限引き上げ]

電話番号のステータス

ビジネス電話番号にはステータスがあり、番号の品質評価と現在のメッセージングの上限の使用状況を反映しています(ビジネス電話番号がメッセージの上限に達すると、ステータスが変わります)。

ビジネスの電話番号ステータスは、[WhatsAppマネージャ] > [アカウントツール] > [電話番号]の[ステータス]フィールドに表示されます。ステータスは、GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>エンドポイントを使用してstatusフィールドをリクエストして取得することもできます。

品質評価とステータスについて詳しくは、ヘルプセンターのWhatsApp Business 電話番号の品質評価についての記事をご覧ください。

電話番号を移行する

電話番号をWABAから別のアカウントに移行するほか、オンプレミスAPIからクラウドAPIに移行することができます(その逆も同様)。

2段階認証PINの変更

ビジネス電話番号の2段階認証PINを変更するには、次のようにします。

  1. WhatsAppマネージャで、ビジネスポートフォリオを読み込みます。
  2. [電話番号]パネルが自動的に読み込まれない場合は、[アカウントツール] (ツールボックスのアイコン) > [電話番号]に移動します。
  3. 電話番号の設定(ギア)アイコンをクリックします。
  4. [2段階認証]をクリックします。
  5. [PINを変更する]をクリックし、フローを完了させます。

変更するには、現在のPINを入力する必要があります。APIを使用して新しいPINを設定することもできます。

2段階認証を無効にする

2段階認証を無効にするには、PINを変更する手順に従い、最後のステップで[2段階認証をオフにする]ボタンをクリックしてください。ビジネスポートフォリオに関連付けられているメールアドレスに、リンクを記載したメールが送信されます。2段階認証を無効にするにはこのリンクを使用してください。無効になったら、新しいPINを設定することで再度有効にできます。

会話コンポーネント

便利なメッセージUIコンポーネントを有効にして、WhatsAppユーザーがビジネスとやり取りしやすくすることができます。会話コンポーネントをご覧ください。