RecPod のディープリンク機能 (iOS / Android)

🚧
Developer サイト内の URL 表記について
MiiTel のドメイン変更に伴い、Developer サイト内の一部ページに旧ドメインの URL が記載されている可能性があります。現在、該当箇所の確認および修正を順次進めております。

概要

RecPod のディープリンクは、RecPod の録音画面を直接開くためのリンクです。リンクに以下のパラメータを含めることができます。

対応アプリバージョン: 26.03.10 以降

externalId: 外部システムの識別子 ( 案件 ID など ) を録音データに紐づけることができます。
title: 録音画面の「会議タイトル」欄に自動入力する文字列を指定できます。

基本的な使い方

ディープリンクの形式

ディープリンクは以下の形式で作成してください。

https://link.miitel.com/record?externalId=12345&title=%E4%BC%9A%E8%AD%B0%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB

注意点: title や externalId は URL エンコードしておくのが安全です ( 日本語を含む場合など )。

上記の %E4%BC%9A%E8%AD%B0%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB は「会議タイトル」を URL エンコードしたものです。

リンクの使い方

作成したディープリンクをメモ帳やスマホアプリ内に配置します。
ディープリンクをタップまたはクリックします。
RecPod が起動し、録音画面が表示されます。
タイトルを指定している場合は、タイトル欄に自動入力されます。
必要に応じてタイトルを編集できます。
通常通り録音を開始・終了します。

QR コードでの利用

ディープリンクを QR コードにすることもできます。スマートフォンで QR コードを読み取るだけで、RecPod の録音画面を開くことができます。

注意点

ログインが必要: ディープリンクから録音画面を開くには、事前に RecPod にログインしている必要があります。

うまく動作しない時は

録音画面が開かない場合

RecPod にログインしているか確認してください。
リンクが https://link.miitel.com/record で始まっていることを確認してください。
RecPod を再起動して、もう一度リンクをタップしてください。

タイトルが表示されない場合

リンクに title パラメータが含まれているか確認してください。
タイトルが正しく URL エンコードされているか確認してください。

外部システムと紐づかない場合

リンクに externalId が含まれているか確認してください。
録音のアップロードが完了しているか確認してください。
複数のパラメータを持たせた場合は、externalId が正しく URL エンコードされているか確認してください。
外部システム側の設定を確認してください。

サンプルリンク

シンプルな例 ( 録音画面のみ開く ):

https://link.miitel.com/record

タイトル付きの例:

https://link.miitel.com/record?title=%E4%BC%9A%E8%AD%B0%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB

外部 ID とタイトル付きの例:

https://link.miitel.com/record?externalId=CASE-12345&title=%E4%BC%9A%E8%AD%B0%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB

外部 ID に複数のパラメータを入れたい場合 ( JSON 形式のものを URL エンコード ):

https://link.miitel.com/record?externalId=%7B%22ID%22%3A%22123tf%22%2C%22USERID%22%3A%22test-user%22%2C%22STYLE%22%3A%22%E6%97%A5%E6%9C%AC%E8%AA%9E%22%7D&title=%E4%BC%9A%E8%AD%B0%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB

上記 URL の QR コード ( テスト用 ):

上記の URL を QR コードにした例です。スマートフォンで読み取ると、RecPod の録音画面が開きます。

外部 ID に JSON を指定したディープリンクの QR コード例 ( テスト用 )

外部システムへの連携

ディープリンクで指定した externalId は、録音データのメタデータとして保存され、Outgoing Webhook 経由で外部システムに連携できます。

設定方法は Outgoing Webhook 会議履歴の仕様と利用方法を参照してください。

会議履歴の Webhook ペイロード内の video/metadata/rec_pod/externalId に、ディープリンクで設定したパラメータが反映されています。

例:

{
  "metadata": {
    "rec_pod": {
      "externalId": "{\"ID\":\"123tf\",\"USERID\":\"test-user\",\"STYLE\":\"日本語\"}"
    }
  }
}