このガイドでは、PSTN（公衆交換電話網）を使用してFin VoiceをFive9と統合する方法を説明します。Five9で番号を購入し、IVRスクリプトを設定してFinに通話を登録・転送し、Finが顧客と話した後の結果に基づくルーティングロジックを構築します。

注意: Fin Voiceは現在、当社の営業チームと提携している特定の顧客に限定されています。価格について詳しく知りたい場合は、担当アカウントマネージャーにお問い合わせください。

開始前に

開始する前に以下が必要です：

ステップ1: IntercomアプリとAPIトークンの設定

Five9からIntercom APIへのリクエストを認証するために、Intercom APIアクセス・トークンが必要です。

注意: このトークンは、後述のFive9 IVRクエリブロックでベアラートークン認証を設定する際に使用します。

Five9の設定を始める前に、IntercomでFin Voiceの回線と設定を準備してください。

IntercomでFin AI Agent > Deploy > Phone > Set Fin Liveに移動します。
まだ回線を持っていない場合は、+ New lineをクリックし、指示に従ってFin Voice番号を購入してください。この番号はFive9のIVR転送設定時に必要なのでコピーしておきます。

Finを電話サービスプロバイダーと統合する前に、動作をカスタマイズできます。

顧客とのやり取りを確認し、Finが各通話をどのように処理したかを見るために、録音と文字起こしを有効にしてください。

注意: これはすべての電話通話に対するグローバル設定です。一部の通話だけ録音や文字起こしを有効にすることはできません。

IVRスクリプトは通話の流れを管理します：通話をIntercomに登録し、Finに転送し、結果を収集して適切にルーティングします。

IVRにQueryブロックを追加し、着信通話をIntercomに登録するよう設定します。

これにより、Five9の通話とIntercomの会話をリンクする参照が作成されます。

ペイロードセクションに以下のJSON構造を含めます：

{
  "phone_number": "&&Call.ANI&&",
  "call_id": "&&Call.call_id&&",
  "source": "five9"
}

レスポンスタブで、許容されるレスポンス範囲を200–200に設定します。

注意: このAPIエンドポイントの詳細はRegister a Fin Voice callのドキュメントを参照してください。

3rd party transferアイコンをクリックしてIVRスクリプトに追加します。
3rd party numberに、IntercomのデプロイUI（ステップ2）で設定したFin Voice番号を入力します。
Return after 3rd party callにチェックを入れ、Finが通話処理を終えた後にIVRに制御が戻るようにします。
IntercomでFin AI Agent > Deploy > Phone > Set Fin Liveに移動します。
If Fin can’t resolve the conversationセクションで、Forward the callを選択します。
Five9 Escalation Line番号を入力します。
Close the conversation when the call is forwardedを有効にし、保存をクリックします。これによりFinは通話を終了し、Five9がルーティングを引き継ぎます。

Finの通話結果からデータを取得するために2つの変数が必要です：

2つ目のQueryブロックを追加し、顧客の電話番号を使って通話詳細を取得します。

メソッド: GET
エンドポイント: https://api.intercom.io/fin_voice/phone_number/{{phone_number}}。ここで{{phone_number}}は発信者のANIです。詳細はCollect Fin Voice call by phone numberのドキュメントを参照してください。
認証: ベアラートークン

注意: このAPIエンドポイントの詳細はCollect Fin Voice call by phone numberのドキュメントを参照してください。

レスポンスタブで、Finの応答を抽出する正規表現パーサーを追加し、fin_outcome変数にバインドします。