ビジネスが開始する通話

ビジネスが開始する WhatsApp Business Calling を使用すると、ユーザーが明示的に許可を付与した後、ユーザーに音声通話を発信できます。これにより、タイムリーで直接的なコミュニケーションが可能になり、Metaのオプトインポリシーと使用ポリシーの遵守が保証されます。

可用性

ビジネス開始通話は、ビジネス電話番号の国コードに基づいてWhatsApp送信者でサポートされています。

この機能は、WhatsApp for Businessプラットフォームが運営されているすべての国で利用できますが、以下を除きます。

• 米国
• カナダ
• ナイジェリア
• エジプト
• ベトナム
• トルコ

これらの国で登録されているビジネスは、ビジネス開始通話機能を使用できません。

通話権限のルール

ビジネスが電話をかける前に、ユーザーはWhatsApp API APIを使用して送信された権限リクエストを受け入れる必要があります。Metaは、以下のルールを適用します。

• 要求の制限
  • 24 時間ごとに 1 回の通話許可リクエスト を送信できます。
  • ユーザーが応答しない場合は、7 日以内に最大 2 つのアクセス許可要求を送信できます。
  
  
• ユーザーがアクセス許可を付与した後
  • 7 日間の許可期間中 は、24 時間以内に最大 5 件の通話を接続できます。
  • 通話が正常に接続されると、すべての制限がリセットされ、新しいアクセス許可要求をすぐに送信できます。
  
  
• 不在着信
  • 2 つの連続した呼び出し が応答されない場合、ユーザーは通話設定を確認するためのシステム プロンプトを受け取ります。
  • 4 回連続して呼び出し が応答されない場合、ユーザーのアクセス許可は 自動的に取り消されます。
  
  
• ユーザー制御
  • ユーザーは、いつでも通話のアクセス許可を取り消したり更新したりできます。

通話許可リクエストを送信する方法

自由形式の対話型通話許可メッセージ (アクティブなセッションの場合) またはテンプレート メッセージ (24 時間枠外) のいずれかを使用できます。

通話許可要求を含む自由形式の対話型メッセージ

このオプションを使用して、アクティブなセッション中にアクセス許可要求を送信します。ユーザーは、過去24時間にあなたのビジネスとやり取りしている必要があります。

POST https://api.infobip.com/whatsapp/1/message/interactive/call-permission-request
{
  "from": "{{cloudSender}}",
  "to": "{{destination}}",
  "messageId": "{{$uuid}}"
}

この方法は、24 時間のセッション ウィンドウ内の 進行中の会話 に使用します。

通話許可要求を含むメッセージテンプレート

事前承認済みのテンプレートを使用して、24 時間のセッション期間外 にアクセス許可を要求します。この方法は、非アクティブ後の再エンゲージメントまたはフォローアップに適しています。

POST https://api.infobip.com/whatsapp/2/senders/{{sender}}/templates
{
  "name": "template_with_call_permission_request",
  "language": "en",
  "category": "MARKETING",
  "structure": {
    "body": {
      "text": "We would like to call you to follow up on your request about {{1}} ",
      "examples": [
        "voice APIs"
      ]
    },
    "footer": {
      "text": "Talk to you soon"
    },
    "callPermissionRequest": {},
    "type": "MEDIA"
  }
}

このメソッドを使用して、セッションの有効期限が切れた後にユーザーを再エンゲージします。

通話許可要求を含むメッセージ テンプレートの送信は、 WhatsApp テンプレート メッセージの送信 (opens in a new tab)と似ています。

ユーザーの応答を受信する方法

通話アクセス許可要求に対するユーザーの応答は、Webhook で受信できます。Webhook は、API を使用して構成することも、Infobip Web インターフェイスで直接構成することもできます。

受信メッセージの設定の詳細については、ドキュメントを参照してください。

• Web インターフェイスで Webhook を設定する
  1. Infobip Web インターフェイス (opens in a new tab)にログインし、[チャネルと番号] >[番号]** (opens in a new tab) に移動します。
  2. 設定する番号をクリックまたはタップして、WhatsAppタブに移動します。
  3. 受信構成 で、通話アクセス許可要求への応答を受信する Webhook を定義します。

• API を使用した Webhook の設定
  • API を介して Webhook を設定するには、「WhatsApp 受信メッセージを受信する (opens in a new tab)」を参照してください。

ユーザーが通話アクセス許可要求を受け入れたときに Webhook に送信される正常な応答の例を次に示します。

{
  "results": [
    {
      "from": "{{cloudSender}}",
      "to": "{{destination}}",
      "integrationType": "WHATSAPP",
      "receivedAt": "2025-05-12T12:57:23.000+0000",
      "messageId": "wamid.HBgLMzI0NzUzODg3NzMVAgASGCAwQUNDNUU3NTA2OEE2OUVCNDUzQzE4MjRCRDk2RTk1MAA=",
      "pairedMessageId": "a28dd97c-1ffb-4fcf-99f1-0b557ed888da",
      "callbackData": "Callback data",
      "message": {
        "callPermissionReply": {
          "response": "ACCEPT",
          "expirationTimestamp": 1747659443000
        },
        "context": {
          "from": "{{cloudSender}}",
          "id": "a28dd97c-1ffb-4fcf-99f1-0b557ed888da",
          "groupId": null,
          "referredProduct": null
        },
        "type": "INTERACTIVE_CALL_PERMISSION_REPLY"
      },
      "contact": {
        "name": "Some One"
      },
      "price": {
        "pricePerMessage": 0,
        "currency": "EUR"
      }
    }
  ],
  "messageCount": 1,
  "pendingMessageCount": 4
}