プログラムによるIVRの動的な制御

NTT CPaaSの「IVRシナリオ起動API」を活用し、アウトバウンドコール(発信)と、その応用としてインバウンドコール(着信)の両方を自動化する方法を、具体的なシナリオを交えて解説します。

目的

「予約のリマインドコールを自動化したい」 「キャンペーンの案内を多くの顧客に一斉に届けたい」あるいは「電話での問い合わせに24時間365日対応できる仕組みを作りたい」といった、電話応対に関する課題はありませんか?

手動での電話対応には多くの時間とコストがかかり、対応時間も限られてしまいます。特に、確実な情報伝達が求められるリマインド業務や、時間帯によって応答内容を変えたい受付業務の自動化は、多くの企業にとって重要なテーマです。

本記事では、NTT CPaaSの「IVRシナリオ起動API」を活用し、アウトバウンドコール(発信)と、その応用としてインバウンドコール(着信)の両方を自動化する方法を、具体的なシナリオを交えて解説します。

※IVRシナリオの操作に使用するAPIの仕様については、Voice APIリファレンスをご参照ください。

概要: なぜIVRシナリオ起動APIなのか? - Momentsとの比較

NTT CPaaSには、顧客とのコミュニケーションを自動化する機能として「Moments」と「IVRシナリオ起動API」という2つの強力なツールがあります。どちらも自動化を実現しますが、その得意分野が異なります。

  • Moments(モーメンツ)
    GUIベースで直感的にシナリオを作成でき、メールやSMS、電話など複数のチャネルを組み合わせた複雑なマーケティングシナリオの実行が得意です。例えば、「特定の商品を購入した顧客に、1週間後にフォローアップのSMSを送り、さらにその3日後にアンケートメールを送る」といった、オムニチャネルで多段からなるステップ配信を簡単に構成することに適しています。
  • IVRシナリオ起動API
    電話(IVR) チャネルに特化しており、外部システムとの連携を前提としたAPIベースの制御が可能です。外部の顧客管理システム (CRM) や予約システムからのトリガーで、リアルタイムに電話を発信したり、かかってきた電話に対してSMSを含めた動的な応答もある程度対応していますが、電話を発端としたシナリオ作成となります。(もちろんAPIはこのほかにもメール、SMSなどチャネルごとに用意しそれらをお客様システムで動的に呼び出すことも可能となりますが、今回はIVRをとりあげて紹介します)

今回のテーマである「外部システムからの予約情報に基づくリマインド」や「API制御による動的なIVR受付」のように、外部の特定イベントを起点とした電話発信や、プログラムによる動的なIVR制御が求められるケースでは、他のシステムとの連携を前提として求められ、APIによる直接的な制御が可能な「IVRシナリオ起動API」が最適です。


サービス
NTT CPaaS NTT CPaaS

▶ アカウントをお持ちでない方へ|60日間無料トライアルを開始

チュートリアルの内容は、トライアル環境ですぐにお試しいただけます。クレジットカード情報の登録は不要、自動で課金されることもありません。送信テストや動作確認に、ぜひ無料トライアルをご活用ください。

※ 無料トライアルは発信のみ対象です。(着信はご利用いただけません)

実践シナリオ1: 【アウトバウンド編】予約リマインドコールの自動化

顧客の予約忘れを防ぎ、店舗の機会損失を減らすためのリマインドコールをAPIで自動化する手順を見ていきましょう。

ステップ1: IVRシナリオの作成 ※1

  1. NTTCPaaSのIVRシナリオ作成で、リマインド用の音声フローを作成します。例えば、「こんにちは、○○クリニックです。明日15時のご予約の確認です。ご予定通りお越しいただける場合は1を、ご変更やキャンセルの場合は2を押してください。」と発話させ、さらにその後の顧客の行動により案内を変えるといった、音声シナリオを設計します。
  2. シナリオを保存・アクティベートすると、一意のscenarioldが発行されます。このIDはAPI呼び出し時に必要になるため、必ず控えておきます。

