---
title: Help Scout
description: Help Scoutを接続して同期の動作を把握し、書き込まれるすべてのテーブルと列をクエリします。
species: reference
---
# 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 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルには[システム列](/docs/concepts/your-lake#システム列) `_synced_at` と `_deleted` もあります。以下の列リファレンスにはソースの列のみを記載しています。

## テーブルリファレンス

### `customers`

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

```columns table=helpscout.customers
id                                      integer pk          ソースのフィールド `id`。
first_name                              string              ソースのフィールド `firstName`。
last_name                               string              ソースのフィールド `lastName`。
email                                   string              ソースのフィールド `email`。
company                                 string              ソースのフィールド `company`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `conversations`

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

```columns table=helpscout.conversations
id                                      integer pk          ソースのフィールド `id`。
number                                  integer             ソースのフィールド `number`。
subject                                 string              ソースのフィールド `subject`。
status                                  string              ソースのフィールド `status`。
type                                    string              ソースのフィールド `type`。
mailbox_id                              integer             ソースのフィールド `mailboxId`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
closed_at                               datetime            ソースのフィールド `closedAt`。
assignee                                json                ソースのフィールド `assignee`。
```

### `mailboxes`

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

```columns table=helpscout.mailboxes
id                                      integer pk          ソースのフィールド `id`。
name                                    string              ソースのフィールド `name`。
email                                   string              ソースのフィールド `email`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `users`

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

```columns table=helpscout.users
id                                      integer pk          ソースのフィールド `id`。
first_name                              string              ソースのフィールド `firstName`。
last_name                               string              ソースのフィールド `lastName`。
email                                   string              ソースのフィールド `email`。
role                                    string              ソースのフィールド `role`。
created_at                              datetime            ソースのフィールド `createdAt`。
updated_at                              datetime            ソースのフィールド `updatedAt`。
```

### `tags`

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

```columns table=helpscout.tags
id                                      integer pk          ソースのフィールド `id`。
name                                    string              ソースのフィールド `name`。
color                                   string              ソースのフィールド `color`。
```

### `workflows`

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

```columns table=helpscout.workflows
id                                      integer pk          ソースのフィールド `id`。
name                                    string              ソースのフィールド `name`。
type                                    string              ソースのフィールド `type`。
status                                  string              ソースのフィールド `status`。
created_at                              datetime            ソースのフィールド `createdAt`。
modified_at                             datetime            ソースのフィールド `modifiedAt`。
```

## 削除と履歴

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