LiveAgentを使用する際、パネルに表示される日時はユーザーのPCのタイムゾーンに基づいて自動的に再計算されます。ただし、API v3はLiveAgentアカウントのタイムゾーンに基づいてデータを返します。 これにより、たとえばパネルでチケットを検索した場合と、APIでチケットリストを取得した場合とで、日時に不一致が生じることがあります。希望するタイムゾーンに日時を合わせるには、APIコールにTimezone-Offsetヘッダーを追加する必要があります。これにより、取得したレコードの日時が調整されます。

2019年前半頃以前に作成されたアカウントは、タイムゾーンがAmerica/Phoenix（UTC -7）に設定されていることが多いです。それ以降に作成されたアカウントのタイムゾーンはUTCに設定されています。

アカウントのタイムゾーンを確認するには、API v3の GET /settings を使用してください。

API v3のフィルターはUTCの日時で動作します。たとえば、アカウントがAmerica/Phoenixタイムゾーンにある場合、2026年1月1日 00:00:00以降に作成されたチケットのリストを取得するフィルターを使用すると、7時間の差により実際には2025年12月31日 17:00:00以降に作成されたチケットが返されます。

日時を調整するには、APIコールにTimezone-Offsetヘッダーを追加し、希望するシフト量を秒単位で値として設定します。このヘッダーを適用するだけで、日時はUTCタイムゾーンにシフトされます。さらに日時を調整するには、UTCとローカルタイムゾーンの差分のみをヘッダーの値として設定してください。 例：

  • アカウントのタイムゾーンがAmerica/Phoenixで、ローカルタイムゾーンがUTCの場合、API結果の日時をUTCにシフトするには、Timezone-Offsetの値を0に設定します。
  • アカウントのタイムゾーンがAmerica/Phoenixで、ローカルタイムゾーンがUTC +1（例：CET）の場合、API結果の日時をローカルタイムゾーンにシフトするには、Timezone-Offsetの値を3600に設定します。
  • アカウントのタイムゾーンがUTCで、ローカルタイムゾーンも同じくUTCの場合、Timezone-Offsetヘッダーを使用する必要はありません。
  • アカウントのタイムゾーンがUTCで、ローカルタイムゾーンがUTC +2（例：CEST）の場合、API結果の日時をローカルタイムゾーンにシフトするには、Timezone-Offsetの値を7200に設定します。

以下のスクリーンショット例では、APIフィルター _filters=[["date_created","D>","2026-01-19 15:00:00"]] を適用して2026年1月19日 15:00:00以降に作成されたチケットのリストを取得した場合、08:29:48に作成されたチケットも取得されることに注目してください。これはアカウントのタイムゾーンがAmerica/Phoenixであるためです。フィルターはUTC時間を適用しますが、チケットの作成日はUTC -7でデータベースに保存されています。チケットの作成日をUTC -7からUTCに再計算すると15:29:48となり、フィルターの条件を満たすため、そのチケットがAPIコールで取得されます。

取得結果のチケットの日時をUTCにシフトしてフィルターの検索動作と一致させるには、APIコールにTimezone-Offset=0ヘッダーを追加します。

PCやローカルのタイムゾーンがUTCと異なり、API結果をパネルの表示時間と一致させたい場合は、ヘッダーの値を必要に応じて調整してください。フィルターは引き続きUTCで動作することをご注意ください。