curlサンプル:

curl -L "<YOUR_BASE_URL>/voice/ivr/1/scenarios" \
-H "Authorization: App <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d @- <<EOF
{
  "name": "クリニック予約リマインダー",
  "description": "ご予約の確認と、来院可否を伺うためのIVRシナリオです。",
  "script": [
    {
      "say": "こんにちは、○○クリニックです。明日15時のご予約の確認です。ご予定通りお越しいただける場合は1を、ご変更やキャンセルの場合は2を押してください。",
      "options": {
        "language": "ja",
        "voice": {
          "name": "Nanami (neural)",
          "gender": "Female"
        }
      },
      "speechRate": 1.0
    },
    {
      "collectInto": "confirmation_status",
      "options": {
        "maxInputLength": 1,
        "timeout": 10
      }
    },
    {
      "switch": "confirmation_status",
      "case": {
        "1": [
          {
            "say": "ありがとうございます。ご来院をお待ちしております。",
            "options": {
              "language": "ja",
              "voice": {
                "name": "Nanami (neural)",
                "gender": "Female"
              }
            }
          }
        ],
        "2": [
          {
            "say": "承知いたしました。後ほどスタッフよりご連絡いたします。",
            "options": {
              "language": "ja",
              "voice": {
                "name": "Nanami (neural)",
                "gender": "Female"
              }
            }
          }
        ],
        "_default": [
          {
            "say": "番号の入力が確認できませんでした。恐れ入りますが後ほどスタッフよりご連絡いたします。",
            "options": {
              "language": "ja",
              "voice": {
                "name": "Nanami (neural)",
                "gender": "Female"
              }
            }
          }
        ]
      }
    },
    {
      "say": "お電話ありがとうございました。",
      "options": {
        "language": "ja",
        "voice": {
          "name": "Nanami (neural)",
          "gender": "Female"
        }
      }
    },
    {
      "hangup": {}
    }
  ]
}
EOF

• curlレスポンス例:

下記の"id"部分がシナリオIDになります。

