最初の通話をアップロードする
音声ファイルをアップロードして文字起こしとAI分析を開始する方法を説明します。
対応フォーマットとファイルサイズ
| フォーマット | 拡張子 | 備考 |
|---|---|---|
| WAV | .wav | ステレオ音声に推奨。チャンネル分割対応。 |
| MP3 | .mp3 | 一般的なフォーマット。圧縮されていても問題なし。 |
| M4A | .m4a | iPhoneやMac録音に多い。 |
| OGG | .ogg | Opus/Vorbisコーデック対応。 |
⚠️ファイルサイズの上限は 500MB です。それ以上のファイルは事前にチャンクに分割してください。
アップロード手順
- ナビゲーションバーの アップロード をクリックします。
- ファイルをドラッグ＆ドロップするか、ファイルを選択 をクリックします。
- 下記のフィールドに必要事項を入力します（Call IDのみ必須）。
- ファイルをアップロード をクリックします。
アップロードフィールド
| フィールド | 必須 | 説明 |
|---|---|---|
| Call ID | 任意 | 固有の通話識別子。空白の場合はファイル名が使用されます。同じCall IDを再送すると409エラーが返ります。 |
| 言語 | 任意 | ja-JP（日本語）または en-US（英語）。空白の場合は組織のデフォルト言語が使用されます。 |
| Operator ID | 任意 | エージェントのID。エージェントスコアカードのリンクに使用されます。 |
| Customer ID | 任意 | 顧客のID。CRMとの連携に使用できます。 |
| Department | 任意 | 部署名。分析のフィルタリングに使用できます。 |
| Call Date | 任意 | 通話の実施日。省略した場合はアップロード日が使用されます。 |
ジョブキューの動作
アップロード後、ファイルはAWS S3に保存され、処理ジョブがSQSキューに追加されます。ワーカーサービスがジョブを取得してAmiVoiceに送信します。
| ステータス | 意味 |
|---|---|
| Queued（キュー待ち） | S3にアップロード済み。SQSキュー待ち。 |
| Processing（処理中） | ワーカーがAmiVoiceで文字起こし中。 |
| Done（完了） | 文字起こしと（自動分析が有効な場合は）AI分析が完了。 |
| Failed（失敗） | エラーが発生。ログを確認してください。 |
ℹ️ダッシュボードとアップロードページは 5秒ごとに自動更新 されます。処理時間の目安は実時間の1〜2倍です（5分の通話なら5〜10分）。
APIによる自動取り込み（代替手段）
CRMや録音システムからの自動連携には Ingest API を使用します。X-API-Key ヘッダーで認証します。
curl -X POST https://app.koeiq.com/api/ingest/upload \ -H "X-API-Key: your_api_key" \ -F "file=@recording.wav" \ -F "call_id=CALL-001" \ -F "language=ja-JP"
💡APIキーは 設定 → APIキー で生成できます。詳細は Ingest API ドキュメント を参照してください。