じぶんシリーズ

じぶん kintone 連携 for Zoom Phone
設定マニュアル

「じぶん kintone 連携 for Zoom Phone」(Zoom Phone通話記録プラグイン/Zoom Phone外部連絡先同期プラグイン)の導入・設定・利用方法をご案内します。

概要

じぶん kintone 連携 for Zoom Phoneは、Zoom Phoneの通話記録機能とkintoneの顧客データベースをZoom外部連絡先へ同期する以下2つのプラグインの総称です。

Zoom Phone通話記録プラグイン
Zoom Phoneの通話終了後、音声の文字起こしとAI要約を行い、その結果を自動でkintoneへレコード保存します。通話メモの作成が不要になり、通話内容を可視化することができるため、情報を活用し対応品質を改善することが可能になります。
Zoom Phone外部連絡先同期プラグイン
kintoneに登録されている顧客情報を、Zoom外部連絡先と連携します。Zoom Phoneの「外部アプリまたは着信通話用URLを起動する」機能と併用することで、着信時に顧客情報をポップアップ表示することができるため、通話開始前に状況把握を行い、通話品質の向上につなげることが可能です。

注意事項・前提条件

  • Zoom Phoneの1ライセンス以上の契約
  • kintone スタンダードコースの契約
  • 株式会社ソニックガーデンが提供する「じぶん kintone 連携 for Zoom Phone」の契約
    ご契約されていない場合はお問い合わせフォームよりお問い合わせください。

Zoom Phoneアカウントの要件

kintoneと連携するZoomアカウントに関して、以下すべてを満たす必要があります。

  • adminスコープを付与できるアカウントレベルの管理権限を持っていること
  • 電話番号を割り当てたZoom Phoneライセンスであること
  • 自動通話録音が有効であること
  • 録音文字起こしが有効であること

導入手順を進める順番

  • 「Zoom Phone外部連絡先同期プラグイン」を、弊社が用意したテンプレートファイルから作成したアプリでご利用になる場合
    → 手順 1 / 2 / 3 / 4 / 6 / 7 の順番でご対応ください。
  • 「Zoom Phone外部連絡先同期プラグイン」を、自社で作成したアプリでご利用になる場合
    → 手順 1 / 2 / 3 / 4 / 5 / 6 / 7 の順番でご対応ください。「3. テンプレートファイルからアプリを作成する方法」の「顧客管理アプリ.zip」のダウンロードは不要です。

本製品の導入手順

導入の途中で問題が発生し、本マニュアルの手順で解決しない場合は、サポートページのお問い合わせ先からご連絡ください。

1プラグインダウンロード方法

  1. ご契約時に弊社からお送りしたマイページURLを開き、[Zoom連携プラグインDLページ]のボタンをクリックします。

  2. [詳細]をクリックします。

  3. 以下の2ファイルのリンクをクリックして、任意のフォルダにダウンロードします。

    • kintone-zoom-phone-sync-external-contacts-plugin-1.zip
    • kintone-zoom-phone-call-log-plugin-1.zip

2kintoneにプラグインをインストールする方法

  1. cybozu.comの共通ログインページにアクセスします。

  2. サブドメイン名を入力して[ログイン画面へ]をクリックします。

  3. ログイン名とパスワードを入力し[ログイン]をクリックします。

  4. [kintone]をクリックします。

  5. 右上にある[歯車マーク]をクリックします。

  6. [kintoneシステム管理]をクリックします。

  7. その他セクション内にある[プラグイン]をクリックします。

  8. [読み込む]をクリックします。

  9. [参照]をクリックします。

  10. 「kintone-zoom-phone-sync-external-contacts-plugin-1.zip」を選択し[開く]をクリックします。

  11. [読み込む]をクリックします。

  12. 再度、[読み込む]をクリックします。

  13. [参照]をクリックします。

  14. 「kintone-zoom-phone-call-log-plugin-1.zip」を選択し[開く]をクリックします。

  15. [読み込む]をクリックします。

  16. 左上の[家マーク]をクリックし、ポータル画面に戻ります。

3本プラグインをインストールするアプリを、テンプレートファイルから作成する方法