{"createTime": "2025-10-21T01:59:17.560+0000", "description":"ご予約の確認と、来院可否を伺うためのIVRシナリオです。", "id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "name":"クリニック予約リマインダー", "script": [{"say" : "こんにちは、○○クリニックです。明日15時のご予約の確認です。ご予定通りお越しいただける場合は1を、ご変更やキャンセルの場合は2を押してください。","options":{"language":"ja", "voice":{"name": "Nanami (neural)", "gender": "Female"}, "speechRate":1.0}},{"collectInto": "confirmation_status","options":{"maxInputLength": 1, "timeout":10}},{"switch": "confirmation_status", "case":{"1": [{"say":"ありがとうございます。ご来院をお待ちしております。","options":{"language":"ja", "voice":{"name": "Nanami (neural)", "gender": "Female"}}}],"2":[{"say" : "承知いたしました。後ほどスタッフよりご連絡いたします。","options": {"language":"ja", "voice":{"name": "Nanami (neural)", "gender": "Female"}}}],"_default":[{"say":"恐れ入りますが番号の入力が確認できませんでした。後ほどスタッフよりご連絡いたします。","options":{"language":"ja", "voice":{"name": "Nanami (neural)", "gender": "Female"}}}]}},{"say":"お電話ありがとうございました。","options": {"language":"ja", "voice":{"name":"Nanami (neural)", "gender": "Female"}}}, {"hangup":{}}]}

※1 IVRシナリオ作成のエンドポイントには多くの機能が備わっています。開発ドキュメントにも詳細は記載されていますが、ここでは頻繁に使用される主要な機能を下記にまとめます。

パラメーター名 説明
say テキスト読上げ
collect 「収集アクションは、ユーザーの電話から[ ・入力を読み取り、変数に保存
play 再生アクションは、クライアントの URL によって提供されるオーディオの再生
request エンドポイントに対して HTTP リクエストを実行
if-then-else 条件分岐
hangup 終話

ステップ2: IVRシナリオの起動

お使いの予約システム側で、リマインドコールを送りたいタイミング(例: 予約日の前日午前10時)をトリガーにして、以下のAPIリクエストをNTTCPaaSへ送信します。

エンドポイント: POST /voice/ivr/1/messages

説明: このエンドポイントに、事前に作成したscenarioldと、宛先となる顧客の電話番号をdestinationsに指定してリクエストします。callbackDataには予約IDなど、後でコール結果と照合するための任意のデータを含めることができ、非常に便利です。

• curlサンプル:

curl -L -g "<YOUR_BASE_URL>/voice/ivr/1/messages" \
-H "Authorization: App ${API_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d @- <<EOF
{
  "bulkId": "BULK-ID-IVR-0009",
  "messages": [
    {
      "scenarioId": "<YOUR_SCENARIO_ID>",
      "from": "<SENDER_NUMBER>",
      "destinations": [
        {
          "to": "<RECIPIENT_NUMBER>"
        }
      ],
      "callbackData": "ReservationID:A-12345",
      "notifyUrl": "https://example.com/ivr-callback"
    }
  ]
}
EOF

ステップ3: 結果の確認

APIリクエストが成功すると、指定した時間に顧客へ自動でリマインドコールが発信されます。通話結果(通話、応答なし等)の詳細は、リクエスト時にnotifyUrlで指定したWebhook URLでもリアルタイムに受け取ることができます(上記のcallbackDataとともに、notifyURLに送信されます)。

Webhookへのポスト内容抜粋:

{"results":[{"bulkId":"BULK-ID-IVR-0009", "messageId": "XXXXX", "from":"<SENDER_NUMBER>", "to":"<RECIPIENT_NUMBER>", "sentAt":"2025-10-21T11:23:49.830+0900", "mccMnc": null, "callbackData":"ReservationID:A-12345", "voiceCall":{"feature":"CALLS", "startTime": "2025-10-21T11:23:50.006+0900", "answerTime": null, "endTime": "2025-10-21T11:23:50.006+0900", "duration": 0, "chargedDuration": 0, "fileDuration":0.0, "dtmfCodes": null, "ivr":null},"price": {"pricePerSecond": 0.000000, "currency": "UNKNOWN"}, "status":{"id":15, "groupId": 4, "groupName": "EXPIRED", "name":"EXPIRED_EXPIRED", "description": "Message expired"}, "error":{"id":10201,"name": "BUSY", "description": "The end user is currently busy to receive the Voice call", "groupId": 2, "groupName": "USER_ERRORS", "permanent":true}}]}

実践シナリオ2: 【インバウンド編】電話番号とIVRシナリオの動的紐付け

Voiceシナリオ作成のAPIは本来アウトバウンド(発信)用ですが、その仕様を応用することで、インバウンド(着信)コールフローをAPI経由で動的に制御するという、有用な使い方が可能です。

通常、インバウンドコールは「特定の電話番号」と「特定のIVRシナリオ」を、NTTCPaaSポータルサイト>Moments>フローにて作成し紐づけておく必要があります。さらに同じ番号で異なるシナリオに変更するには一回フローを非アクティブ化、別フローを作成し紐づけを行う、といった作業が必要になります。このAPIを使えば、その紐付けを含む一連の流れを動的に変更することができます。

なお、下記シナリオを実現する際には、NTTCPaaS上での受電に対応した電話番号を購入・利用いただくことが前提です。

【ユースケース】

  • 時間帯によるIVRの切り替え: 営業時間内と時間外で自動音声で受付を行うシナリオに切り替える。
  • 緊急メンテナンス対応: 障害発生時に、問い合わせ窓口の電話番号を即座にメンテナンス案内用のIVRに切り替える。

ステップ1: IVRシナリオの作成

シナリオはユースケースごとに複数用意します。下記は営業時間と営業時間外で音声を切り替えたい場合の、営業時間外用のシナリオの作成サンプルです。シナリオ作成自体はアウトバウンドコールと同じです。

• curlサンプル (営業時間外シナリオに切り替える場合):

curl -L "<YOUR_BASE_URL>/voice/ivr/1/scenarios" \
-H "Authorization: App <YOUR_API_KEY>" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "name": "営業時間外シナリオ",
  "description": "営業時間外のご案内",
  "script": [
    {
      "say": "申し訳ありません。ただいまの時間は営業時間外となります。恐れ入りますが、午前9時から午後18時の営業時間内におかけ直しください。",
      "options": {
        "language": "ja",
        "voice": {
          "name": "Nanami (neural)",
          "gender": "Female"
        },
        "speechRate": 1.0
      }
    },
    {
      "hangup": {}
    }
  ]
}'

ステップ2: 番号の音声設定の作成

こちらのAPIでシナリオと電話番号の紐づけを行います。

エンドポイント: PUT/numbers/2/numbers/{numberKey}/voice

説明: numberKey(番号ID)に関しては、下記のようにポータルサイトで確認できます。

• curlサンプル:

curl -L -g <YOUR_BASE_URL>/numbers/2/numbers/{numberKey}/voice' \
-H "Authorization: App <YOUR_API_KEY>' \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "action": {
    "scenarioKey": "<YOUR_SCENARIO_ID>",
    "type": "FORWARD_TO_IVR"
  }
}'

