じぶん 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プラグインダウンロード方法
-
ご契約時に弊社からお送りしたマイページURLを開き、[Zoom連携プラグインDLページ]のボタンをクリックします。
-
[詳細]をクリックします。
-
以下の2ファイルのリンクをクリックして、任意のフォルダにダウンロードします。
- kintone-zoom-phone-sync-external-contacts-plugin-1.zip
- kintone-zoom-phone-call-log-plugin-1.zip
2kintoneにプラグインをインストールする方法
cybozu.comの共通ログインページにアクセスします。
-
サブドメイン名を入力して[ログイン画面へ]をクリックします。
-
ログイン名とパスワードを入力し[ログイン]をクリックします。
-
[kintone]をクリックします。
-
右上にある[歯車マーク]をクリックします。
-
[kintoneシステム管理]をクリックします。
-
その他セクション内にある[プラグイン]をクリックします。
-
[読み込む]をクリックします。
-
[参照]をクリックします。
-
「kintone-zoom-phone-sync-external-contacts-plugin-1.zip」を選択し[開く]をクリックします。
-
[読み込む]をクリックします。
-
再度、[読み込む]をクリックします。
-
[参照]をクリックします。
-
「kintone-zoom-phone-call-log-plugin-1.zip」を選択し[開く]をクリックします。
-
[読み込む]をクリックします。
-
左上の[家マーク]をクリックし、ポータル画面に戻ります。
3本プラグインをインストールするアプリを、テンプレートファイルから作成する方法
※「Zoom Phone 通話記録プラグイン」は、弊社が用意した『Zoom Phone通話記録』アプリのテンプレートファイルを必ずご利用ください。
-
ご契約時に弊社からお送りしたマイページURLを開き、[Zoom連携プラグインDLページ]のボタンをクリックします。
-
[詳細]をクリックします。
-
以下のファイルのリンクをクリックして、任意のフォルダにダウンロードします。
- Zoom Phone通話記録.zip
- 顧客管理アプリ.zip(※「Zoom Phone外部連絡先同期プラグイン」を、自社で作成されたアプリで利用する場合はダウンロード不要です。手順4にお進みください。)
-
kintoneの画面に戻り、ダウンロードしたテンプレートファイルからアプリを作成します。
外部リンク:テンプレートファイルからアプリを作成する方法
4「Zoom Phone外部連絡先同期プラグイン」をインストールするアプリに必要なフィールドを追加する方法
※弊社が用意したテンプレートファイルから作成したアプリをご利用になる場合は、対応不要です。
-
右下にあるアプリセクションから、「Zoom Phone外部連絡先同期プラグイン」をインストールするアプリ名をクリックし開きます。
-
[歯車マーク]をクリックします。
-
以下のフィールドを追加します。
外部リンク:フィールドの追加方法フィールド名 フィールドコード フィールドタイプ Zoom用電話番号 intl_tel 文字列(1行) 外部連絡先ID external_contact_id 文字列(1行) 最終同期リビジョン last_sync_revision 数値 同期ステータス sync_status 文字列(1行) ※連携する電話が複数ある場合は、「Zoom用電話番号」のフィールドコードの末尾に「intl_tel2」「intl_tel3」のように数字を入力してください。
5アプリにプラグインをインストールする方法
※弊社が用意したテンプレートファイルから作成したアプリをご利用になる場合は、対応不要です。
-
右下にあるアプリセクションから、プラグインをインストールするアプリ名をクリックし開きます。
-
[歯車マーク]をクリックします。
-
[設定]タブをクリックし[プラグイン]をクリックします。
-
[+追加する]をクリックします。
-
インストールするプラグイン名の横にあるチェックボックスに[✓]を入れ、右下にある[追加]をクリックします。
-
[アプリの設定に戻る]をクリックします。
-
[アプリを更新]をクリックします。
-
[アプリを更新]をクリックします。
6プラグインの設定~Zoom Phone外部連絡先同期プラグイン~
-
「Zoom Phone外部連絡先同期プラグイン」をインストールしたアプリを開きます。
-
[歯車マーク]をクリックします。
-
[設定]タブをクリックし[APIトークン]をクリックします。
-
[生成する]をクリックし、『レコード閲覧』『レコード編集』に✓を入れて[保存]をクリックします。
生成されたAPIトークンをコピーします。(プラグイン設定画面で利用します。) -
[アプリを更新]をクリックします。
-
[アプリを更新]をクリックします。
-
一覧画面に戻ったら、再度[歯車マーク]をクリックします。
-
[設定]タブをクリックし[プラグイン]をクリックします。
-
「Zoom Phone外部連絡先同期プラグイン」の[歯車マーク]をクリックし設定画面を開きます。
-
「kintoneAPIトークン」の設定で、先ほどコピーしたAPIトークンを貼り付け、[Zoomと連携する]をクリックします。
-
Zoomのログイン画面が表示されるので、ログイン情報を入力し[サインイン]をクリックします。
-
[Allow]をクリックします。
-
「Zoom Phone連携を登録しました。」のポップアップ画面が表示されるので[OK]をクリックします。
-
「プラン」の設定で、自社で契約しているZoom Phoneのプランを選択します。
-
「フィールド設定」で、Zoom外部連絡先の項目とkintoneのフィールドのマッピングをします。
『外部連絡先ID』『同期ステータス』『最終同期リビジョン』『氏名』は必須項目です。 -
「電話番号フィールド設定」で、Zoom外部連絡先へ連携させる電話番号を選択します。複数ある場合は、+マークで追加することができます。
-
[設定を保存する]をクリックします。
-
[アプリの設定に戻る]をクリックします。
-
[アプリを更新]をクリックします。
-
[アプリを更新]をクリックします。
-
一覧画面に[電話マーク]が表示されていたら成功です。
7プラグインの設定~Zoom Phone 通話記録プラグイン~
-
「Zoom Phone通話記録」アプリをクリックし開きます。
-
[歯車マーク]をクリックします。
-
[設定]タブをクリックし[APIトークン]をクリックします。
-
[生成する]をクリックし、『レコード閲覧』『レコード追加』『レコード編集』に✓を入れて[保存]をクリックします。
生成されたAPIトークンをコピーします。(プラグイン設定画面で利用します。) -
[アプリを更新]をクリックします。
-
[アプリを更新]をクリックします。
-
一覧画面に戻ったら、再度[歯車マーク]をクリックします。
-
[設定]タブをクリックし[プラグイン]をクリックします。
-
「Zoom Phone 通話記録プラグイン」の[歯車マーク]をクリックし設定画面を開きます。
-
「kintoneAPIトークン」の設定で、先ほどコピーしたAPIトークンを貼り付け、[Zoomと連携する]をクリックします。
-
「機微データの取り扱いについて」の内容を確認し、「上記の内容を確認し、同意します」にチェックを入れて[同意して連携を開始する]をクリックします。
-
「Zoom Phone連携を登録しました。」のポップアップ画面が表示されるので[OK]をクリックします。
-
「プラン」の設定で、自社で契約しているZoom Phoneのプランを選択します。
-
「ファイルの添付設定」で、『録音ファイル』と『録音の文字起こしファイル』の添付有無をチェックを入れて指定します。
-
「文字起こしの要約設定」で、要約データを保存有無をチェックを入れて指定します。
-
[設定を保存する]をクリックします。
-
[アプリの設定に戻る]をクリックします。
-
[アプリを更新]をクリックします。
-
[アプリを更新]をクリックします。
本製品の削除手順
本製品の利用をやめるときは、「1. Zoom Marketplaceのアプリを削除する方法」と「2. kintoneのプラグインを削除する方法」の両方を行ってください。
削除による影響
- Zoom Marketplaceのアプリを削除すると、Zoom側で本製品への認可が取り消されます。
- 認可はZoomアカウント単位で、「Zoom Phone通話記録プラグイン」と「Zoom Phone外部連絡先同期プラグイン」が共有しています。そのため、削除すると両方のプラグインが動作を停止します。
- Zoom Phone通話記録プラグイン:通話の終了後に通話記録のレコードが作成されなくなります。
- Zoom Phone外部連絡先同期プラグイン:kintoneからZoom外部連絡先への同期(定期実行を含む)が行われなくなります。
1Zoom Marketplaceのアプリを削除する方法
Zoom Marketplaceでアカウントのアプリの一覧を開く
-
ブラウザでZoom Marketplace(https://marketplace.zoom.us/)を開き、Zoomアカウントのオーナーまたは管理者のアカウントでサインインします。
-
画面右上の[管理]を押します。
-
左のメニューの「管理者向けアプリ管理」にある[アカウントのアプリ]を押します。
-
画面の下にある「すべてのアプリ」で、[追加したアプリ]タブを開きます。
「Zoom Phone kintone Integration」を削除する
-
一覧で[Zoom Phone kintone Integration]の名前を押します。
-
アプリの画面の上部に並ぶタブから、右端の[アプリを管理]を押します。タブが表示されていない場合は、タブの右にある[>]を押します。
-
「Remove App」の欄にある[Remove]を押します。その上にある「Disable App」の欄の[Disable]は押しません。
-
確認の画面が表示されたら、削除を確定するボタンを押します。
2kintoneのプラグインを削除する方法
プラグイン設定画面の[Zoom連携の解除]は、そのアプリのプラグインとZoomとの連携だけを解除します。Zoom側の認可は残るため、本製品の利用をやめるときは、「1. Zoom Marketplaceのアプリを削除する方法」も行ってください。
下記手順を、「Zoom Phone通話記録プラグイン」「Zoom Phone外部連絡先同期プラグイン」をインストールしているそれぞれのアプリで対応してください。
-
プラグインをインストールしているアプリを開きます。
-
[歯車マーク]をクリックします。
-
[設定]タブをクリックし[APIトークン]をクリックします。
-
Zoom Phone連携用に発行したAPIトークンをコピーし、[キャンセル]をクリックします。
-
[設定]タブをクリックし[プラグイン]をクリックします。
-
削除するプラグインの[歯車マーク]をクリックし設定画面を開きます。
-
コピーしたAPIトークンを「kintone API トークン」に貼り付けし、[Zoom連携の解除]をクリックします。
-
ポップアップメッセージを確認し、[解除する]をクリックします。
-
ポップアップメッセージを確認し、[OK]をクリックします。
-
[キャンセル]をクリックします。
-
削除するプラグインの[×マーク]をクリックし、[アプリの設定に戻る]をクリックします。
-
[アプリを更新]をクリックします。
-
[アプリを更新]をクリックします。
削除後のデータの扱い
自動で削除されるもの(お客様の操作は不要です)
- 当社サーバーに保存している連携情報(OAuthトークン、連携設定):Zoomからの削除通知を受けて削除します。
- 同期処理のログ:保持期間の経過後に自動で削除されます。
残るもの(不要な場合は、お客様が削除してください)
- 通話記録アプリのレコード(通話記録、録音ファイル、文字起こし、要約):kintone上で削除してください。
- 顧客管理アプリのレコードに本製品が書き込んだ値(外部連絡先ID、同期ステータスなど):kintone上で削除または編集してください。
- Zoom外部連絡先に同期済みの連絡先:Zoom外部連絡先から削除してください。
詳しくは、プライバシーポリシーの「3. 情報の保存・保持」と「6. 連携の解除とデータの削除」をご確認ください。
利用マニュアル・操作方法
1Zoom Phone通話記録プラグイン
-
Zoom Phoneで通話終了後、通話記録アプリ(Zoom Phone通話記録プラグインをインストールしたアプリ)を開きます。
-
通話記録を確認したいレコードの[詳細画面]ボタン(ノートマーク)を開きます。
-
通話内容の詳細を確認することができます。確認できる内容は以下のとおりです。
- 通話種別
- 発信結果
- イベント名
- 呼び出し開始時間
- 応答開始時間
- 通話終了時間
- 受信者名
- 受信者電話番号
- 発信者名
- 発信者電話番号
- レコーディングリンク
- 録音ファイル(任意)
- 文字起こしファイル(任意)
- 文字起こしテキスト
- 要約
- データ作成日時
- データ更新日時
2Zoom Phone外部連絡先同期プラグイン
個別で登録する方法(kintoneの新規レコードで登録する場合)
-
Zoom Phone外部連絡先同期プラグインをインストールしたkintoneアプリの一覧画面を開き、右上の[+マーク]をクリックします。
-
データを入力します。氏名・電話番号は必須項目です。
-
[保存]ボタンをクリックします。
-
「同期ステータス」が『success』になっていれば、同期は成功です。
個別で登録する方法(kintoneの既存レコードで登録する場合)
-
Zoom Phone外部連絡先同期プラグインをインストールしたkintoneアプリの一覧画面を開き、連携したいレコードの[詳細画面]ボタン(ノートマーク)を開きます。
-
右上にある[編集]ボタン(ノートと鉛筆マーク)をクリックします。
-
[保存]ボタンをクリックします。
-
「同期ステータス」が『success』になっていれば、同期は成功です。
一括で登録する方法
-
Zoom Phone外部連絡先同期プラグインをインストールしたkintoneアプリの一覧画面を開きます。
-
一覧画面の上部にある[連携]ボタン(電話マーク)をクリックします。表示されているレコードが連携されます。
-
「一覧の絞り込み対象のレコードについて、Zoom Phoneの外部連絡先の一括同期を実行します。よろしいですか?」のメッセージが表示されるので、[実行する]ボタンをクリックします。
-
「Zoom Phoneの外部連絡先同期が完了しました。」のメッセージが表示されれば、同期は成功です。
補足
-
外部連絡先同期の制約事項
- 電話番号フィールドに、電話番号以外の情報(2つの電話番号、数字以外の文字、全角ハイフン等)が含まれているレコードは登録できません。
- Zoom Phoneは電話番号の重複登録はできません。同一番号は先に登録された氏名で表示されます。
- 一度連携したデータをkintone側で削除しても、Zoom外部連絡先からは削除されません。削除が必要な場合は、Zoom外部連絡先へアクセスして削除してください。
-
外部連絡先の自動同期について
- 深夜0時に未連携レコードを自動登録・更新します。
-
着信時ポップアップ
- Zoom Phoneの「外部アプリまたは着信通話用URLを起動する」機能をご利用ください。
- 外部リンク:Zoom社ヘルプ