※「Zoom Phone 通話記録プラグイン」は、弊社が用意した『Zoom Phone通話記録』アプリのテンプレートファイルを必ずご利用ください。

  1. ご契約時に弊社からお送りしたマイページURLを開き、[Zoom連携プラグインDLページ]のボタンをクリックします。

  2. [詳細]をクリックします。

  3. 以下のファイルのリンクをクリックして、任意のフォルダにダウンロードします。

    • Zoom Phone通話記録.zip
    • 顧客管理アプリ.zip(※「Zoom Phone外部連絡先同期プラグイン」を、自社で作成されたアプリで利用する場合はダウンロード不要です。手順4にお進みください。)
  4. kintoneの画面に戻り、ダウンロードしたテンプレートファイルからアプリを作成します。
    外部リンク:テンプレートファイルからアプリを作成する方法

4「Zoom Phone外部連絡先同期プラグイン」をインストールするアプリに必要なフィールドを追加する方法

※弊社が用意したテンプレートファイルから作成したアプリをご利用になる場合は、対応不要です。

  1. 右下にあるアプリセクションから、「Zoom Phone外部連絡先同期プラグイン」をインストールするアプリ名をクリックし開きます。

  2. [歯車マーク]をクリックします。

  3. 以下のフィールドを追加します。
    外部リンク:フィールドの追加方法

    フィールド名フィールドコードフィールドタイプ
    Zoom用電話番号intl_tel文字列(1行)
    外部連絡先IDexternal_contact_id文字列(1行)
    最終同期リビジョンlast_sync_revision数値
    同期ステータスsync_status文字列(1行)

    ※連携する電話が複数ある場合は、「Zoom用電話番号」のフィールドコードの末尾に「intl_tel2」「intl_tel3」のように数字を入力してください。

5アプリにプラグインをインストールする方法

※弊社が用意したテンプレートファイルから作成したアプリをご利用になる場合は、対応不要です。

  1. 右下にあるアプリセクションから、プラグインをインストールするアプリ名をクリックし開きます。

  2. [歯車マーク]をクリックします。

  3. [設定]タブをクリックし[プラグイン]をクリックします。

  4. [+追加する]をクリックします。

  5. インストールするプラグイン名の横にあるチェックボックスに[✓]を入れ、右下にある[追加]をクリックします。

  6. [アプリの設定に戻る]をクリックします。

  7. [アプリを更新]をクリックします。

  8. [アプリを更新]をクリックします。

6プラグインの設定~Zoom Phone外部連絡先同期プラグイン~

  1. 「Zoom Phone外部連絡先同期プラグイン」をインストールしたアプリを開きます。

  2. [歯車マーク]をクリックします。

  3. [設定]タブをクリックし[APIトークン]をクリックします。

  4. [生成する]をクリックし、『レコード閲覧』『レコード編集』に✓を入れて[保存]をクリックします。
    生成されたAPIトークンをコピーします。(プラグイン設定画面で利用します。)

  5. [アプリを更新]をクリックします。

  6. [アプリを更新]をクリックします。

  7. 一覧画面に戻ったら、再度[歯車マーク]をクリックします。

  8. [設定]タブをクリックし[プラグイン]をクリックします。

  9. 「Zoom Phone外部連絡先同期プラグイン」の[歯車マーク]をクリックし設定画面を開きます。

  10. 「kintoneAPIトークン」の設定で、先ほどコピーしたAPIトークンを貼り付け、[Zoomと連携する]をクリックします。

  11. Zoomのログイン画面が表示されるので、ログイン情報を入力し[サインイン]をクリックします。

  12. [Allow]をクリックします。

  13. 「Zoom Phone連携を登録しました。」のポップアップ画面が表示されるので[OK]をクリックします。

  14. 「プラン」の設定で、自社で契約しているZoom Phoneのプランを選択します。

  15. 「フィールド設定」で、Zoom外部連絡先の項目とkintoneのフィールドのマッピングをします。
    『外部連絡先ID』『同期ステータス』『最終同期リビジョン』『氏名』は必須項目です。

  16. 「電話番号フィールド設定」で、Zoom外部連絡先へ連携させる電話番号を選択します。複数ある場合は、+マークで追加することができます。

  17. [設定を保存する]をクリックします。

  18. [アプリの設定に戻る]をクリックします。

  19. [アプリを更新]をクリックします。

  20. [アプリを更新]をクリックします。

  21. 一覧画面に[電話マーク]が表示されていたら成功です。

