ホットプロファイルオンラインヘルプ

キーワードを「”」で囲うことで完全一致検索ができます。
例："インポート"

人気のキーワード

個人情報保護法 オンライン名刺 インポート エクスポート メール配信 マイHOT通知

SFAキャンペーンページ
  • 最終更新日：

<kintone連携>プラグインの設定・利用手順

フォローする

本記事ではkintone連携のプラグイン（kintone案件管理アプリで
ホットプロファイルリードデータを取り込む）の設定・利用手順をご案内いたします。

※kintone連携でできることについてはこちらをご確認ください。
※サンプルスクリプト（kintone顧客リストアプリでホットプロファイルリードデータを取り込む）の
　設定・利用手順につきましてはこちらをご確認ください。

概要

プラグイン動作概要

kintoneアプリにプラグインを追加することで、ホットプロファイルのリード情報を
kintoneで参照してデータを活用できます。
アプリの指定したフィールドの値をキーワードに検索を行い、
検索条件に一致したデータがルックアップにより表示されます。
※公開APIオプションのお申込みがない場合、ご利用いただけません。

 

プラグイン制限事項・注意事項

  • 本プラグインはGoogleChrome バージョン 66.0.3359.139 Official Build (64-bit)で動作確認をしております。
  • スマートフォンでは、使用することができません。
    ※kintoneプラグインはjavaスクリプトで書かれています。javaスクリプトの挙動はブラウザに
    　依存する部分が極めて高く、動作確認を上記chromeで行っておりますことをご了承ください。
  • ホットプロファイルの顧客情報を削除した場合も、Kintoneアプリ側に登録されたデータは
    自動的に削除されません。
  • ホットプロファイルにてデータ化中の名刺は取得対象に含まれません。
    （リードとして登録されているデータが対象です）
  • 取得できるデータはAPIキーを発行したユーザーのアクセス権限設定の影響を受けます。
  • ホットプロファイル 公開APIの仕様により、リクエスト数が1000回 / 5分を超えるとエラーとなります。
    ※エラーが表示された場合、5分以上時間をあけてから再度取得を行ってください。
  • kintoneアプリ側の登録済みレコードの量が大量になりますと動作が緩慢になる場合があります。
  • 本プラグインでは、一部の処理にDOM操作を含んでいるためkintoneアップデートの
    影響をうける可能性がある実装となっておりますので、参考にする際にはご注意ください。
  • 本プラグインを利用するにあたりオープンAPIの利用申し込みが必要となります。

 

プラグイン設定・利用方法

1. 事前準備

以下ご準備ください。

環境・システム 提供元 備考
ホットプロファイル 株式会社ハンモック ・リードが登録してある状態にしてください
・リードを取得したいユーザーのAPI連携を有効にしてください
※API連携有効化手順はこちらをご確認ください
プラグイン
案件管理用-ファイル一式		 株式会社ハンモック ハンモックより提供します
※ファイルをご要望の場合、サポートデスクまでお問い合わせください
kintone　および案件管理アプリ サイボウズ株式会社 サイボウズ社より入手・作成してください

 ※kintoneヘルプサイトもご一読お願いいたします。

 

2. プラグイン登録

[ kintoneシステム管理 ] - [ プラグイン ]　より、プラグイン
（弊社提供の「案件管理用-ファイル一式」内「contents.plugin.zip」）を登録します。
読み込みが完了すると、[ 読み込んだプラグイン ] の一覧に [ HotProfile for kintone ]が表示されます。
154_022.png
yajirushi.png

154_021.png
yajirushi.png
154_023.png

 

3. kintone 案件管理アプリ フォーム設定

新規で案件管理アプリを作成します。
154_020.png

kintone 案件管理アプリのフォームを設定します。

154_032.png
yajirushi.png

次のフィールドを作成・変更し、配置します。
※フォームの設定方法については、kintoneユーザーヘルプを確認ください。
154_033.png

フィールド名 フィールドコード データ型 作成・変更内容
会社名 文字列__1行_ 文字列
（1行）		 フィールドコードを確認し、異なる場合は変更してください
    スペース 新規作成してください。要素IDの欄に[search]と入力してください
