Node.js からTalkdesk のデータをSQL Server データベースとしてクエリ

CData Connect AI を使用すると、SQL Server インターフェース経由でTalkdesk のデータをクエリできます。以下のステップに従って、Connect AI にTalkdesk の仮想データベースを作成し、Node.js を使用してクエリを実行します。

CData Connect AI は、Talkdesk のピュアMySQL かつクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなくNode.js からの手軽なリアルタイムTalkdesk のデータクエリを実現します。Node.js でデータをクエリすると、CData Connect AI はサポートされているすべてのSQL 操作（フィルタ、JOIN など）を直接Talkdesk にプッシュし、サーバー側の処理を活用してTalkdesk のデータを高速で返します。

Connect AI からTalkdesk に接続する

1. Connect AI にログインし、 Add Connection をクリックします。
2. Add Connection パネルから「Talkdesk」を選択します。
3. 必要な認証情報を入力し、Talkdesk に接続します。

   Talkdesk では OAuth 2.0 の Client Credentials グラントを使用します。ブラウザでの認可ステップやコールバック URL は必要ありません。

   以下の接続プロパティを設定します。

   • AccountName：Talkdesk アカウントの名前。
   • Region：Talkdesk インスタンスがデプロイされているリージョン。指定できる値は US（デフォルト）、EU、CA、AU、UK、FedRamp です。
   • OAuthClientId：カスタム OAuth アプリケーションの登録時に割り当てられた Client Id。
   • OAuthClientSecret：カスタム OAuth アプリケーションに割り当てられた Client Secret。

   カスタム OAuth アプリケーションの作成

   1. Talkdesk アカウントにログインし、ナビゲーションメニューから OAuth Clients を選択します。
   2. Create OAuth Client をクリックし、クライアントにわかりやすい名前を付けます。
   3. Grant Type を Client Credentials に設定します。
   4. Add scopes をクリックし、アクセスしたいデータに応じたスコープを選択します。
   5. Create をクリックし、Client Id と Client Secret をコピーします。

   接続時、ドライバーは Talkdesk にアクセストークンを自動でリクエストしてキャッシュし、有効期限が切れると更新します。アプリケーションで選択したスコープが、クエリ予定のビューに対応していることを確認してください。対応していない場合、トークンのリクエストが失敗することがあります。

   
4. Create & Test をクリックします。
5. Edit Talkdesk Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。

パーソナルアクセストークンを追加する

OAuth 認証をサポートしないサービス、アプリケーション、プラットフォーム、フレームワークから接続する場合、パーソナルアクセストークン（PAT）を認証に使用できます。きめ細かくアクセスを管理するために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
2. PAT の名前を入力して Create をクリックします。
3. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

接続が設定されたら、Node.js からTalkdesk のデータに接続できるようになります。

Node.js からTalkdesk をクエリ

以下の例は、SQL Server モジュールを使用してTalkdesk へのクエリを実行する方法を説明しています。以下の情報が必要です。

• server：tds.cdata.com
• port：14333
• user：Connect AI ユーザー（例：[email protected]）
• password：上記のユーザーのPAT
• database：Talkdesk 用に構成した接続（Talkdesk1）

以下のコードで、Talkdesk に接続してクエリが実行できます。

var sql = require('mssql')
var config = {
	server: 'tds.cdata.com',
	port:14333,
	user: '[email protected]', //update me
	password:'CONNECT_USER_PAT', //update me
	options: {
		encrypt: true,
		database: 'Talkdesk1'
	}
}

sql.connect(config, err => {
    if(err){
        throw err ;
    }
    new sql.Request().query('SELECT * FROM Users', (err, result) => {
        console.dir(result)
    })

});

sql.on('error', err => {
    console.log("SQL Error: " ,err);
})