7プラグインの設定~Zoom Phone 通話記録プラグイン~

  1. 「Zoom Phone通話記録」アプリをクリックし開きます。

  2. [歯車マーク]をクリックします。

  3. [設定]タブをクリックし[APIトークン]をクリックします。

  4. [生成する]をクリックし、『レコード閲覧』『レコード追加』『レコード編集』に✓を入れて[保存]をクリックします。
    生成されたAPIトークンをコピーします。(プラグイン設定画面で利用します。)

  5. [アプリを更新]をクリックします。

  6. [アプリを更新]をクリックします。

  7. 一覧画面に戻ったら、再度[歯車マーク]をクリックします。

  8. [設定]タブをクリックし[プラグイン]をクリックします。

  9. 「Zoom Phone 通話記録プラグイン」の[歯車マーク]をクリックし設定画面を開きます。

  10. 「kintoneAPIトークン」の設定で、先ほどコピーしたAPIトークンを貼り付け、[Zoomと連携する]をクリックします。

  11. 「機微データの取り扱いについて」の内容を確認し、「上記の内容を確認し、同意します」にチェックを入れて[同意して連携を開始する]をクリックします。

  12. 「Zoom Phone連携を登録しました。」のポップアップ画面が表示されるので[OK]をクリックします。

  13. 「プラン」の設定で、自社で契約しているZoom Phoneのプランを選択します。

  14. 「ファイルの添付設定」で、『録音ファイル』と『録音の文字起こしファイル』の添付有無をチェックを入れて指定します。

  15. 「文字起こしの要約設定」で、要約データを保存有無をチェックを入れて指定します。

  16. [設定を保存する]をクリックします。

  17. [アプリの設定に戻る]をクリックします。

  18. [アプリを更新]をクリックします。

  19. [アプリを更新]をクリックします。

本製品の削除手順

本製品の利用をやめるときは、「1. Zoom Marketplaceのアプリを削除する方法」と「2. kintoneのプラグインを削除する方法」の両方を行ってください。

削除による影響

  • Zoom Marketplaceのアプリを削除すると、Zoom側で本製品への認可が取り消されます。
  • 認可はZoomアカウント単位で、「Zoom Phone通話記録プラグイン」と「Zoom Phone外部連絡先同期プラグイン」が共有しています。そのため、削除すると両方のプラグインが動作を停止します。
    • Zoom Phone通話記録プラグイン:通話の終了後に通話記録のレコードが作成されなくなります。
    • Zoom Phone外部連絡先同期プラグイン:kintoneからZoom外部連絡先への同期(定期実行を含む)が行われなくなります。

1Zoom Marketplaceのアプリを削除する方法

