BPCC Interaction コンテンツ API を使用すると、現在以下のことが可能です：
\n本ドキュメントでは、対応するREST APIメソッドについて、リクエストおよびレスポンスの例を交えて説明しています。このAPIは、 Postman API 開発環境 に読み込み、独自のアクセストークンを使用してAPIとやり取りすることができます。
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"58450950","collectionId":"d2954597-6afb-4724-afe8-28863c270264","publishedId":"2sBYB4Lmka","public":true,"customColor":{"highlight":"FF6C37","right-sidebar":"303030","top-bar":"FFFFFF"},"publishDate":"2026-09-29T10:20:26.000Z"},"item":[{"name":"認証","item":[{"name":"Get Access Token","id":"bbb0b721-d728-44c4-99b9-6b49053ef6f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"client_id","value":"","description":"Username of a BP user authorized to export recordings via API.
\n","type":"text"},{"key":"client_secret","value":"","description":"API secret key generated for the above user.
\n","type":"text"},{"key":"scope","value":"","description":"Your contact center domain name, e.g., example.brightpattern.com.
\n","type":"text"},{"key":"grant_type","value":"","description":"Grant type. Must be set to client_credentials.
\n","type":"text"}]},"url":"https://:tenant_url/configapi/v2/oauth/token","description":"このAPIを経由して行われる後続の各リクエストの認証に使用されるアクセストークンを返します。
\n","urlObject":{"protocol":"https","port":"tenant_url","path":["configapi","v2","oauth","token"],"query":[],"variable":[{"description":{"content":"コンタクトセンターのドメイン名（例：example.brightpattern.com）。
\n","type":"text/plain"},"type":"any","value":"","key":"tenant_url"}]}},"response":[{"id":"9613fcdd-0e53-478d-88c0-7a4514feb2de","name":"Get Access Token","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"client_id","value":"admin","description":"[Username](https://help.brightpattern.com/latest:Contact-center-administrator-guide/UsersandTeams/Users/ja#Username) of a BP user authorized to [export recordings via API](https://help.brightpattern.com/latest:Contact-center-administrator-guide/UsersandTeams/Privileges/ja#Allow_recording_export_API_access). \n","type":"text"},{"key":"client_secret","value":"X0vhlwMc6YoEbQDDqQGM9nOw8p7v9110rjTL1COxGBnpIAZvY6ryrrBQT5N28qS9","description":"API secret key generated for the above user.","type":"text"},{"key":"scope","value":"sasha.brightpattern.com","description":"Your contact center domain name, e.g., *example.brightpattern.com*.","type":"text"},{"key":"grant_type","value":"client_credentials","description":"Grant type. Must be set to *client_credentials*.","type":"text"}]},"url":{"raw":"https://:tenant_url/configapi/v2/oauth/token","protocol":"https","port":"tenant_url","path":["configapi","v2","oauth","token"],"variable":[{"key":"tenant_url","value":"sasha.brightpattern.com","description":"Your contact center domain name, e.g., example.brightpattern.com."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0"},{"key":"Date","value":"Mon, 22 Apr 2019 03:22:51 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"242"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"access_token\": \"F25D3BD6FCF559A63CAA5BBE5021C238B0F1B57D3D7D3EA3C9B4FA779B549A20\",\n \"token_type\": \"Bearer\",\n \"expires_in\": \"3600\",\n \"scope\": \"sasha.brightpattern.com\"\n}"}],"_postman_id":"bbb0b721-d728-44c4-99b9-6b49053ef6f2"}],"id":"3853d868-ab5b-40ad-985a-f10bb08dab50","description":"このAPIのクライアントを認証するために、OAuth 2.0クライアントクレデンシャルグラントが使用されます。認証されたユーザーが、要求された操作を実行するための適切な権限を持っているかどうかが確認されます。権限の完全なリストはこちらでご確認いただけます。権限は、1つまたは複数の役割を介してユーザーに割り当てられます。
\nアクセストークンを取得するには：
\n指定された通話録音の全参加者の音声が収録された音声ファイルを、GSMフォーマットで返します。
\n","urlObject":{"protocol":"https","port":"tenant_url","path":["configapi","v2","recordings","audio"],"query":[{"description":{"content":"\n","type":"text/plain"},"key":"giid","value":"A44B62DE-75FB-47CD-A103-8F778CD1032A"},{"description":{"content":"記録を取得するインタラクションのステップ識別子です。シナリオ変数 $(item.interactionStepId) または、レポート用データベースの call_detail テーブルにある callee_interaction_step_id フィールドから取得できます。
\n","type":"text/plain"},"key":"stepid","value":"C6A1ECF1-6C4E-4D13-B848-718273ECB0CA"},{"key":"","value":""}],"variable":[{"description":{"content":"コンタクトセンターのドメイン名（例：example.brightpattern.com）。
\n","type":"text/plain"},"type":"any","value":"","key":"tenant_url"}]}},"response":[{"id":"06a2a28f-dca1-44e3-8180-6266f3951947","name":"Get Audio File","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://:tenant_url/configapi/v2/recordings/audio?giid=A44B62DE-75FB-47CD-A103-8F778CD1032A&stepid=C6A1ECF1-6C4E-4D13-B848-718273ECB0CA&=","protocol":"https","port":"tenant_url","path":["configapi","v2","recordings","audio"],"query":[{"key":"giid","value":"A44B62DE-75FB-47CD-A103-8F778CD1032A","description":"[Global interaction identifier](https://help.brightpattern.com/latest:Reporting-reference-guide/GlobalInteractionIdentifier/ja)."},{"key":"stepid","value":"C6A1ECF1-6C4E-4D13-B848-718273ECB0CA","description":"Identifier of the step of the interaction for which the recording is to be retrieved. Can be obtained via scenario variable *$(item.interactionStepId)* or the *caller_interaction_step_id* field of the *call_detail* table of the Reporting Database."},{"key":"","value":""}],"variable":[{"key":"tenant_url","value":"sasha.brightpattern.com","description":"Your contact center domain name, e.g., example.brightpattern.com."}]}},"_postman_previewlanguage":"Text","header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"66314af4-4def-4e9d-99b9-d8ce4f20164b"},{"name":"Get Interaction Metadata","id":"52f0d7a8-57a2-49d9-a753-a07ea5fe5060","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"指定されたインタラクションについて、以下のメタデータを返します。
\n","urlObject":{"protocol":"https","port":"tenant_url","path":["configapi","v2","recordings","metadata"],"query":[{"description":{"content":"\n","type":"text/plain"},"key":"giid","value":"A44B62DE-75FB-47CD-A103-8F778CD1032A"},{"description":{"content":"メタデータの取得が要求されているインタラクションのステップの識別子です。シナリオ変数 $(item.interactionStepId) または、レポーティングデータベースの call_detail テーブルにある callee_interaction_step_id フィールドから取得できます。
\n","type":"text/plain"},"key":"stepid","value":"C6A1ECF1-6C4E-4D13-B848-718273ECB0CA"}],"variable":[{"description":{"content":"コンタクトセンターのドメイン名（例：example.brightpattern.com）。
\n","type":"text/plain"},"type":"any","value":"","key":"tenant_url"}]}},"response":[{"id":"b69c72b6-cbc8-4352-b998-1a82895e1eb3","name":"Metadata of IVR-only Call","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://:tenant_url/configapi/v2/recordings/metadata?giid=9F63B008-4BA3-4022-90F7-A8B99ED1A3E8&stepid=89B5E090-F584-4AAA-973A-02C0524BF9CB","protocol":"https","port":"tenant_url","path":["configapi","v2","recordings","metadata"],"query":[{"key":"giid","value":"9F63B008-4BA3-4022-90F7-A8B99ED1A3E8","description":"[Global interaction identifier](https://help.brightpattern.com/latest:Reporting-reference-guide/GlobalInteractionIdentifier/ja)."},{"key":"stepid","value":"89B5E090-F584-4AAA-973A-02C0524BF9CB","description":"Identifier of the interaction step to be retrieved. Can be obtained via scenario variable *$(item.interactionStepId)* or the *caller_interaction_step_id* field of the *call_detail* table of the Reporting Database."}],"variable":[{"key":"tenant_url","value":"sasha.brightpattern.com","description":"Your contact center domain name, e.g., *example.brightpattern.com*."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0"},{"key":"Date","value":"Fri, 15 Mar 2019 19:41:22 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"583"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"Start Time\": \"02/27/2019 01:04:52 AM UTC +00:00\",\n \"Agent loginId\": null,\n \"Agent First Name\": null,\n \"Agent Last Name\": null,\n \"Customer phone\": \"Restricted\",\n \"Direction\": \"INBOUND\",\n \"Service\": \"Sales\",\n \"Disposition\": \"No agent\",\n \"Notes\": \"\",\n \"Voice Signature\": \"0\",\n \"Flagged\": \"0\",\n \"Talk Time\": \"0:11\",\n \"RecordingId\": \"20190226170452_Restricted_89B5E090F5844AAA973A02C0524BF9CB.wav\",\n \"Global Interaction ID\": \"9F63B008-4BA3-4022-90F7-A8B99ED1A3E8\",\n \"Review URL\": \"https://sasha.brightpattern.com/admin?giid=9F63B008-4BA3-4022-90F7-A8B99ED1A3E8&stepId=89B5E090-F584-4AAA-973A-02C0524BF9CB\",\n \"Screen Recording\": \"0\"\n}"},{"id":"0ad1aa6b-f0ee-4269-a1fa-9fac86ffb332","name":"Metadata for a call with a live agent","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://:tenant_url/configapi/v2/recordings/metadata?giid=A44B62DE-75FB-47CD-A103-8F778CD1032A&stepid=C6A1ECF1-6C4E-4D13-B848-718273ECB0CA","protocol":"https","port":"tenant_url","path":["configapi","v2","recordings","metadata"],"query":[{"key":"giid","value":"A44B62DE-75FB-47CD-A103-8F778CD1032A","description":"[Global interaction identifier](https://help.brightpattern.com/latest:Reporting-reference-guide/GlobalInteractionIdentifier/ja)."},{"key":"stepid","value":"C6A1ECF1-6C4E-4D13-B848-718273ECB0CA","description":"Identifier of the interaction step to be retrieved. Can be obtained via scenario variable *$(item.interactionStepId)* or the *caller_interaction_step_id* field of the *call_detail* table of the Reporting Database."}],"variable":[{"key":"tenant_url","value":"sasha.brightpattern.com","description":"Your contact center domain name, e.g., *example.brightpattern.com*."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.14.0"},{"key":"Date","value":"Fri, 15 Mar 2019 20:21:33 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"603"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"Start Time\": \"03/15/2019 07:49:31 PM UTC +00:00\",\n \"Agent loginId\": \"navarro\",\n \"Agent First Name\": \"Jose\",\n \"Agent Last Name\": \"Navarro\",\n \"Customer phone\": \"Restricted\",\n \"Direction\": \"INBOUND\",\n \"Service\": \"Support\",\n \"Disposition\": \"Solved\",\n \"Notes\": \"\",\n \"Voice Signature\": \"0\",\n \"Flagged\": \"0\",\n \"Talk Time\": \"0:38\",\n \"RecordingId\": \"20190315124931_Restricted_navarro_C6A1ECF16C4E4D13B848718273ECB0CA.wav\",\n \"Global Interaction ID\": \"A44B62DE-75FB-47CD-A103-8F778CD1032A\",\n \"Review URL\": \"https://sasha.brightpattern.com/admin?giid=A44B62DE-75FB-47CD-A103-8F778CD1032A&stepId=C6A1ECF1-6C4E-4D13-B848-718273ECB0CA\",\n \"Screen Recording\": \"0\"\n}"}],"_postman_id":"52f0d7a8-57a2-49d9-a753-a07ea5fe5060"},{"name":"Erase Call Recordings","id":"9358de66-30b0-43c8-a4e5-29ba4d30af4c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://この方法では、ローカルに保存されている通話録音を消去します。なお、その対話のグローバルインタラクション識別子（GIID）をリクエストURLのクエリパラメータとして含める必要があります
\nその対話のグローバルインタラクション識別子
\n","type":"text/plain"},"key":"giid","value":"（オプション）録音を消去する理由
\n","type":"text/plain"},"key":"reason","value":"これらのメソッドにより、通常の音声録音（すなわち、参加した全員の声が同じ音声ファイルに記録されているもの）および関連するコールメタデータを取得することができます。音声ファイルとメタデータの両方は、通話終了直後に取得可能です。録音の識別に必須のパラメータは、シナリオ変数 $(item.globalInteractionId) および $(item.interactionStepId) 経由で取得できます。\n通常の通話録音は、GSMフォーマットでエクスポートされます。
\n","event":[{"listen":"prerequest","script":{"id":"8fc0f216-e6cf-44c9-974b-f55430e3236c","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"45640944-0074-4b65-b880-ce0eae67a921","type":"text/javascript","exec":[""]}}],"_postman_id":"9adccb9f-884b-43fc-b056-0f65843eb741"},{"name":"マルチチャネルの通話録音","item":[{"name":"Get Multichannel Recording Structure","id":"bc06a8f3-f494-4ef2-9c8a-b36782d2e1f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"このメソッドは、特定のマルチチャネル通話録音の構造に関する情報を取得するために使用されます。通話は、グローバルインタラクション識別子（GIID）によって識別されます。この記事では、コールのGIIDを取得するためのさまざまな方法について説明しています。
\nAPIの応答はオブジェクトの配列であり、各オブジェクトには、そのGIIDに関連する特定のインタラクションのメタデータが含まれています。
\nparties配列には、1つ以上のPartyオブジェクトが含まれます。
recordings配列には、1つ以上のRecording Segmentオブジェクトが含まれます。
GIID、インタラクションID、パーティーID、および必要に応じて目的のセグメントの順序番号によって識別される、マルチチャネル録音の目的のセグメントを取得します。この順序番号は、通話中に録音を一旦停止し、再度開始することがある場合のみ、必須となります。
\n","urlObject":{"protocol":"https","port":"tenant_url","path":["configapi","v2","multi_channel_recordings","audio"],"query":[{"description":{"content":"グローバルインタラクション識別子。GIIDに含まれる文字はすべて大文字でなければなりません。
\n","type":"text/plain"},"key":"giid","value":"B3178008-47BA-4CAB-B620-CB3C8864BCB6"},{"description":{"content":"録音の要求対象となるインタラクションの識別子です。（「Get Multi-channel Recording Metadata」メソッドによって返されます。）識別子に含まれる文字は、すべて大文字でなければなりません。
\n","type":"text/plain"},"key":"iid","value":"A274FC70-770E-45B0-AC77-491EF6CD8E05"},{"description":{"content":"音声録音の提供が求められているパーティーの識別子です。（Get Multi-channel Recording Metadata メソッドによって返されます。）
\n","type":"text/plain"},"key":"party","value":"98141181"},{"description":{"content":"上記のパーティーの、指定したい録音セグメントの序数（0から数えます）。 任意です。指定されていない場合は、配列の最初のセグメントが返されます。
\n","type":"text/plain"},"key":"recid","value":"0"}],"variable":[{"description":{"content":"コンタクトセンターのドメイン名（例：example.brightpattern.com）。
\n","type":"text/plain"},"type":"any","value":"","key":"tenant_url"}]}},"response":[],"_postman_id":"824a1bf3-1eb6-49df-9dae-e307339ec33a"}],"id":"0aeef4db-7ed2-4cb3-accb-b34371897510","description":"これらのメソッドは、マルチチャネルの通話録音（つまり、通話参加者それぞれの音声が別々の音声ファイルに記録されている録音）から個々のセグメントを抽出するために使用されます。
\nまず、「_Get Multichannel Recording Structure_」メソッドを使用して、対話ID、パーティーID、および必要に応じてセグメントを取得し、それらをその後の_「Get Multichannel Recording Segment Audio File」_リクエストで使用します。
\nマルチチャネル録音のセグメントは、通話終了直後にエクスポート可能となります。
\nマルチチャネル録音のセグメントは、音声品質を最大限に高めるため、非圧縮のPCMフォーマットでエクスポートされます。なお、マルチチャネルPCM録音ファイルのサイズは大きいため、通常、システム内での保存期間は限られています。 制限についてはサービスプロバイダにご確認いただき、前営業日の録音の中から選択済みのものを夜間にエクスポートすることをご検討ください。
\n","event":[{"listen":"prerequest","script":{"id":"1540d080-5b84-44c0-b20e-96c1cae68231","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"0cee1497-0d59-4190-a62c-1c6416b2faaf","type":"text/javascript","exec":[""]}}],"_postman_id":"0aeef4db-7ed2-4cb3-accb-b34371897510"},{"name":"エラーコード","item":[],"id":"be9e241b-c7b4-4b08-abfa-1c74b036d720","description":"