ドキュメントメニュー

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. 初回の実行が完了するまで同期履歴を確認します。

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

同期の動作#

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

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルにはシステム列 _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 で絞り込んでください。