Zoom Marketplaceでアカウントのアプリの一覧を開く
  1. ブラウザでZoom Marketplace(https://marketplace.zoom.us/)を開き、Zoomアカウントのオーナーまたは管理者のアカウントでサインインします。

  2. 画面右上の[管理]を押します。

  3. 左のメニューの「管理者向けアプリ管理」にある[アカウントのアプリ]を押します。

  4. 画面の下にある「すべてのアプリ」で、[追加したアプリ]タブを開きます。

「Zoom Phone kintone Integration」を削除する
  1. 一覧で[Zoom Phone kintone Integration]の名前を押します。

  2. アプリの画面の上部に並ぶタブから、右端の[アプリを管理]を押します。タブが表示されていない場合は、タブの右にある[>]を押します。

  3. 「Remove App」の欄にある[Remove]を押します。その上にある「Disable App」の欄の[Disable]は押しません。

  4. 確認の画面が表示されたら、削除を確定するボタンを押します。

2kintoneのプラグインを削除する方法

プラグイン設定画面の[Zoom連携の解除]は、そのアプリのプラグインとZoomとの連携だけを解除します。Zoom側の認可は残るため、本製品の利用をやめるときは、「1. Zoom Marketplaceのアプリを削除する方法」も行ってください。

下記手順を、「Zoom Phone通話記録プラグイン」「Zoom Phone外部連絡先同期プラグイン」をインストールしているそれぞれのアプリで対応してください。

  1. プラグインをインストールしているアプリを開きます。

  2. [歯車マーク]をクリックします。

  3. [設定]タブをクリックし[APIトークン]をクリックします。

  4. Zoom Phone連携用に発行したAPIトークンをコピーし、[キャンセル]をクリックします。

  5. [設定]タブをクリックし[プラグイン]をクリックします。

  6. 削除するプラグインの[歯車マーク]をクリックし設定画面を開きます。

  7. コピーしたAPIトークンを「kintone API トークン」に貼り付けし、[Zoom連携の解除]をクリックします。

  8. ポップアップメッセージを確認し、[解除する]をクリックします。

  9. ポップアップメッセージを確認し、[OK]をクリックします。

  10. [キャンセル]をクリックします。

  11. 削除するプラグインの[×マーク]をクリックし、[アプリの設定に戻る]をクリックします。

  12. [アプリを更新]をクリックします。

  13. [アプリを更新]をクリックします。

削除後のデータの扱い

自動で削除されるもの(お客様の操作は不要です)

  • 当社サーバーに保存している連携情報(OAuthトークン、連携設定):Zoomからの削除通知を受けて削除します。
  • 同期処理のログ:保持期間の経過後に自動で削除されます。

残るもの(不要な場合は、お客様が削除してください)

  • 通話記録アプリのレコード(通話記録、録音ファイル、文字起こし、要約):kintone上で削除してください。
  • 顧客管理アプリのレコードに本製品が書き込んだ値(外部連絡先ID、同期ステータスなど):kintone上で削除または編集してください。
  • Zoom外部連絡先に同期済みの連絡先:Zoom外部連絡先から削除してください。

詳しくは、プライバシーポリシーの「3. 情報の保存・保持」と「6. 連携の解除とデータの削除」をご確認ください。

利用マニュアル・操作方法

1Zoom Phone通話記録プラグイン

  1. Zoom Phoneで通話終了後、通話記録アプリ(Zoom Phone通話記録プラグインをインストールしたアプリ)を開きます。

  2. 通話記録を確認したいレコードの[詳細画面]ボタン(ノートマーク)を開きます。

  3. 通話内容の詳細を確認することができます。確認できる内容は以下のとおりです。

    • 通話種別
    • 発信結果
    • イベント名
    • 呼び出し開始時間
    • 応答開始時間
    • 通話終了時間
    • 受信者名
    • 受信者電話番号
    • 発信者名
    • 発信者電話番号
    • レコーディングリンク
    • 録音ファイル(任意)
    • 文字起こしファイル(任意)
    • 文字起こしテキスト
    • 要約
    • データ作成日時
    • データ更新日時

2Zoom Phone外部連絡先同期プラグイン

個別で登録する方法(kintoneの新規レコードで登録する場合)
  1. Zoom Phone外部連絡先同期プラグインをインストールしたkintoneアプリの一覧画面を開き、右上の[+マーク]をクリックします。

  2. データを入力します。氏名・電話番号は必須項目です。

  3. [保存]ボタンをクリックします。

  4. 「同期ステータス」が『success』になっていれば、同期は成功です。

個別で登録する方法(kintoneの既存レコードで登録する場合)
  1. Zoom Phone外部連絡先同期プラグインをインストールしたkintoneアプリの一覧画面を開き、連携したいレコードの[詳細画面]ボタン(ノートマーク)を開きます。

  2. 右上にある[編集]ボタン(ノートと鉛筆マーク)をクリックします。

  3. [保存]ボタンをクリックします。

  4. 「同期ステータス」が『success』になっていれば、同期は成功です。

一括で登録する方法
  1. Zoom Phone外部連絡先同期プラグインをインストールしたkintoneアプリの一覧画面を開きます。

  2. 一覧画面の上部にある[連携]ボタン(電話マーク)をクリックします。表示されているレコードが連携されます。

  3. 「一覧の絞り込み対象のレコードについて、Zoom Phoneの外部連絡先の一括同期を実行します。よろしいですか?」のメッセージが表示されるので、[実行する]ボタンをクリックします。

  4. 「Zoom Phoneの外部連絡先同期が完了しました。」のメッセージが表示されれば、同期は成功です。

補足
  • 外部連絡先同期の制約事項
    • 電話番号フィールドに、電話番号以外の情報(2つの電話番号、数字以外の文字、全角ハイフン等)が含まれているレコードは登録できません。
    • Zoom Phoneは電話番号の重複登録はできません。同一番号は先に登録された氏名で表示されます。
    • 一度連携したデータをkintone側で削除しても、Zoom外部連絡先からは削除されません。削除が必要な場合は、Zoom外部連絡先へアクセスして削除してください。
  • 外部連絡先の自動同期について
    • 深夜0時に未連携レコードを自動登録・更新します。
  • 着信時ポップアップ

ご不明な点はお気軽にお問い合わせください

お問い合わせ・デモのご相談