部署名 文字列__1行_0 文字列
（1行）		 フィールドコードを確認し、異なる場合は変更してください
役職 title 文字列
（1行）		 新規作成してください
先方担当者 文字列__1行_1 文字列
（1行）		 フィールドコードを確認し、異なる場合は変更してください
郵便番号 Zipcode 文字列
（1行）		 新規作成してください
TEL TEL 文字列
（1行）		 フィールドコードを変更してください
FAX FAX 文字列
（1行）		 フィールドコードを変更してください
メールアドレス Mail 文字列
（1行）		 フィールドコードを変更してください
都道府県 pref 文字列
（1行）		 新規作成してください
住所 Address 文字列
（1行）		 新規作成してください
営業担当者 owner_user_name 文字列
（1行）		 新規作成してください
名刺所有者 user_names 文字列
（1行）		 新規作成してください
リードソース lead_source_kbn_name 文字列
（1行）		 新規作成してください
リードソース(詳細) lead_source 文字列
（1行）		 新規作成してください
備考 文字列__複数行_ 文字列
（複数行）		 新規作成してください
リードID id 文字列
（1行）		 新規作成してください
リードステータス lead_status_name 文字列
（1行）		 新規作成してください

 

■フィールド配置例

各フィールドの配置の変更、不要なフィールドの未作成は、いずれも問題ありません。
各フィールドを変更、作成できましたら [ フォームを保存 ] してください。

154_024.png

 

4. kintoneアプリにプラグインを設定

[ 設定 ] タブより [ プラグイン ] を開き、登録した [ HotProfile for kintone ] を追加します。
154_026.png
yajirushi.png
154_025.png
yajirushi.png
154_027.png

再度、[ プラグイン ] 追加後に詳細な設定を行い、[ 保存 ] します。
154_027.png
yajirushi.png
154_028.png

 

項目名 入力文字列 説明
URL https://hammock.hotprofile.biz HotProfileのWEBアプリURLを記載します
利用中のドメインが異なる場合は書き換えてください
※[ HotProfileご利用証書 ] をご確認ください
APIキー ユーザー毎のAPIキー リードを取得したいユーザーのAPIキーを記載します※確認手順はこちらをご覧ください
検索ボタン配置スペース search [search]を選択してください
検索キーフィールド 会社名 [会社名] を選択してください
※[ 会社名 ] の他に、[ 部署名 ] [ 先方担当者 ] [ TEL ] [ FAX ] [ メールアドレス] [役職] [ 郵便番号 ] を選択することができます
HotProfile検索キー 会社名 [会社名]を選択してください
※[ 会社名 ] の他に、[ 氏名 ] [ メールアドレス ] を選択することができます


設定できましたら [ アプリの設定 ] より [ アプリの更新 ] をします。
154_029.png

 

5. 利用（リード情報を取得する）

[ 取得 ] とハイパーリンクになっている箇所をクリックすることでホットプロファイルに
登録済みのリード情報の一覧より選択できるようになります。
あらかじめ会社名に文字列を入力すると、その検索結果が表示されます。

※ホットプロファイルのリード管理にリード情報が1件も登録されていない場合は、
　[ 該当するデータがありません。 ] と表示されます。

154_030.png
yajirushi.png
154_031.png

 

プラグイン動作詳細

154_015.png

 

フィールド一覧

kintoneアプリの各フィールドに登録・更新を行う際のデータの対照表です。
別途管理者様にてkintone上でホットプロファイルの情報を参照させる場合、
以下の対照表をもとにフィールドの設定をお願いします。

kintoneアプリ
フィールド名 		kintoneアプリ
フィールドコード 		kintone
アプリ
データ型 		HotProfile
項目名 		備考
会社名 文字列__1行_ 文字列
（1行）		 会社名  
部署名 文字列__1行_0< 文字列
（1行）		 部署

部署
すべての組織名を返します
役職 title 文字列
（1行）		 役職  
担当者名 文字列__1行_1 文字列
（1行）		 氏名  
郵便番号(数字のみ) Zipcode 文字列
（1行）		 郵便番号  
TEL(数字のみ) TEL 文字列
（1行）		 電話番号  
FAX(数字のみ) FAX 文字列
（1行）		 FAX  
都道府県 pref 文字列
（1行）		 都道府県  
住所 Address 文字列
（1行）		 住所  
メールアドレス Mail 文字列
（1行）		 メールアドレス  
営業担当者 owner_user_name 文字列
（1行）		 営業担当者  
名刺所有者 user_names 文字列
（1行）		 名刺所有者 すべての名刺所有者名を[,](カンマ)区切りで並べます
リードソース lead_source_kbn_name 文字列
（1行）		 リードソース  
リードソース(詳細) lead_source 文字列
（1行）		 リードソース(詳細)  
備考 文字列__複数行_ 文字列
（複数行）		 メモ  
リードID id 文字列
（1行）		 - リードデータの持つ一意キー
リードステータス lead_status_name 文字列
（1行）		 リードステータス  

関連記事