Incoming Webhook ( 会議履歴 )
Incoming Webhook ( 会議履歴 ) を使用すると、MiiTel Meetings で利用可能な会議履歴を管理、収集、分析することができます。
この機能を使用するには？
Incoming Webhook ( 会議履歴 ) を使用する前に
まず、Incoming Webhook を設定するために使用する URL を作成する必要があります。
- https://account.miitel.jp/v1/signin にアクセスし、MiiTel Analytics にログインします。
- ページの左上にある ⋮⋮⋮ アイコンをクリックします。
- Admin をクリックして MiiTel Admin に移動します。
- MiiTel Admin で、外部連携 > Incoming Webhook をクリックします。
- 会議履歴 タブをクリックします。
- URL を作成 をクリックします。
- 設定画面に URL が表示されます。
注意事項
- 1 つの企業 ID につき、1 つの URL を作成することができます。
- URL を再作成したい場合は、
> 削除 をクリックして URL を削除し、その後で URL を作成 を再度クリックしてください
次に、Incoming Webhook ( 会議履歴 ) を使用するユーザーを許可し、ユーザー ID を取得します。
- ユーザー > ユーザーリスト をクリックします。
- Incoming Webhook ( 会議履歴 ) を使用するユーザーをクリックし、
- Incoming Webhook ( 会議履歴 ) を使用する を 有効にする にチェックを入れます。
- 保存 をクリックします。
- Incoming Webhook ( 会議履歴 ) を使用する許可を受けたユーザーの
- ID をコピー をクリックします。
Incoming Webhook ( 会議履歴 ) の設定
1. Incoming Webhook ( 会議履歴 ) URL にリクエストを送信
以下 URL より、Open API をご確認いただけます。
Open API もしくは、本ページ下部に記載している JSON Schema やリクエストサンプルを参考にして、 会議履歴生成をリクエストしてください。
2. ファイルをアップロード
リクエストを正常に送信すると、ファイルをアップロードするための URL が返されます。以下のファイル形式をアップロードできます。
- オーディオチャンネル：ステレオ、モノラル
- ファイル形式 ：API リファレンスに記載されている video_data.file_type を参照してください。
重要
オーディオチャンネルがモノラルの場合、ファイルのアップロード後に話者が判定されます。そのため、一部の会話で話者が誤って検出される可能性があります。
上記の URL に PUT メソッドでファイルを送信します。
リクエスト
| 説明 | |
|---|---|
| endpoint | 会議履歴を作成した後に受け取った URL |
| method | PUT |
| param | - |
| data | ファイル |
レスポンス
| ステータス200 | 説明アップロード完了 |
| 403 | URL が間違っている、またはリクエスト送信から 3 時間以上経過しセッションが期限切れになった |
上記の設定が完了したら、MiiTel Meeting の 会議履歴 が正常に作成されているか、エラーがないかを確認してください。エラーについては、以下の例を確認してください。
- 録画が表示されない場合、2. オーディオファイルをアップロード の設定が完了していない、またはアップロードが失敗している可能性があります。
- エラーバナーが表示される場合は、システム管理者にお問い合わせください。
追加情報: リクエストのデータ形式
リクエストスキーマ
会議履歴生成リクエストの JSON スキーマは以下のとおりです。
{
"$schema": "http://json-schema.org/draft-06/schema#",
"$ref": "#/definitions/Schema",
"definitions": {
"Schema": {
"type": "object",
"additionalProperties": false,
"properties": {
"video_data": {
"$ref": "#/definitions/VideoData"
}
},
"required": [
"video_data"
],
"title": "Schema"
},
"VideoData": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"file_type": {
"type": "string"
},
"host": {
"type": "string",
"format": "uuid"
},
"starts_at": {
"type": "string",
"format": "date-time"
},
"ends_at": {
"type": "string",
"format": "date-time"
},
"external_id": {
"type": "string"
},
"number_of_participants": {
"type": "integer"
},
"channel_type": {
"type": "string"
},
"tags": {
"type": "array",
"items": {
"$ref": "#/definitions/Tag"
}
},
"participants": {
"type": "array",
"items": {
"$ref": "#/definitions/Participant"
}
}
},
"required": [
"channel_type",
"ends_at",
"external_id",
"file_type",
"host",
"number_of_participants",
"participants",
"starts_at",
"tags",
"title"
],
"title": "VideoData"
},
"Participant": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"miitel_user_id": {
"type": "string",
"format": "uuid"
},
"stereo_lr": {
"type": "string"
}
},
"required": [
"miitel_user_id",
"name",
"stereo_lr"
],
"title": "Participant"
},
"Tag": {
"type": "object",
"additionalProperties": false,
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
],
"title": "Tag"
}
}
}
サンプルリクエスト
{
"video_data": {
"title": "Sample Video Title",
"file_type": "mp3",
"host": "123e4567-e89b-12d3-a456-426614174000",
"starts_at": "2025-03-10T10:00:00Z",
"ends_at": "2025-03-10T11:00:00Z",
"external_id": "external-id-123",
"number_of_participants": 2,
"channel_type": "STEREO",
"tags": [
{
"value": "tag1"
},
{
"value": "tag2"
}
],
"participants": [
{
"name": "Participant 1",
"miitel_user_id": "123e4567-e89b-12d3-a456-426614174001",
"stereo_lr": "left"
},
{
"name": "Participant 2",
"miitel_user_id": "123e4567-e89b-12d3-a456-426614174002",
"stereo_lr": "right"
}
]
}
}
Updated 14 days ago