見え TEL 君 SmallOffice
連動インターフェース資料
見え TEL 君の連動機能概要
見え TEL 君は外部システムの CTI エンジンとして動作するための連動機能が標準搭載されています。
この機能をご利用いただくことにより業務システムに簡単に CTI 機能を付加することが可能になります。

見え TEL 君の外部連動機能は「データベース連動」機能と「プログラム連動」機能の二つから構成されます。

データベース連動
電話の着信時、見え TEL 君の画面に相手情報が表示されます。
また、着信ログとして相手の情報が記録されます。

この際に電話番号を元に検索する顧客情報のデータベースとして外部のデータベースを指定することが可能になっています。

接続可能なデータベース
ODBC に対応したさまざまなデータベースと連動が可能です。
以下のようなデータベースと連動した実績があります。

連動仕様
検索対象として１つのテーブルまたはビューが指定可能です。
テーブルまたはビューには電話番号を格納したフィールドが必要です。
電話番号フィールドのデータは「市外局番あり・ハイフン、括弧等のない数字のみの電話番号」である必要があります。（例：0335531409）
複数の電話番号フィールドを指定可能です。
表示・記録項目として、相手名称と 10 個の任意のフィールドを指定可能です。
設定で指定されたフィールドが見え TEL 君の着信画面およびログに記録されます。

電話番号重複時の動作
ある会社の複数の社員や、家族など、顧客情報として同一の電話番号の顧客が複数登録されている場合があります。
このような場合、着信時には「データベースから検索された１件目の情報」が表示・記録されます。
特に並び替え指定せずに検索が行われますので、多くの場合「最初に登録された」顧客の情報が表示されます。（データベースにより異なる可能性があります）
たとえば「最後に登録された顧客を表示したい」というような場合、別途 Orderを指定した View を作成し、それを検索対象として設定してください。

プログラム連動
見え TEL 君から外部のシステム・アプリケーションに着信情報を引き渡す機能を持っています。
見え TEL 君から渡された着信情報を取得することで、既存のシステム側で相手情報の表示などを行うことが可能になります。

連動のタイミング（トリガー）
見え TEL 君の着信画面にある「連動ボタン」がクリックされたタイミングでプログラム連動機能が動作します。
着信ログ画面からプログラム連動機能を動作することも可能です。
電話が終わった後に連動したいような場合はこちらを利用します。

各連動方法で引渡し可能な CTI 情報一覧
見えＴＥＬ君から外部システムに引き渡すことができる情報は次の通りです
ヘッダ

タグ書式

相手番号
代表番号登録されている場合、代表番号

SNO
%TEL%
RSN

CLD

内容

%CLD%

非通知理由.
P=発信者非通知、C=公衆電話、O=提供地域外、
S=サービス競合
相手番号
代表番号登録されている場合、子番号
電話帳使用有無
DCD データが空の場合、DB 登録データまたは電話帳未収録

DCD

%DCD%

データ
0=電話帳/個人情報、1=電話帳/会社情報、2=未収録/住所
情報取得

NAM

%NAME%

相手名称DT0%FLD01%

候補項目 1 / 電話帳使用時 相手郵便番号

DT1%FLD02%

候補項目 2 / 電話帳使用時 相手住所DT2%FLD03%

候補項目 3

DT3%FLD04%

候補項目 4

DT4%FLD05%

候補項目 5

DT5%FLD06%

候補項目 6

DT6%FLD07%

候補項目 7DT7%FLD08%

候補項目 8

DT8%FLD09%

候補項目 9

DT9%FLD10%

候補項目 10/ 電話帳使用時 相手名称

ヘッダ

タグ書式

内容

CDT

%CDT%

着信日(YYYYMMDD)

CTM

%CTM%

着信時刻(HHMMSS)

LNO

%LNO%

実回線番号

DNO

%LINE%

表示回線番号

UID%UID%

使用者 ID

USR

%USR%

使用者名

UT0%UT0%

使用者オプション項目 1

UT1%UT1%

使用者オプション項目 2

UML

%UML%

使用者メールアドレス

CNT

%CNT%

検索結果件数※DCD 項目が 0、1 または 2 の場合、電話帳情報となります。この場合、NAM、DT0、DT1 の扱いが通常と変更されますので、アプリケーション側で注意が必要です。また、ログ画面から連動した場合、DCD 項目が 0、1 または 2 でも DT0、DT1 は記載されません。

プログラム起動
CTI 連動時、指定された実行ファイル(exe)を起動します。
この際、コマンドライン引数として電話番号などの情報を引き渡します。
複数の情報を引き渡すことが可能です。
連動するシステム側ではコマンドライン引数から電話番号などの情報を取得し、顧客情報を表示するような仕組みを組み込む必要があります。
連動の都度 指定された実行ファイルが起動されますので、多重起動の制御が必要になるケースがあります。
常に起動しているシステムと連動する場合は後述の「インターフェースファイル連動」をお勧めします。

連動イメージ
コマンドプロンプトからコマンドライン引数をつけて実行ファイルを起動した場合と同様の動作になります。
実行ファイルとして Notepad.exe、コマンドライン引数として電話番号を指定した場合、コマンドプロンプトでの下記コマンドと同様の動作となります。

C:¥Windows> C:¥Windows¥Notepad.exe 0335531409

インターフェースファイル作成
CTI 連動時、指定されたパスにテキストファイルを作成します。
この際、内容として電話番号などの CTI 情報を書き出します。
テキストファイルは毎回 新規作成または上書きされます。
連動するシステム側からこのファイルを読み込むことで電話番号などの情報を取得し、顧客情報の検索・表示などを行います。
タイマー処理(1 秒間隔など)によりテキストファイルの更新を監視し、ファイル更新時に自動的に情報を取得することをお勧めします。
インターフェースファイルの内容
CTI 情報として取得できるすべての情報が書き出されます。
1 行 1 項目・先頭３文字が項目の種類をあらわします。（引渡し可能な CTI 情報一覧をご参照ください）
１行目は必ず電話番号情報(SNO)または非通知理由(RSN)が記録されます。
2 行目以降は取得可能な情報やデータベースとの連動状態により順序等が異なる場合があります。

ファイルイメージ
SNO0335531409
NAM サクシード株式会社
DT0 成功太郎
DT1 東京都中央区新川 1－３－１０

イントラネット連動
Web ブラウザを使用したシステムとの連動を行います。
CTI 連動時、指定された URL に電話番号などの情報を組み込みブラウザでそのURL を開きます。
Web ブラウザはシステム既定のブラウザが使用されます。

連動イメージ
設定値：
https://www.google.co.jp/search?q=%tel%
0335531409 からの着信時に開かれる URL：
https://www.google.co.jp/search?q=0335531409

クリップボード連動
CTI 連動時、クリップボードに電話番号などの CTI 情報をコピーします。
連動するシステム側がカスタマイズできないような場合に利用します。
クリップボードから電話番号などをシステム側の検索欄などに貼り付けて利用します。