ドキュメントメニュー

Help Scout#

Help Scout アプリの認証情報を使う OAuth で Help Scout を接続します。このソースは titan.helpscout に 6 個の固定テーブルを書き込みます。

sql
select
  id,
  first_name,
  last_name
from titan.helpscout.customers
limit 10

Help Scoutを接続する#

  1. アプリを開き、アプリを接続を選択してから、Help Scoutを選択します。

  2. Help Scout アプリの認証情報を使って OAuth 認証を行います。

  3. テーブルを確認してからソースを保存します。

  4. 初回の実行が完了するまで同期履歴を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

同期の動作#

顧客、会話、メールボックス、ユーザー、タグ、ワークフローは、同じソースのスケジュールで同期します。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトのスケジュールでは、組織のタイムゾーンで平日の 5:00、10:00、15:00、20:00 と日曜日の 20:00 に同期し、各ソースはその時刻から 30 分以内に開始します。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _synced_at と _deleted もあります。以下の列リファレンスにはソースの列のみを記載しています。

テーブルリファレンス#

customers#

titan.helpscout.customers には 7 個のソース列があります。

helpscout.customers7列
idintegerpk

ソースのフィールド id。

first_namestring

ソースのフィールド firstName。

last_namestring

ソースのフィールド lastName。

emailstring

ソースのフィールド email。

companystring

ソースのフィールド company。

created_atdatetime

ソースのフィールド createdAt。

updated_atdatetime

ソースのフィールド updatedAt。

conversations#

titan.helpscout.conversations には 10 個のソース列があります。

helpscout.conversations10列
idintegerpk

ソースのフィールド id。

numberinteger

ソースのフィールド number。

subjectstring

ソースのフィールド subject。

statusstring

ソースのフィールド status。

typestring

ソースのフィールド type。

mailbox_idinteger

ソースのフィールド mailboxId。

created_atdatetime

ソースのフィールド createdAt。

updated_atdatetime

ソースのフィールド updatedAt。

closed_atdatetime

ソースのフィールド closedAt。

assigneejson

ソースのフィールド assignee。

mailboxes#

titan.helpscout.mailboxes には 5 個のソース列があります。

helpscout.mailboxes5列
idintegerpk

ソースのフィールド id。

namestring

ソースのフィールド name。

emailstring

ソースのフィールド email。

created_atdatetime

ソースのフィールド createdAt。

updated_atdatetime

ソースのフィールド updatedAt。

users#

titan.helpscout.users には 7 個のソース列があります。

helpscout.users7列
idintegerpk

ソースのフィールド id。

first_namestring

ソースのフィールド firstName。

last_namestring

ソースのフィールド lastName。

emailstring

ソースのフィールド email。

rolestring

ソースのフィールド role。

created_atdatetime

ソースのフィールド createdAt。

updated_atdatetime

ソースのフィールド updatedAt。

tags#

titan.helpscout.tags には 3 個のソース列があります。

helpscout.tags3列
idintegerpk

ソースのフィールド id。

namestring

ソースのフィールド name。

colorstring

ソースのフィールド color。

workflows#

titan.helpscout.workflows には 6 個のソース列があります。

helpscout.workflows6列
idintegerpk

ソースのフィールド id。

namestring

ソースのフィールド name。

typestring

ソースのフィールド type。

statusstring

ソースのフィールド status。

created_atdatetime

ソースのフィールド createdAt。

modified_atdatetime

ソースのフィールド modifiedAt。

削除と履歴#

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して _deleted を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには where not _deleted で絞り込んでください。