AIオペレータの停止

指定した通話のAIオペレータの動作 (会話認識や発話処理) を停止します。

停止した通話では、通話相手先の発話に対してAIオペレータは一切の反応を行いませんが、通話録音は継続して行われます。

リクエスト

POST <ベースURL>/v1/calls/{callId}/stop

パス・パラメータ

callId

stringrequired

停止する対象のコールID。
ユーザーコールの発信APIで生成したユーザーコールのコールIDは指定できません。

リクエスト・ヘッダ

x-commubo-tenantId

stringrequired

commubo契約時に発行される、ご契約事業者さま固有のテナントID。「commubo connect ご契約ユーザーさまダッシュボード・ページ」内の「設定 / テナント」メニューから確認できます。

x-commubo-accessToken

stringrequired

commubo契約時に発行される、ご契約事業者さま固有のアクセストークン。「commubo connect ご契約ユーザーさまダッシュボード・ページ」内の「設定 / テナント」メニューから確認できます。

リクエスト・ボディ

リクエスト・ボディは必要ありません。

curl コマンドにおける例

AIオペレータの停止

curl -X POST \
  "https://connect.commubo.com:65536/v1/calls/1234567890123456/stop" \
  -H "x-commubo-tenantId: 12345678-90AB-CDEF-1234-567890ABCDEF" \
  -H "x-commubo-accessToken: FEDCBA09-8765-4321-FEDC-BA0987654321"

※ 赤字部分はご契約事業者さまの環境に合わせ、適切なパラメータを指定してください。

レスポンス

200 OK

リクエストが成功し、AIオペレータの動作が停止されたことを示します。
レスポンス・ボディは返しません。

403 Forbidden

テナントID またはアクセストークンが正しくないなど、アクセスが許可されないことを示します。
JSON 形式のレスポンス・ボディに、エラーの原因を示す場合があります。

404 Not Found

リエクストのパス・パラメータで指定されたコールID の通話が存在しない、または通話状態でないことを示します。
JSON 形式のレスポンス・ボディに、エラーの原因を示す場合があります。

406 Not Acceptable

リエクストのパス・パラメータで指定されたコールID の通話が、ユーザーコールであることを示します。
JSON 形式のレスポンス・ボディに、エラーの原因を示す場合があります。