LiveAgentからデータをエクスポートする方法
エージェントパネルの一部のセクションで利用可能なCSVエクスポートオプションに加えて、LiveAgentからデータをエクスポートするには2つの方法があります。
- APIを使用してチケットをエクスポートする
- DBダンプを作成する
APIを使用してチケットをエクスポートする
APIを使用して自分でデータをエクスポートできます。例えば、以下のAPI v3の呼び出しでは、1ページあたり10件のチケットを取得でき、エクスポートしたいチケットを絞り込むために作成日時の範囲を指定することができます。特定の日付のページで結果が10件未満になったら、次の日に進むことができます。
https://youraccount.ladesk.com/api/v3/tickets?_perPage=10&_page=1&_filters=[["date_created","D>","2017-06-11 00:00:00"],["date_created","D<","2017-06-11 23:59:59"]]&_sortField=date_created
API v1の完全なリファレンスはこちら、API v3のリファレンスはこちらでご確認いただけます。
DBダンプを作成する
データベースダンプは、LiveAgentサービスを解約する有料のお客様のみにご提供しています。
すべてのデータは複数の場所に保存されており、主にSQLデータベースおよびAWS S3ストレージに保管されています。DBダンプを作成することは可能ですが、AWS S3のデータはファイルとフォルダの構造としてのみ共有できます。フォルダ構造およびファイルの内容については、以下の記事の末尾で説明しています → Amazon S3 File Archive plugin
APIを使用してすべてのチケットをエクスポートするよりもDBダンプをご希望の場合は、ファイルをアップロードできる安全なストレージへのアクセス権をご提供いただく必要があります。例えば、弊社の秘密鍵で認証されたSSH / SCPアクセスなどです(弊社の管理者が転送専用に生成した公開鍵をご提供します)。この場合、接続先ホストを検証するためのホスト公開鍵も必要となります。
また、Google DriveのダウンロードリンクからDBダンプを共有することも可能です。その場合、ファイルへのアクセス権を付与するGoogleアカウントが必要です。この方法ではパスワードのやり取りは不要です。
ダンプにはデータベースの生データが含まれていることにご注意ください。そのため、APIの利用をお勧めします。すべてのアカウントに適用されるAPIレート制限についてはこちらでご確認いただけます。
パスワードをメールで送信しないでください。代わりに、https://liveagent.comのライブチャットをご利用いただき、チケットXXX-XXX-XXX(お客様のチケットID)に関連する件であることをお伝えください。
エージェントパネルのさまざまな箇所でのCSVエクスポートオプション、またはAPIを通じたデータエクスポートに加えて、管理チームにデータベースダンプをリクエストするオプションもあります。
データベースダンプのリクエスト
データベースダンプをリクエストするには、LiveAgentアカウントのオーナーのメールアドレスを使用して、お問い合わせフォームよりお問い合わせください。取得するデータによって手順が異なるため、リクエストの際にはどのようなデータが必要かを具体的にお伝えください。
すべてのデータはデータベースに7日間保存され、その後AWS S3ストレージに移行されます。DBダンプを作成することは可能ですが、AWS S3のデータはファイルとフォルダの構造としてのみ共有できます。フォルダ構造およびファイルの内容については、こちらの記事の末尾で説明しています。
また、Google DriveのダウンロードリンクからDBダンプを共有することも可能です。その場合、ファイルへのアクセス権を付与するGoogleアカウントが必要です。この方法ではパスワードのやり取りは不要です。
ダンプにはデータベースの生データが含まれていることにご注意ください。そのため、APIの利用をお勧めします。すべてのアカウントに適用されるAPIレート制限についてはこちらでご確認いただけます。
パスワードをメールで送信しないでください。代わりに、https://liveagent.comのライブチャットをご利用いただき、チケットXXX-XXX-XXX(お客様のチケットID)に関連する件であることをお伝えください。