kintone と連携する

kintone(キントーン) とコールコネクトの連携方法をご案内します。

kintoneアプリのうち、顧客情報を保存したkintoneアプリとコールコネクトの顧客を同期します。

kintone提供のデフォルトの顧客情報アプリだけでなく、ご自身でカスタマイズされたアプリでも電話番号のフィールドさえあれば同期が可能です。

また、オプションで通話履歴をkintoneアプリのレコードに書き出すこともできます。

テンプレートからアプリを利用する

コールコネクトの項目と完全に一致する標準アプリのテンプレートをご用意しました。

kintoneシステム管理 > [アプリテンプレート]をクリックし、ページ上部の [読み込む]をクリックして以下のZipファイルをアップロードします。

CallConnect テンプレート

kintoneのアプリ追加の画面で[登録済みのテンプレートから作成]をお選びいただき、生成した「顧客管理」「通話履歴」の2つのアプリを選択することで、新規でアプリが構築されます。

このアプリをベースに以下の連携方法を実行することで、連携を完了できます。

連携方法

1. コールコネクトの[管理]>[連携]から、kintoneを選択します。

2. 連携に必要な情報を入力します。

以下は「顧客リスト」のアプリを例に、各入力項目に関して解説します。

① ドメイン: ご利用されているkintoneのドメインを入力します。

② アプリID: 顧客情報を保存しているアプリを開くと、URLは https://{ドメイン}.cybozu.com/k/14/ のようになります。この時の14がアプリIDです。 

③ APIトークン:アプリのページ右上の歯車のボタンをクリックし、[アプリの設定を変更]をクリックします。

アプリの設定画面で、[APIトークン]をクリックします。

APIトークンを生成します。

この時、アクセス権は レコード閲覧、レコード追加、レコード編集 にチェックをいれてください。

その後、保存を忘れずにクリックしましょう。

④ 各フィールドコード: 電話番号や名前に対応するフィールドコードを入力します。[アプリの設定] >[フォーム]のタブのページへ移動します。電話番号などの各項目にオンマウスすると、設定アイコンが表示され、設定内でフィールドコードを確認できます。フィールドコードの詳細に関しては kintoneのヘルプ をご参照ください。
※フィールドの設定で、 コールコネクト連携と関係しない項目に必須項目のチェックが入っていると、kintone側でデータの作成や更新ができません。この場合、必須項目のチェックを外すか、別アプリでの連携をご検討ください。

※kintoneアプリでテーブル化されたフィールドコードは指定できません。

kintone設定完了後、アプリを更新 ボタンを必ず押してください。このボタンを押さないと反映されません。(下図の右上部分です。)

⑤ 顧客作成: チェックを入れると、kintone未登録の顧客と通話する度にkintoneのアプリに顧客データが新規登録されるようになります。コールコネクト側で何も登録がないと電話番号のみがkintoneに登録されるようになります。

⑥ セキュリティ: kintoneのIPアドレス制限 が有効になっている場合、コールコネクトがBasic認証を通じてkintoneにアクセスするようにします。kintone側のBasic認証設定や確認方法については、kintoneのヘルプをご参照ください。

⑦ 通話履歴の作成: チェックを入れると、通話履歴の内容をkintoneの対象アプリに書き出す設定項目が現れます。顧客リストのアプリで設定したのと同様の方法で、対応するアプリID、APIトークン(要"レコード追加"のアクセス権)、フィールドコードを入力してください。

* 顧客に紐づいた通話履歴を表示したい場合、kintoneアプリ設定のフォームにて、関連レコードを追加します。顧客リストにも通話履歴にも電話番号を入れる項目がございます。お互いの"電話番号(文字列)"が一致することをレコードの条件としてセットしてください。対応する顧客に紐づく通話履歴をリスト表示できるようになります。

* 録音URLは、kintone側の "リンク" ではなく、"文字列(1行)" として設定してください。保留をした通話をkintoneに書き出すと、複数の録音URLをkintoneに渡します。これがkintone側でリンクの場合に不正なURLとなってしまって保存されません。

設定の詳細は、本記事の冒頭で掲示した CallConnectテンプレートのアプリを入れていただき、その設定をご参照ください。

⑧ 通知イベント: どのタイミングで通知を送るかを指定します。詳細は 通知イベントの詳細について をご参照ください。

3. [連携ボタン]をクリックし、連携を完了させます。

仕様

* 必須項目以外で、該当するフィールドコードがない場合は空欄にして保存します。
* kintoneで電話番号が登録された顧客情報のみをコールコネクトの顧客として作成または更新します。
* 連携している間は1時間に1回、自動でkintoneの更新情報をコールコネクトに読み込みます。 
* 初回連携時に、直近60日で更新のあった最大3,000件の顧客を一括で取り込みます。
* kintone側で2段階認証を有効にすると、連携ができません。(kintone側の仕様)

クリックコール

専用のChrome拡張機能をインストールしてkintone内にある電話番号をクリックすると、コールコネクトの電話番号で発信できます。詳細は、Chrome拡張機能による電話発信についてをご参照ください。