[ChannelsとNumbers/番号]にて、受電に対応した電話番号を選択し詳細画面で表示される、[番号ID]がnumberKeyに該当します

ステップ3: 番号の音声設定の更新

API実行後、対象の電話番号に電話をかけると、指定した「時間外受付用シナリオ」が再生されることを確認します。同様に、営業開始時刻になったら「営業時間内用シナリオ」のscenarioldでAPIで更新することで、動的なIVRの運用が実現できます。

curl -L -g -X PUT <YOUR_BASE_URL>/numbers/2/numbers/{numberKey}/voice' \
-H "Authorization: App <YOUR_API_KEY>' \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
  "action": {
    "scenarioKey": "<YOUR_SCENARIO_ID>",
    "type": "FORWARD_TO_IVR"
  }
}'

まとめ

本記事では、「IVRシナリオ起動API」を使った標準的なアウトバウンドコールと、その応用としてインバウンドコールのIVRシナリオを動的に切り替える活用法を解説しました。

このAPIを活用することで、外部システムと連携した柔軟で高度な電話コミュニケーションの自動化が可能になります。手動対応の工数削減はもちろん、顧客体験の向上や、緊急時の迅速な情報伝達など、様々なビジネスシーンでその価値を発揮します。

ぜひ、貴社の業務効率化や顧客体験向上にお役立てください。

NTT CPaaSを、
60日間無料でお試しください

・SMS・Voice・メールを本番同様に無料で検証
・全API機能に即日アクセス / 有料プランと同一環境
・国内開発者向けに最適化された日本語ガイド

無料トライアル

目次
  1. 目的
  2. 概要: なぜIVRシナリオ起動APIなのか? - Momentsとの比較
  3. 実践シナリオ1: 【アウトバウンド編】予約リマインドコールの自動化
    1. ステップ1: IVRシナリオの作成 ※1
    2. ステップ2: IVRシナリオの起動
    3. ステップ3: 結果の確認
  4. 実践シナリオ2: 【インバウンド編】電話番号とIVRシナリオの動的紐付け
    1. 【ユースケース】
    2. ステップ1: IVRシナリオの作成
    3. ステップ2: 番号の音声設定の作成
    4. ステップ3: 番号の音声設定の更新
  5. まとめ

2025.11.07